Tutorial: Create a lab plan with Azure Lab Services

In Azure Lab Services, the lab plan serves as a collection of configurations and settings that apply to the labs you create from it. In your lab plan, give permission to others to create labs, and set policies that apply to newly created labs. In this tutorial, learn how to create a lab plan by using the Azure portal.

In this tutorial, you do the following actions:

  • Create a lab plan
  • Assign a user to the Lab Creator role

Prerequisites

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

Create a lab plan

The following steps illustrate how to use the Azure portal to create a lab plan with Azure Lab Services.

  1. Sign in to the Azure portal.

  2. Select Create a resource in the upper left-hand corner of the Azure portal.

    Screenshot that shows the Azure portal home page, highlighting the Create a resource button.

  3. Search for lab plan. (Lab plan can also be found under the DevOps category.)

  4. On the Lab plan tile, select the Create dropdown and choose Lab plan.

    Screenshot of how to search for and create a lab plan by using the Azure Marketplace.

  5. On the Basics tab of the Create a lab plan page, provide the following information:

    Field Description
    Subscription Select the Azure subscription that you want to use to create the lab plan.
    Resource group Select an existing resource group or select Create new, and enter a name for the new resource group.
    Name Enter a unique lab plan name.
    For more information about naming restrictions, see Microsoft.LabServices resource name rules.
    Region Select a geographic location to host your lab plan.
  6. After you're finished configuring the resource, select Review + Create.

    Screenshot that shows the Basics tab to create a new lab plan in the Azure portal.

  7. Review all the configuration settings and select Create to start the deployment of the Lab Plan.

  8. To view the new resource, select Go to resource.

    Screenshot that shows the resource deployment completion page in the Azure portal.

  9. Confirm that you see the lab plan Overview page.

    Screenshot that shows the lab plan overview page in the Azure portal.

You've now successfully created a lab plan by using the Azure portal. To let others create labs in the lab plan, you assign them the Lab Creator role.

Add a user to the Lab Creator role

To create or edit a lab in the Lab Services web portal (https://labs.azure.com), the educator must be assigned the Lab Creator role. If you assign the Lab Creator role on the lab plan's resource group, the user can create labs for all lab plans in that resource group.

Note

Owners of a lab plan can automatically create labs and do not need to be assigned the Lab Creator role.

  1. On the Overview page for the lab plan, select Add lab creators.

    Screenshot that shows the **Overview** page of the lab plan.

  2. From the Access control (IAM) page, select Add > Add role assignment.

    Screenshot that shows the Access control (I A M) page with Add role assignment menu option highlighted.

  3. On the Role tab, select the Lab Creator role.

    Screenshot that shows the Add roll assignment page with Role tab selected.

  4. On the Members tab, select the user you want to add to the Lab Creators role.

  5. On the Review + assign tab, select Review + assign to assign the role.

Warning

Educators are given Owner permissions of labs they create. If the educator is assigned the Lab Creator role on the lab plan instead of the resource group, they may notice a short delay in accessing their newly created lab as the Owner permissions for the lab propagate. To avoid this issue, assign a role that allows the educator to view labs (like Lab Creator) on the lab plan's resource group.

Troubleshooting

Lab creation fails with You are not authorized to access this resource

When you create a new lab plan, it might take a few minutes for the permissions to propagate to the lab level. You can assign the Lab Creator role at the resource group level to prevent this behavior:

  1. In the Azure portal, go to the resource group that contains the lab plan.
  2. Select Access control (IAM) from the left navigation.
  3. Select Add > Add role assignment.
  4. Assign the Lab Creator role to the user account.

Next steps

In this tutorial, you created a lab plan and assigned lab creation permissions to another user. To learn about how to create a lab, advance to the next tutorial: