|
1 | 1 | ---
|
2 |
| -title: Set up a lab account with Azure Lab Services | Microsoft Docs |
3 |
| -description: Learn how to set up a lab account and add users that can create labs in the lab account. |
| 2 | +title: 'Tutorial: Set up a lab account with Azure Lab Services' |
| 3 | +titleSuffix: Azure Lab Services |
| 4 | +description: Learn how to set up a lab account with Azure Lab Servics in the Azure portal. Then, grant a user access to create labs. |
4 | 5 | ms.topic: tutorial
|
5 |
| -ms.date: 01/06/2022 |
| 6 | +services: lab-services |
| 7 | +ms.service: lab-services |
| 8 | +author: ntrogh |
| 9 | +ms.author: nicktrog |
| 10 | +ms.date: 03/03/2023 |
6 | 11 | ms.custom: subject-rbac-steps
|
7 | 12 | ---
|
8 | 13 |
|
9 | 14 | # Tutorial: Set up a lab account with Azure Lab Services
|
10 | 15 |
|
11 | 16 | [!INCLUDE [preview note](./includes/lab-services-new-update-note.md)]
|
12 | 17 |
|
13 |
| -In Azure Lab Services, a lab account serves as the central account in which your organization's labs are managed. In your lab account, give permission to others to create labs, and set policies that apply to all labs under the lab account. In this tutorial, learn how to create a lab account. |
| 18 | +In Azure Lab Services, a lab account serves as the central resource in which you manage your organization's labs. In your lab account, give permission to others to create labs, and set policies that apply to all labs under the lab account. In this tutorial, learn how to create a lab account by using the Azure portal. |
14 | 19 |
|
15 | 20 | In this tutorial, you do the following actions:
|
16 | 21 |
|
17 | 22 | > [!div class="checklist"]
|
18 | 23 | > - Create a lab account
|
19 | 24 | > - Add a user to the Lab Creator role
|
20 | 25 |
|
21 |
| -If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin. |
| 26 | + |
| 27 | +## Prerequisites |
| 28 | + |
| 29 | +* An Azure account with an active subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin. |
22 | 30 |
|
23 | 31 | ## Create a lab account
|
24 | 32 |
|
25 | 33 | The following steps illustrate how to use the Azure portal to create a lab account with Azure Lab Services.
|
26 | 34 |
|
27 | 35 | 1. Sign in to the [Azure portal](https://portal.azure.com).
|
28 |
| -2. Select **All Services** on the left menu. Select **DevOps** from **Categories**. Then, select **Lab Services**. If you select star (`*`) next to **Lab Services**, it's added to the **FAVORITES** section on the left menu. From the next time onwards, you select **Lab Services** under **FAVORITES**. |
29 | 36 |
|
30 |
| -  |
31 |
| -3. On the **Lab Services** page, select **Add** on the toolbar or select **Create lab account** button on the page. |
| 37 | +1. Select **Create a resource** in the upper left-hand corner of the Azure portal. |
| 38 | + |
| 39 | + :::image type="content" source="./media/tutorial-setup-lab-account/azure-portal-create-resource.png" alt-text="Screenshot that shows the Azure portal home page, highlighting the Create a resource button."::: |
| 40 | + |
| 41 | +1. Search for **lab account**. (**Lab account** can also be found under the **DevOps** category.) |
| 42 | + |
| 43 | +1. On the **Lab account** tile, select **Create** > **Lab account**. |
| 44 | + |
| 45 | + :::image type="content" source="./media/tutorial-setup-lab-plan/select-lab-plans-service.png" alt-text="Screenshot of how to search for and create a lab account by using the Azure Marketplace."::: |
32 | 46 |
|
33 |
| -  |
34 |
| -4. On the **Basics** tab of the **Create a lab account** page, do the following actions: |
35 |
| - 1. For **Lab account name**, enter a name. |
36 |
| - 2. Select the **Azure subscription** in which you want to create the lab account. |
37 |
| - 3. For **Resource group**, select an existing resource group or select **Create new**, and enter a name for the resource group. |
38 |
| - 4. For **Location**, select a location/region in which you want to create the lab account. |
| 47 | +1. On the **Basics** tab of the **Create a lab account** page, provide the following information: |
39 | 48 |
|
40 |
| -  |
41 |
| - 5. Select **Review + create**. |
42 |
| - 6. Review the summary, and select **Create**. |
| 49 | + | Field | Description | |
| 50 | + | ------------ | -------------------------- | |
| 51 | + | **Subscription** | Select the Azure subscription that you want to use to create the resource. | |
| 52 | + | **Resource group** | Select an existing resource group or select **Create new**, and enter a name for the new resource group. | |
| 53 | + | **Name** | Enter a unique lab account name. <br/>For more information about naming restrictions, see [Microsoft.LabServices resource name rules](../azure-resource-manager/management/resource-name-rules.md#microsoftlabservices). | |
| 54 | + | **Region** | Select a geographic location to host your lab account. | |
43 | 55 |
|
44 |
| -  |
45 |
| -5. When the deployment is complete, expand **Next steps**, and select **Go to resource**. |
| 56 | +1. After you're finished configuring the resource, select **Review + Create**. |
46 | 57 |
|
47 |
| -  |
48 |
| -6. Confirm that you see the **Lab Account** page. |
| 58 | + :::image type="content" source="./media/tutorial-setup-lab-account/lab-account-basics-page.png" alt-text="Screenshot that shows the Basics tab to create a new lab account in the Azure portal."::: |
49 | 59 |
|
50 |
| -  |
| 60 | +1. Review all the configuration settings and select **Create** to start the deployment of the lab account. |
| 61 | + |
| 62 | +1. To view the new resource, select **Go to resource**. |
| 63 | + |
| 64 | + :::image type="content" source="./media/tutorial-setup-lab-account/go-to-lab-account.png" alt-text="Screenshot that shows the resource deployment completion page in the Azure portal."::: |
| 65 | + |
| 66 | +1. Confirm that you see the lab account **Overview** page. |
| 67 | + |
| 68 | + :::image type="content" source="./media/tutorial-setup-lab-account/lab-account-page.png" alt-text="Screenshot that shows the lab account overview page in the Azure portal."::: |
| 69 | + |
| 70 | +You've now successfully created a lab account by using the Azure portal. To let others create labs in the lab account, you assign them the Lab Creator role. |
51 | 71 |
|
52 | 72 | ## Add a user to the Lab Creator role
|
53 | 73 |
|
54 |
| -To set up a lab in a lab account, the user must be a member of the **Lab Creator** role in the lab account. To provide educators the permission to create labs for their classes, add them to the **Lab Creator** role: For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md). |
| 74 | +To set up a lab in a lab account, you must be a member of the Lab Creator role in the lab account. To grant people the permission to create labs, add them to the Lab Creator role. |
| 75 | + |
| 76 | +Follow these steps to [assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.md). |
55 | 77 |
|
56 | 78 | > [!NOTE]
|
57 |
| -> The account you used to create the lab account is automatically added to this role. If you are planning to use the same user account to create a lab in this tutorial, skip this step. |
| 79 | +> Azure Lab Services automatically assign the Lab Creator role to the Azure account you use to create the lab account. If you plan to use the same user account to create a lab in this tutorial, skip this step. |
58 | 80 |
|
59 |
| -1. On the **Lab Account** page, select **Access control (IAM)** |
| 81 | +1. On the **Lab Account** page, select **Access control (IAM)**. |
60 | 82 |
|
61 |
| -1. Select **Add** > **Add role assignment**. |
| 83 | +1. From the **Access control (IAM)** page, select **Add** > **Add role assignment**. |
62 | 84 |
|
63 |
| -  |
| 85 | + :::image type="content" source="../../includes/role-based-access-control/media/add-role-assignment-menu-generic.png" alt-text="Screenshot that shows the Access control (I A M) page with Add role assignment menu option highlighted."::: |
64 | 86 |
|
65 | 87 | 1. On the **Role** tab, select the **Lab Creator** role.
|
66 | 88 |
|
67 |
| -  |
| 89 | + :::image type="content" source="../../includes/role-based-access-control/media/add-role-assignment-role-generic.png" alt-text="Screenshot that shows the Add roll assignment page with Role tab selected."::: |
68 | 90 |
|
69 |
| -1. On the **Members** tab, select the user you want to add to the Lab Creators role |
| 91 | +1. On the **Members** tab, select the user you want to add to the Lab Creators role. |
70 | 92 |
|
71 | 93 | 1. On the **Review + assign** tab, select **Review + assign** to assign the role.
|
72 | 94 |
|
73 | 95 | ## Next steps
|
74 | 96 |
|
75 |
| -In this tutorial, you created a lab account. To learn about how to create a lab as an educator, advance to the next tutorial: |
| 97 | +In this tutorial, you created a lab account and granted lab creation permissions to another user. To learn about how to create a lab, advance to the next tutorial: |
76 | 98 |
|
77 | 99 | > [!div class="nextstepaction"]
|
78 | 100 | > [Set up a lab](tutorial-setup-lab.md)
|
0 commit comments