diff --git a/README.md b/README.md index 67303495..5a658da8 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,8 @@ [![Korean](https://img.shields.io/badge/-Korean-white)](translations/README.ko.md) [![Japanese](https://img.shields.io/badge/-Japanese-red)](translations/README.ja.md) +[![](https://dcbadge.vercel.app/api/server/ByRwuEEgH4)](https://discord.gg/zxKYvhSnVp?WT.mc_id=academic-000002-leestott) + # IoT for Beginners - A Curriculum Azure Cloud Advocates at Microsoft are pleased to offer a 12-week, 24-lesson curriculum all about IoT basics. Each lesson includes pre- and post-lesson quizzes, written instructions to complete the lesson, a solution, an assignment and more. Our project-based pedagogy allows you to learn while building, a proven way for new skills to 'stick'. @@ -76,7 +78,7 @@ We have two choices of IoT hardware to use for the projects depending on persona - assignment - post-lesson quiz -> **A note about quizzes**: All quizzes are contained [in this app](https://black-meadow-040d15503.1.azurestaticapps.net), for 48 total quizzes of three questions each. They are linked from within the lessons but the quiz app can be run locally; follow the instruction in the `quiz-app` folder. They are gradually being localized. +> **A note about quizzes**: All quizzes are contained in the quiz-app folder, for 48 total quizzes of three questions each. They are linked from within the lessons but the quiz app can be run locally or deployed to Azure; follow the instruction in the `quiz-app` folder. They are gradually being localized. ## Lessons @@ -132,14 +134,20 @@ Would you like to contribute a translation? Please read our [translation guideli Our team produces other curricula! Check out: +- [Generative AI for Beginners](https://aka.ms/genai-beginners) +- [Generative AI for Beginners .NET](https://github.com/microsoft/Generative-AI-for-beginners-dotnet) +- [Generative AI with JavaScript](https://github.com/microsoft/generative-ai-with-javascript) +- [Generative AI with Java](https://github.com/microsoft/Generative-AI-for-beginners-java) - [AI for Beginners](https://aka.ms/ai-beginners) - [Data Science for Beginners](https://aka.ms/datascience-beginners) -- [Generative AI for Beginners](https://aka.ms/genai-beginners) -- [Web Dev for Beginners](https://aka.ms/webdev-beginners?WT.mc_id=academic-113596-abartolo) +- [ML for Beginners](https://aka.ms/ml-beginners) +- [Cybersecurity for Beginners](https://github.com/microsoft/Security-101) +- [Web Dev for Beginners](https://aka.ms/webdev-beginners) - [IoT for Beginners](https://aka.ms/iot-beginners) -- [Machine Learning for Beginners](https://aka.ms/ml-beginners) -- [XR Development for Beginners](https://aka.ms/xr-dev-for-beginners) -- [Mastering GitHub Copilot for AI Paired Programming](https://aka.ms/GitHubCopilotAI) +- [XR Development for Beginners](https://github.com/microsoft/xr-development-for-beginners) +- [Mastering GitHub Copilot for Agentic use](https://github.com/microsoft/Mastering-GitHub-Copilot-for-Paired-Programming) +- [Mastering GitHub Copilot for C#/.NET Developers](https://github.com/microsoft/mastering-github-copilot-for-dotnet-csharp-developers) +- [Choose Your Own Copilot Adventure](https://github.com/microsoft/CopilotAdventures) ## Image attributions diff --git a/quiz-app/README.md b/quiz-app/README.md index 9dca01d0..08251d59 100644 --- a/quiz-app/README.md +++ b/quiz-app/README.md @@ -31,3 +31,83 @@ npm run lint See [Configuration Reference](https://cli.vuejs.org/config/). Credits: Thanks to the original version of this quiz app: https://github.com/arpan45/simple-quiz-vue + + +## Deploying to Azure + +Here’s a step-by-step guide to help you get started: + +1. Fork the a GitHub Repository +Ensure your static web app code is in your GitHub repository. Fork this repository. + +2. Create an Azure Static Web App +- Create and [Azure account](http://azure.microsoft.com) +- Go to the [Azure portal](https://portal.azure.com) +- Click on “Create a resource” and search for “Static Web App”. +- Click “Create”. + +3. Configure the Static Web App +- Basics: Subscription: Select your Azure subscription. +- Resource Group: Create a new resource group or use an existing one. +- Name: Provide a name for your static web app. +- Region: Choose the region closest to your users. + +- #### Deployment Details: +- Source: Select “GitHub”. +- GitHub Account: Authorize Azure to access your GitHub account. +- Organization: Select your GitHub organization. +- Repository: Choose the repository containing your static web app. +- Branch: Select the branch you want to deploy from. + +- #### Build Details: +- Build Presets: Choose the framework your app is built with (e.g., React, Angular, Vue, etc.). +- App Location: Specify the folder containing your app code (e.g., / if it’s in the root). +- API Location: If you have an API, specify its location (optional). +- Output Location: Specify the folder where the build output is generated (e.g., build or dist). + +4. Review and Create +Review your settings and click “Create”. Azure will set up the necessary resources and create a GitHub Actions workflow in your repository. + +5. GitHub Actions Workflow +Azure will automatically create a GitHub Actions workflow file in your repository (.github/workflows/azure-static-web-apps-.yml). This workflow will handle the build and deployment process. + +6. Monitor the Deployment +Go to the “Actions” tab in your GitHub repository. +You should see a workflow running. This workflow will build and deploy your static web app to Azure. +Once the workflow completes, your app will be live on the provided Azure URL. + +### Example Workflow File + +Here’s an example of what the GitHub Actions workflow file might look like: +name: Azure Static Web Apps CI/CD +``` +on: + push: + branches: + - main + pull_request: + types: [opened, synchronize, reopened, closed] + branches: + - main + +jobs: + build_and_deploy_job: + runs-on: ubuntu-latest + name: Build and Deploy Job + steps: + - uses: actions/checkout@v2 + - name: Build And Deploy + id: builddeploy + uses: Azure/static-web-apps-deploy@v1 + with: + azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }} + repo_token: ${{ secrets.GITHUB_TOKEN }} + action: "upload" + app_location: "quiz-app" #App source code path + api_location: ""API source code path optional + output_location: "dist" #Built app content directory - optional +``` + +### Additional Resources +- [Azure Static Web Apps Documentation](https://learn.microsoft.com/azure/static-web-apps/getting-started) +- [GitHub Actions Documentation](https://docs.github.com/actions/use-cases-and-examples/deploying/deploying-to-azure-static-web-app) \ No newline at end of file