Initial commit

JeffKoMS · web-flow · commit de1bc7e5e046 · 2025-04-16T10:24:27.000-07:00
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
@@ -0,0 +1,21 @@
+# Contributing to Microsoft Learning Repositories
+
+MCT contributions are a key part of keeping the lab and demo content current as the Azure platform changes. We want to make it as easy as possible for you to contribute changes to the lab files. Here are a few guidelines to keep in mind as you contribute changes.
+
+## GitHub Use & Purpose
+
+Microsoft Learning is using GitHub to publish the lab steps and lab scripts for courses that cover cloud services like Azure. Using GitHub allows the course’s authors and MCTs to keep the lab content current with Azure platform changes. Using GitHub allows the MCTs to provide feedback and suggestions for lab changes, and then the course authors can update lab steps and scripts quickly and relatively easily.
+
+> When you prepare to teach these courses, you should ensure that you are using the latest lab steps and scripts by downloading the appropriate files from GitHub. GitHub should not be used to discuss technical content in the course, or how to prep. It should only be used to address changes in the labs.
+
+It is strongly recommended that MCTs and Partners access these materials and in turn, provide them separately to students.  Pointing students directly to GitHub to access Lab steps as part of an ongoing class will require them to access yet another UI as part of the course, contributing to a confusing experience for the student. An explanation to the student regarding why they are receiving separate Lab instructions can highlight the nature of an always-changing cloud-based interface and platform. Microsoft Learning support for accessing files on GitHub and support for navigation of the GitHub site is limited to MCTs teaching this course only.
+
+> As an alternative to pointing students directly to the GitHub repository, you can point students to the GitHub Pages website to view the lab instructions. The URL for the GitHub Pages website can be found at the top of the repository.
+
+To address general comments about the course and demos, or how to prepare for a course delivery, please use the existing MCT forums.
+
+## Additional Resources
+
+A user guide has been provided for MCTs who are new to GitHub. It provides steps for connecting to GitHub, downloading and printing course materials, updating the scripts that students use in labs, and explaining how you can help ensure that this course’s content remains current.
+
+<https://microsoftlearning.github.io/MCT-User-Guide/>
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,12 @@
+# Module: 00
+## Lab/Demo: 00
+### Task: 00
+#### Step: 00
+
+Description of issue
+
+Repro steps:
+
+1.
+1.
+1.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,10 @@
+# Module: 00
+## Lab/Demo: 00
+
+Fixes # .
+
+Changes proposed in this pull request:
+
+-
+-
+-
diff --git a/Allfiles/read-me.md b/Allfiles/read-me.md
@@ -0,0 +1,13 @@
+Add any files that the learner needs to download in order t complete the exercises.
+These may include:
+- Code starter files
+- Data files
+- Scripts to setup a "starting point" for an exercises
+
+If appropriate, organize the files into folders that correspond to the exercises (e.g. 01, 02, etc.)
+
+In the lab instructions, include the steps that the learner needs to follow to get the files into their lab environment. Typically, this is accomplished by:
+- Instructing the learner to clone this repo (assumes they have Git installed and are sufficiently skilled to use it).
+- Providing hyperlinks to individual RAW files in this repo.
+
+Delete this file after you've added your assets to the repo.
diff --git a/Instructions/Labs/01-exercise-template.md b/Instructions/Labs/01-exercise-template.md
@@ -0,0 +1,94 @@
+---
+lab:
+    title: 'Exercise Title'
+---
+<!--
+Edit the metadata above to manage the list of exercises in the home page of the GitHub site that gets generated.
+You can delete the module and edit index.md in the root of the repo to customize the display so that only the exercises are listed
+To enable GitHub page publishing, edit the Page settings for the repo and publish from the main branch
+-->
+
+# Exercise title <!-- match title in metadata above (and Learn Exercise unit and ILT slide)-->
+
+In this exercise you will <!-- provide a description of what they'll do and why it;s important -->
+
+This exercise should take approximately **XX** minutes to complete. <!-- update with estimated duration -->
+
+## Before you start
+
+<!--
+Add steps to get the learner to the starting point" for the exercise.
+This might be cloning the repo and running a script or performing some manual steps.
+Only include this section if its necessary to do some pre-exercise setup AND the same setup steps are required for self-paced (on Learn) and managed (in hosted ILT lab profiles) scenarios. Otherwise delete this section.
+If self-paced /ILT-specific setup steps are required, include them in the Learn "Exercise" unit from where they open this exercise and in the Skillable lab profile instructions before this markdown file is imported.
+ -->
+
+Before you can start this exercise, you will need to...
+
+1. Step 1
+1. Step 2
+1. etc.
+
+## Task <!-- Change to an appropriate task title with an imperative verb phrase (e.g. "Do something") -->
+
+First, you need to ...
+
+1. Step 1
+1. This step includes an example of `inline code formatting`, which is used when the learner needs to type something (anything, not just code) because it creates a [T] link in the hosted Skillable environment.
+1. If you need the learner to open a website, include both a link (so they can open by clicking in the HTML GitHub page) AND the URL formatted as code (so they can type it in a hosted VM browser). For example, "Open the [Bing](https://www.bing.com) website at `https://www.bing.com`".
+1. If you need the learner to download a file (or a bunch of files in a zip), store the file in Allfiles folder in this repo and use the **raw** URL - like this: "Download [file name](https://raw.githubusercontent.com/MicrosoftLearning/INF99X-SampleCourse/master/Allfiles/Labs/01/Starter/azuredeploy.json) from `https://raw.githubusercontent.com/MicrosoftLearning/INF99X-SampleCourse/master/Allfiles/Labs/01/Starter/azuredeploy.json`.
+1. Alternatively, for a developer audience, you can have them clone this repo if that seems more appropriate.
+1. If you need to include a multiline code block, indent it to match the bulleted list indent:
+
+    ```python
+    # This is an example of an
+    # indented code block.
+    ```
+
+1. If you need to include a acreenshot, resize it to an appropriate size (so any "normal" formatted text in a partial screenshot is roughly the same size as this text - generally try to make screenshots of full application windows 800x600px (approx)). Store images in a **Media** subfolder and use markdown to add it to the page (remembering that file and folder names are case-sensitive). If the image is in a list, indent it, like this:
+
+    ![A screenshot of an application.](./Media/edge-copilot.png) 
+
+1. If you need to explain why something is done the way it is, or provide additional context or links to info, use a note like this:
+
+    > **Note**: This is a note.
+
+1. Be flexible when providing instructions that might vary between self-paced and hosted lab environments. For example:
+    - "Sign in using your Azure credentials" (assuming there were Learn-specific instructions to use a personal subscription or create a trial in the Learn exercise page, and ILT-specific instructions to use provided cloudslice credentials in the Skillable lab profile)
+    - "Select an existing resource group or create a new one" (assuming that if a Skillable CS-R cloudslice is used, you included a note in the lab profile telling the learner which resource group they should use)
+    <!-- The key point is that this markdown file should be environment-agnostic - you need to provide explicit details of things that can vary OUTSIDE of this file (in the Learn exercise page or the Skillable lab profile instructions) -->
+1. etc.
+
+## Next task
+
+Now let's, ...
+
+1. Step 1
+1. Step 2
+1. etc.
+
+## Task with subtasks
+
+Sometimes you might want to break a taak down into smaller chunks.
+
+### Subtask 1
+
+1. Step 1
+1. Step 2
+1. Etc.
+
+### Subtask 2
+
+1. Step 1
+1. Step 2
+1. etc.
+
+## Clean up
+
+<!-- Good practice - especially as self-paced learners will be using their own subscriptions -->
+<!-- Delete this section if it is not needed -->
+
+Now that you've finished the exercise, you should delete the cloud resources you've created to avoid unnecessary resource usage.
+
+1. Step 1
+2. etc.
diff --git a/Instructions/Labs/Media/edge-copilot.png b/Instructions/Labs/Media/edge-copilot.png
diff --git a/Instructions/Labs/Media/launch-exercise.png b/Instructions/Labs/Media/launch-exercise.png
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Microsoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/_build.yml b/_build.yml
@@ -0,0 +1,36 @@
+name: '$(Date:yyyyMMdd)$(Rev:.rr)'
+jobs:
+  - job: build_markdown_content
+    displayName: 'Build Markdown Content'
+    workspace:
+      clean: all
+    pool:
+      vmImage: 'ubuntu-latest'
+    container:
+      image: 'microsoftlearning/markdown-build:latest'
+    steps:
+      - task: Bash@3
+        displayName: 'Build Content'
+        inputs:
+          targetType: inline
+          script: |
+            cp /{attribution.md,template.docx,package.json,package.js} .
+            npm install
+            node package.js --version $(Build.BuildNumber)
+      - task: GitHubRelease@0
+        displayName: 'Create GitHub Release'
+        inputs:
+          gitHubConnection: 'github-microsoftlearning-organization'
+          repositoryName: '$(Build.Repository.Name)'
+          tagSource: manual
+          tag: 'v$(Build.BuildNumber)'
+          title: 'Version $(Build.BuildNumber)'
+          releaseNotesSource: input
+          releaseNotes: '# Version $(Build.BuildNumber) Release'
+          assets: '$(Build.SourcesDirectory)/out/*.zip'
+          assetUploadMode: replace
+      - task: PublishBuildArtifacts@1
+        displayName: 'Publish Output Files'
+        inputs:
+          pathtoPublish: '$(Build.SourcesDirectory)/out/'
+          artifactName: 'Lab Files'
diff --git a/_config.yml b/_config.yml
@@ -0,0 +1,17 @@
+remote_theme: MicrosoftLearning/Jekyll-Theme
+exclude:
+  - readme.md
+  - .github/
+header_pages:
+  - index.html
+author: Microsoft Learning
+twitter_username: mslearning
+github_username:  MicrosoftLearning
+plugins:
+  - jekyll-sitemap
+  - jekyll-mentions
+  - jemoji
+markdown: kramdown
+kramdown:
+   syntax_highlighter_opts:
+      disable : true
diff --git a/index.md b/index.md
@@ -0,0 +1,24 @@
+---
+title: Exercise Instructions
+permalink: index.html
+layout: home
+---
+
+# Exercises
+
+This page lists exercises associated with Microsoft skilling content on [Microsoft Learn](https://learn.microsoft.com)
+
+<!-- You can edit the paragraph above to provide a more specific description and links to content on Learn.
+
+Include the following note if an Azure subscription is required (or add something similar for any other requirements, such as a Microsoft 365 account).
+
+> **Note**: To complete these exercises, you will need a [Microsoft Azure subscription](https://azure.microsoft.com/free) in which you have sufficient permissions to create and configure the required resources.
+
+If a more complex setup is required, create a separate markdown file with setup instructions at \Instructions\Labs\00-setup.md - being sure to include "lab.title"" metadata at the top so it shows up the list below
+-->
+
+{% assign labs = site.pages | where_exp:"page", "page.url contains '/Instructions/Labs'" %}
+{% for activity in labs  %}
+- [{{ activity.lab.title }}]({{ site.github.url }}{{ activity.url }})
+{% endfor %}
+
diff --git a/readme.md b/readme.md
@@ -0,0 +1,14 @@
+# Microsoft Lab Exercises
+<!-- Change the title above as appropriate -->
+
+This repo contains exercises and supporting files for Microsoft skilling content.
+
+The exercises may be used in both self-paced skilling experiences on [Microsoft Learn](https://learn.microsoft.com) and in Microsoft authorized instructor-led training.
+<!-- Update thr paragraph above with a link to a specific Learning Path or course as appropriate -->
+
+## Information for MCTs
+<!-- You can remove this section if the exercises will not be used to support Microsoft Official Curriculum ILT -->
+
+**Are you an MCT?** - Have a look at our [GitHub User Guide for MCTs](https://microsoftlearning.github.io/MCT-User-Guide/)
+
+Any MCT (Microsoft Certified Trainer) can submit a pull request to the code or content in the GitHub repro. Microsoft and the course author will then triage and include content and lab code changes as needed. You can submit bugs, changes, improvement, and ideas. Find a new Azure or Microsoft 365 feature before we have? Submit a new demo!
