Tutorial: Create a lab with the Azure Lab Services app in Teams or Canvas

With Azure Lab Services, you can create labs directly from within Microsoft Teams or Canvas. In this tutorial, you use the Azure Lab Services app for Microsoft Teams or Canvas to create and publish a lab. After you complete this tutorial, lab users can directly access their lab virtual machine from Teams or Canvas.

With the Azure Lab Services app for Teams or Canvas you can create and manage labs without having to leave the Teams or Canvas environment and lab user management is synchronized based team or course membership. Lab users are automatically registered for a lab and have a lab VM assigned to them. They can also access their lab VM directly from within Teams or Canvas.

In this tutorial, you learn how to:

Prerequisites

• An Azure account with an active subscription. If you don't have an Azure subscription, create a free account before you begin.

• An Azure account with permission to manage a lab, such as the Lab Creator, Owner, Contributor, or Lab Services Contributor Azure RBAC role. Learn more about the Azure Lab Services built-in roles and assignment scopes.

• An Azure lab plan. If you don't have a lab plan yet, follow the steps in Quickstart: Set up resources to create labs.

Configure the Azure Lab Services app

Access the Azure Lab Services app

Create a new lab

A lab contains the configuration and settings for creating lab VMs. All lab VMs within a lab are identical. You use the Azure Lab Services app to create a lab in the lab plan.

1. Select Create lab to start creating a new lab.

2. On the New Lab page, enter the following information, and then select Next:

   Field	Description
   Name	Enter programming-101.
   Virtual machine image	Select Windows Server 2022 Datacenter.
   Virtual machine size	Select Small.
   Location	Leave the default value.

   Some virtual machine sizes might not be available depending on the lab plan region and your subscription core limit. Learn more about virtual machine sizes in the administrator's guide and how to request additional capacity.

   You can enable or disable specific virtual machine images by configuring the lab plan.

3. On the Virtual machine credentials page, specify a default username and password, and then select Next.

   By default, all the lab VMs use the same credentials.

   Important

   Make a note of username and password. They won't be shown again.

4. On the Lab policies page, leave the default values and select Next.

   The default settings enable secure shell (SSH) access to the lab virtual machine, provide users with 10 quota hours, and shuts down the lab VMs when there's no activity.

5. On the Template virtual machine settings page, select Use virtual machine image without customization.

   In this tutorial, you use the VM image as-is, known as a templateless VM. Azure Lab Services also supports creating a template VM, which lets you make configuration changes or install software on top of the VM image.

   

6. Select Finish to start the lab creation. It might take several minutes for the lab creation to finish.

7. When the lab creation finishes, you can see the lab details in the Template page.

   

Publish the lab

Azure Lab Services doesn't create the lab virtual machines until you publish the lab. When you publish the lab, the lab virtual machines are created, and assigned to the individual lab users.

To publish the lab:

1. On the Template page, select Publish on the toolbar.

   

2. On the Publish page, select Publish to start publishing the lab.

   Warning

   Publishing is an irreversible action, and can't be undone.

3. Wait until the publishing process finishes. You can track the publishing status on the Template page.

4. On the Virtual machine pool page, confirm that there's a lab VM for each lab user. The lab VMs are in the Stopped state.

   When you create a lab in Teams or Canvas, Azure Lab Services automatically manages the lab user list based on the team or course membership. When you add or remove users in Teams or Canvas, Azure Lab Services automatically assigns or withdraws access to the lab.

   Azure Lab Services also automatically manages the lab capacity (the number of lab virtual machines) and assigns the lab virtual machines to lab users. You can view the lab virtual machines and their assignments in the Virtual machine pool page:

   

Troubleshooting

This section outlines common error messages that you might see, along with the steps to resolve them.

• Insufficient permissions to create lab.

  In Canvas, an educator will see a message indicating that they don't have sufficient permission. Educators should contact their Azure admin so they can be added as a Lab Creator. For example, educators can be added as a Lab Creator to the resource group that contains their lab.

• Message that there isn't enough capacity to create lab VMs.

  Request a limit increase which needs to be done by an Azure Labs Services administrator.

• Lab users see a warning that the lab isn't available yet.

  In Canvas, you'll see the following message if the educator hasn't published the lab yet. Educators must publish the lab and sync users for students to have access to a lab.

  

• Lab users or educators are prompted to grant access.

  Before a lab user or educator can first access their lab, some browsers require that they first grant Azure Lab Services access to the browser's local storage. To grant access, educators and students should select the Grant access button when they're prompted:

  

  Educators and students see the message Access granted when access is successfully granted to Azure Lab Services. The educator or student should then reload the browser window to start using Azure Lab Services.

  

  Important

  Ensure that students and educators are using an up-to-date version of their browser. For older browser versions, students and educators might experience issues with being able to successfully grant access to Azure Lab Services.

  • Educator isn't prompted for their credentials after they select sign-in.

  When an educator accesses Azure Lab Services within their course, they might be prompted to sign in. Ensure that the browser's settings allow popups from the url of your Canvas instance, otherwise the popup might be blocked by default.

  

Next steps

In this tutorial, you configured the Azure Lab Services app for Teams or Canvas and created and published a lab. Azure Lab Services automatically manages the lab users and assigns a lab virtual machine to each lab user. You can further configure the lab to add a lab schedule or modify the lab settings.

• Learn how you can access and connect to a lab virtual machine from within Teams or Canvas.