This guide explains how to move from lab accounts to the August update lab plan. We’ll identify which version of the service is being used, discuss some of the differences, and move a lab account to a lab plan.
How can you identify if you are using the August update of Lab Services?
The easiest way to identify if you are using the August update is in the Azure portal labs will be visible as resources.
How much of a change is the August 2022 update for educators and students?
While there are a lot of improvements, almost all these changes are not visible to the educator or student. The two version of lab services can live side by side; the educators will see both types of labs in the Labs.Azure.com portal. The students will see all their VMs in the same view, regardless of whether the lab is associated with a lab plan or lab account.
Can I move all my existing resources to the newer version?
Behind the scenes there are custom roles, which we’ll discuss later in the document.
The team worked hard to keep a consistent user experience for educators and students. There are significant updates to the service itself. You can learn more about these distinctions in the Azure Lab Services documentation.
Let’s walk through the recommended next steps for moving from an existing lab account to a lab plan.
In your existing lab account, some of the key items to identify are:
This is a noticeable change between lab accounts and lab plans. The resource group is more significant when creating labs. It identifies which lab plans are available as a template. In action, the lab creator will select the resource group name in the Labs.Azure.com portal, then when creating a lab select the lab plan in that resource group to be the template.
The easiest way to is to start creating a new lab plan in the resource group from above.
The first items are the name and the region when creating a lab plan. Lab accounts and lab plans are different types of Azure resources so you can use the same name on the lab plan as your existing lab account name. There is a Naming section in the Administrators guide, if you have questions.
The region you select is the default region that labs can be created in, you can add additional regions after creation.
If your existing lab account isn’t peered to an Azure Virtual Network skip to the next section. The networking information can be found under Lab Settings – Networking.
In the case where your existing lab account has been peered to a virtual network, lab plans use a different and more flexible connection commonly called “vnet injection”. Both a lab account and lab plan can be connected to the same virtual network as they use different connection types and IP ranges. In the case of a simple licensing server with a virtual network peered to an existing lab account, you can follow these steps to connect to a lab plan.
Depending on the configuration of the virtual network this may be more complex and require adjusting the virtual network. There are specific documents on how to use advanced networking.
At this point you can finish the lab plan creation; additional changes will need to be made once the lab plan has finished creating.
Enabling multiple regions is not required, if you don’t need or want multiple regions continue to the next section. Lab accounts used "geolocations" but Lab plan use Azure Regions.
If you need labs in different regions, you will need to explicitly enable those regions. This can be changed in the Lab Plan – Settings – Enabled Regions. Having multiple regions is not a requirement, you can request cores in a single region and have all the labs in that region. With lab accounts you would select “generalized” regions and the service would select Azure regions depending on need and availability. There isn’t a direct correlation between lab account regions and lab plan regions.
If the existing lab account does not have an Azure Compute gallery, continue to the next section.
The existing Azure Compute gallery (formerly Shared Image Gallery) can be attached to both a lab account and a lab plan simultaneously. This is in the Lab Plan – Azure Compute Gallery – Attach existing gallery. The images created using labs in the lab account can be used to create labs with a lab plan. There reverse is not true, Labs under a Lab Account cannot use the Lab Plan created mages as Lab Plan based labs support Generation 2 vms.
If the subscription, resource group, or lab account only has built-in roles add the appropriate roles to the same resource.
If there are custom roles created for the lab account, you will need to review them and determine if one of the new built-in roles can be used instead. If the built-in roles don’t meet your needs, existing roles can be updated to add Microsoft.LabServices/labplans and Microsoft.LabServices/labs actions. If you are unsure of which actions, it is recommended to clone a Lab Services role and adjusting as necessary.
With that the new lab plan will have the same functionality as the lab account and new labs can be created using it.
If there is any supporting code for managing or updating lab accounts, the code will need to be changed to support lab plans and the new model. For more details on the specific languages. Below are links to the different models and code.
There is a Lab Services repository with additional samples on managing August 2022 update labs.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.