Skip to content

Commit 49dbf50

Browse files
authored
Merge pull request #232781 from ntrogh/als-getting-started-review
[Azure Lab Services] Update getting started docs after PM review
2 parents 0dbd271 + dee890b commit 49dbf50

14 files changed

+90
-96
lines changed

articles/lab-services/classroom-labs-concepts.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ The following conceptual diagram shows how the different Azure Lab Services comp
2121

2222
In Azure Lab Services, a lab plan is an Azure resource and serves as a collection of configurations and settings that apply to all the labs created from it. For example, lab plans specify the networking setup, the list of available VM images and VM sizes, and if [Canvas integration](lab-services-within-canvas-overview.md) can be used for a lab. Learn more about [planning your lab plan settings](./lab-plan-setup-guide.md#plan-your-lab-plan-settings).
2323

24-
A lab plan can contain zero or more [labs](#lab). Each lab uses the configuration settings from the lab plan. Azure Lab Services uses Azure AD roles to grant permissions for creating labs. Learn more about [Azure Lab Services built-in roles](./administrator-guide.md#rbac-roles).
24+
You can associate a lab plan with zero or more [labs](#lab). Each lab uses the configuration settings from the lab plan. Azure Lab Services uses Azure RBAC roles to grant permissions for creating labs. Learn more about [Azure Lab Services built-in roles](./administrator-guide.md#rbac-roles).
2525

2626
## Lab
2727

@@ -31,7 +31,7 @@ You can further configure the lab behavior by creating [lab schedules](#schedule
3131

3232
When you publish a lab, Azure Lab Services provisions the lab VMs. All lab VMs for a lab share the same configuration and are identical.
3333

34-
To create labs in Azure Lab Services, your Azure account needs to have the Lab Creator Azure AD role, or you need to be the owner of the corresponding lab plan. Learn more about [Azure Lab Services built-in roles](./administrator-guide.md#rbac-roles).
34+
To create labs in Azure Lab Services, your Azure account needs to have the Lab Creator Azure RBAC role, or you need to be the owner of the corresponding lab plan. Learn more about [Azure Lab Services built-in roles](./administrator-guide.md#rbac-roles).
3535

3636
You use the Azure Lab Services website (https://labs.azure.com) to create labs for a lab plan. Alternately, you can also [configure Microsoft Teams integration](./how-to-configure-teams-for-lab-plans.md) or [Canvas integration](./how-to-configure-canvas-for-lab-plans.md) with Azure Lab Services to create labs directly in Microsoft Teams or Canvas.
3737

@@ -49,7 +49,7 @@ Learn how to [attach or detach an Azure compute gallery](./how-to-attach-detach-
4949

5050
## Template virtual machine
5151

52-
You can choose to create a customizable lab, which enables you to modify the base image for the [lab VMs](#lab-virtual-machine). For example, to install extra software components or modify operating system settings. In this case, Azure Lab Services creates a lab template VM, which you can connect to and customize.
52+
You can choose to create a customizable lab, which enables you to modify the base image for the [lab virtual machines](#lab-virtual-machine). In this case, Azure Lab Services creates a lab template VM, which you can connect to and customize. For example, you might install extra software components, such as Visual Studio, or configure the operating system to disable the web server process.
5353

5454
When you [publish the lab](./tutorial-setup-lab.md#publish-lab), Azure Lab Services creates the lab VMs, based on the template VM image. If you modify the template VM at a later stage, when you republish the template VM, all lab VMs are updated to match the new template. When you republish a template VM, Azure Lab Services reimages the lab VMs and removes all changes and data on the VM.
5555

articles/lab-services/classroom-labs-scenarios.md

Lines changed: 2 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.service: lab-services
77
author: ntrogh
88
ms.author: nicktrog
99
ms.topic: conceptual
10-
ms.date: 01/17/2023
10+
ms.date: 04/04/2023
1111
---
1212

1313
# Use labs for trainings
@@ -98,36 +98,7 @@ The following table shows the corresponding mapping of organization roles to Azu
9898
| Student | | Students don't need an Azure AD role. Educators [grant students access](./how-to-configure-student-usage.md) in the lab configuration or students are automatically granted access, for example when using [Teams](./how-to-manage-labs-within-teams.md#manage-lab-user-lists-in-teams) or [Canvas](./how-to-manage-labs-within-canvas.md#manage-lab-user-lists-in-canvas). |
9999
| Others | Lab Services Reader | Optionally, provide access to see all lab plans and labs without permission to modify. |
100100

101-
## Create the lab plan as a lab plan administrator
102-
103-
The first step in using Azure Lab Services is to create a lab plan in the Azure portal. After a lab plan administrator creates the lab plan, the admin adds the Lab Creator role to users who want to create labs, such as educators.
104-
105-
The lab creator can then create labs with virtual machines for students to do exercises for the course they're teaching. For details, see [Create and manage lab plan](how-to-manage-lab-plans.md).
106-
107-
## Create and manage labs
108-
109-
If you have the Lab Creator role for a lab plan, you can create one or more labs in the lab plan. You create and configure a template VM with all the required software for doing exercises in your course. You select a ready-made image from the available images for creating a lab and then optionally customize it by installing the software required for the lab. For details, see [Create and manage labs](how-to-manage-labs.md).
110-
111-
## Set up and publish a template VM
112-
113-
A template VM in a lab is a base virtual machine image from which all users’ VMs are created. Set up the template VM so that it's configured with exactly what you want to provide to the training attendees. You can provide a name and description of the template that the lab users see.
114-
115-
Then, you publish the template to make instances of the template VM available to your lab users. When you publish a template, Azure Lab Services creates VMs in the lab by using the template. The number of VMs created in this process is the same as the maximum number of users allowed into the lab, which you can set in the usage policy of the lab. All virtual machines have the same configuration as the template. For details, see [Set up and publish template virtual machines](how-to-create-manage-template.md).
116-
117-
## Configure usage settings and policies
118-
119-
The lab creator can add or remove users to the lab, get a registration link to invite lab users, set up policies such as setting individual quotas per user, update the number of VMs available in the lab, and more. For details, see [Configure usage settings and policies](how-to-configure-student-usage.md).
120-
121-
When you use Azure Lab Services with [Microsoft Teams](./how-to-manage-labs-within-teams.md) or [Canvas](./how-to-manage-labs-within-canvas.md), Azure Lab Services automatically synchronizes the lab user list with the membership in Teams or Canvas.
122-
123-
## Create and manage schedules
124-
125-
Schedules allow you to configure a lab such that VMs in the lab automatically start and shut down at a specified time. You can define a one-time schedule or a recurring schedule. For details, see [Create and manage schedules for labs](how-to-create-schedules.md).
126-
127-
## Use VMs in the lab
128-
129-
A student or training attendee registers to the lab by using the registration link they received from the lab creator. They can then connect to the VM to do the exercises for the course. For details, see [How to access a lab](how-to-use-lab.md).
130-
131101
## Next steps
132102

103+
- Learn more about [setting up example class types](./class-types.md).
133104
- Get started by following the steps in the tutorial [Set up a lab for classroom training](./tutorial-setup-lab.md).

articles/lab-services/includes/lab-services-add-lab-creator.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,16 @@
11
---
22
ms.service: lab-services
3-
ms.date: 01/17/2023
3+
ms.date: 04/04/2023
44
ms.topic: include
55
ms.service: lab-services
66
---
77

8-
To create or edit a lab in the Azure Lab Services website ([https://labs.azure.com](https://labs.azure.com)), your Azure account must be assigned the Lab Creator role in Azure AD. 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.
8+
To create or edit a lab in the Azure Lab Services website ([https://labs.azure.com](https://labs.azure.com)), your Azure account must be assigned the Lab Creator role in Azure RBAC. If you assign the Lab Creator role on the lab plan's resource group, the user can create labs for all lab plans in the resource group.
99

1010
> [!NOTE]
1111
> Owners of a lab plan can automatically create labs and do not need to be assigned the **Lab Creator** role.
1212
13-
1. On the **Overview** page for the lab plan, select **Add lab creators**.
14-
15-
:::image type="content" source="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators-focused.png" alt-text="Screenshot that shows the **Overview** page of the lab plan." lightbox="../media/lab-services-add-lab-creator/lab-plan-overview-add-lab-creators.png":::
13+
1. Select the resource group that contains the lab plan.
1614

1715
1. From the **Access control (IAM)** page, select **Add** > **Add role assignment**.
1816

articles/lab-services/includes/lab-services-labaccount-focused-article.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,6 @@ ms.custom: devdivchpfy22
1010
>
1111
> As part of the August 2022 update, **Azure Lab Services lab plans** replace lab accounts. For new customers, learn how you can get started by [creating a lab plan](../quick-create-resources.md). For existing lab account customers we recommend that you [transition from lab accounts to lab plans](../migrate-to-2022-update.md).
1212
>
13-
> Beginning **February 21st, 2023**, you won't be able to create a **Lab Account** to use the service. If you have a new subscription, you will instead be able to create a **Lab plan** to use the service.
13+
> As of **February 21st, 2023**, you're no longer able to create a **Lab Account** to use the service. If you have a new subscription, create a **Lab plan** instead to start using the service.
1414
>
1515
> If you already have a Lab account, you can continue to use it and if you need additional lab accounts, as an exception, you can submit an Azure support ticket.

articles/lab-services/includes/lab-services-new-update-note.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,6 @@ ms.custom: devdivchpfy22
1010
>
1111
> As part of the August 2022 update, **Azure Lab Services Lab Plans** replace lab accounts. For new customers, learn how you can get started by [creating a lab plan](../quick-create-resources.md). For existing lab account customers we recommend that you [transition from lab accounts to lab plans](../migrate-to-2022-update.md).
1212
>
13-
> Beginning **February 21st, 2023**, you won't be able to create a **Lab Account** to use the service. If you have a new subscription, you will instead be able to create a **Lab plan** to use the service.
13+
> As of **February 21st, 2023**, you're no longer able to create a **Lab Account** to use the service. If you have a new subscription, create a **Lab plan** instead to start using the service.
1414
>
1515
> If you already have a Lab account, you can continue to use it and if you need additional lab accounts, as an exception, you can submit an Azure support ticket.

0 commit comments

Comments
 (0)