You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/lab-services/classroom-labs/account-setup-guide.md
+41-53Lines changed: 41 additions & 53 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,105 +19,93 @@ ms.author: spelluru
19
19
20
20
# Lab account setup guide
21
21
22
-
The first step that needs to be completed by administrators is to set up a lab account within your Azure subscription. A lab account is a container for your classroom labs and only takes a few minutes to set up.
22
+
As a first step, administrators should set up a lab account within your Azure subscription. A lab account is a container for your classroom labs, and only takes a few minutes to set up.
23
23
24
24
## Understand your school's lab account requirements
25
25
26
-
To understand how to configure your lab account based on your school's needs, you should consider the following questions:
26
+
To understand how to configure your lab account based on your school's needs, you should consider these questions.
27
27
28
-
**Do I have access to an Azure subscription?**
28
+
### Do I have access to an Azure subscription?
29
29
30
-
To create a lab account, you will need access to an Azure subscription that is configured for your school; your school may have one or more subscriptions. A subscription is used to manage billing and security for all your Azure resources\services that are used within it, including lab accounts.
30
+
To create a lab account, you need access to an Azure subscription that is configured for your school. Your school might have one or more subscriptions. You use a subscription to manage billing and security for all your Azure resources and services, including lab accounts.
31
31
32
-
**How many lab accounts need to be created?**
32
+
### How many lab accounts need to be created?
33
33
34
-
To get started quickly, a reasonable approach is to create a single lab account and then later create additional Lab Accounts as needed. For example, you may eventually evolve to having one lab account per department.
34
+
To get started quickly, create a single lab account, and then later create additional lab accounts as needed. For example, you might eventually have one lab account per department.
35
35
36
-
**Who should be owners and contributors of the lab account?**
36
+
### Who should be owners and contributors of the lab account?
37
37
38
-
Your administrators are typically the owners\contributors for a lab account since they are responsible for managing the policies that apply to all the labs contained within the lab account. The person that creates the lab account is automatically an owner. You can add additional owners\contributors (typically from the AAD tenant associated with your subscription) to help manage a lab account by assigning either the Owner\Contributor role at the lab account level.
38
+
Your administrators are typically the owners and contributors for a lab account. They are responsible for managing the policies that apply to all the labs contained within the lab account. The person that creates the lab account is automatically an owner. You can add additional owners and contributors, typically from the Azure Active Directory (Azure AD) tenant associated with your subscription. This can be useful to help manage a lab account by assigning either the owner or contributor role at the lab account level.
39
39
40
-
**Who will be allowed to create\manage labs?**
40
+
### Who will be allowed to create and manage labs?
41
41
42
-
You may choose to have your administrators and\or faculty members create and manage labs; these users (typically from the AAD tenant associated with your subscription) are assigned to the Lab Creator role within the lab account.
42
+
You might choose to have your administrators and faculty members create and manage labs. These users (typically from the Azure AD tenant associated with your subscription) are assigned to the Lab Creator role within the lab account.
43
43
44
-
**Do you want to give lab creators the ability to save images that can be shared across labs?**
44
+
### Do you want to give lab creators the ability to save images that can be shared across labs?
45
45
46
-
A Shared Image Gallery is a repository that you can use for saving and sharing images. The benefit of this is that if you have several classes that need the same images, lab creators can create the image once and share it across labs. However, to get started, it's perfectly reasonable to start without a Shared Image Gallery; and, you can always choose to add one later.
46
+
A shared image gallery is a repository that you can use for saving and sharing images. If you have several classes that need the same images, lab creators can create the image once, and share it across labs. However, to get started, you don't necessarily need a shared image gallery, because you can always add one later.
47
47
48
-
If you answered 'Yes' to this question, then you will need to create and\or attach a Shared Image Gallery to your lab account. If you answered, 'I don't know', then you can postpone this decision until later.
48
+
If you answered "yes" to this question, you need to create or attach a shared image gallery to your lab account. If you answered "I don't know," you can postpone this decision until later.
49
49
50
-
When you have a Shared Image Gallery attached to your lab account
50
+
### Which images in Azure Marketplace will your classroom labs use?
51
51
52
-
**Which images in the Azure Marketplace will your classroom labs use?**
52
+
Azure Marketplace provides hundreds of images that you can enable so that lab creators can use the image for creating their lab. Some images might include everything that a lab already needs. In other cases, you might use an image as a starting point, and then the lab creator can customize it by installing additional applications or tools.
53
53
54
-
The Azure Marketplace provides hundreds of images that you can enable so that lab creators can use the image for creating their lab. Some images may include everything that a lab already needs. In other cases, you may use an image as a starting point and then the lab creator may customize it by installing additional applications, tools, etc.
55
-
56
-
If you don't know which images you will need to use, you can always come back to this later to enable them. Also, the best way to see which images are available is to first create a lab account – this will give you access so that you can review the list of available images and their contents. More information is provided below.
54
+
If you don't know which images you will need to use, you can always come back to this later to enable them. Also, the best way to see which images are available is to first create a lab account. This gives you access, so that you can review the list of available images and their contents.
57
55
58
-
**Do the lab's virtual machines (VMs) need to have access to other Azure or on-prem resources?**
56
+
### Do the lab's virtual machines need to have access to other Azure or on-premises resources?
59
57
60
-
When you set up a lab account, you also have the option to peer with a virtual network (VNet). To decide whether you need to peer with a VNet, consider the following questions:
58
+
When you set up a lab account, you also have the option to peer with a virtual network. To decide whether you need this, consider the following questions:
61
59
62
60
-**Do you need to provide access to a licensing server?**
63
61
64
-
If you plan to use Azure Marketplace images, the cost of the OS license is bundled into the pricing for Lab Services, so you do *not*need to provide licenses for the OS itself. However, for additional software\applications that are installed, you will need to provide a license as appropriate.
62
+
If you plan to use Azure Marketplace images, the cost of the operating system license is bundled into the pricing for lab services. Therefore, you don't need to provide licenses for the operating system itself. However, for additional software and applications that are installed, you do need to provide a license as appropriate.
65
63
66
-
-**Do the lab VMs need access to other on-prem resources, such as a file share, database, etc.?**
64
+
-**Do the lab VMs need access to other on-premises resources such as a file share or database?**
67
65
68
-
A VNet needs to be created to provide access to on-prem resources, typically using a site-to-site Virtual Network Gateway. If you don't have a VNet configured, additional time will need to be invested for this. More information on how to set this up is provided below.
66
+
You create a virtual network to provide access to on-premises resources, typically by using a site-to-site virtual network gateway. If you don't have a virtual network configured, you need to invest additional time for this.
69
67
70
-
-**Do the lab VMs need access to other Azure resources that are located within a VNet?**
68
+
-**Do the lab VMs need access to other Azure resources that are located within a virtual network?**
71
69
72
-
If you need access to Azure resources that are *not* secured within a VNet, then you can access these resources via the public internet without doing any peering.
70
+
If you need access to Azure resources that are *not* secured within a virtual network, then you can access these resources through the public internet, without doing any peering.
73
71
74
-
If you answered 'Yes' to one or more questions, then you will need to peer the lab account to a VNet. If you answered, 'I don't know', then you can postpone this decision until later since you can always choose to peer a VNet after creating the lab account.
72
+
If you answered "yes" to one or more questions, then you will need to peer the lab account to a virtual network. If you answered "I don't know," then you can postpone this decision until later. You can always choose to peer a virtual network after you create the lab account.
75
73
76
74
## Set up your lab account
77
75
78
-
Once you understand the requirements for your lab account, you are ready to set it up. Follow the links in this section to see how to set up your lab account:
79
-
80
-
1.**Create your lab account**
76
+
After you understand the requirements for your lab account, you're ready to set it up.
81
77
82
-
Refer to the tutorial on [creating a lab account](https://docs.microsoft.com/azure/lab-services/classroom-labs/tutorial-setup-lab-account#create-a-lab-account) for instructions.
78
+
1.**Create your lab account.** Refer to the tutorial on [creating a lab account](https://docs.microsoft.com/azure/lab-services/classroom-labs/tutorial-setup-lab-account#create-a-lab-account) for instructions.
83
79
84
-
When creating a lab account, you may find it helpful to familiarize yourself with the Azure resources involved; refer to the following list for more information and guidance on creating these resources:
80
+
When you're creating a lab account, you might find it helpful to familiarize yourself with the Azure resources involved. For more information, see the following articles:
-[Selecting a region and location](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#regionslocations)
87
+
-[Naming guidance for resources](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#naming)
94
88
95
-
Refer to the tutorial on [adding users to the Lab Creator role](https://docs.microsoft.com/azure/lab-services/classroom-labs/tutorial-setup-lab-account#add-a-user-to-the-lab-creator-role) for instructions.
89
+
2.**Add users to the lab creator role.** For instructions, see [adding users to the lab creator role](https://docs.microsoft.com/azure/lab-services/classroom-labs/tutorial-setup-lab-account#add-a-user-to-the-lab-creator-role).
96
90
97
-
Also, for more information on the different roles that can be assigned to users that will manage lab lab accounts and labs, see the [guide on managing identity](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#manage-identity).
91
+
Also, for more information on the different roles that can be assigned to users who will manage lab accounts and labs, see the [guide on managing identity](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#manage-identity).
98
92
99
-
3.**Connect to a peer VNet**
93
+
3.**Connect to a peer virtual network.** For instructions, see [connecting your lab's network with a peer virtual network](https://docs.microsoft.com/azure/lab-services/classroom-labs/how-to-connect-peer-virtual-network).
100
94
101
-
Refer to the how-to guide on [connecting your lab's network with a peer VNet](https://docs.microsoft.com/azure/lab-services/classroom-labs/how-to-connect-peer-virtual-network)for instructions.
95
+
You might also need to refer to instructions on [configuring the lab VMs address range](https://docs.microsoft.com/azure/lab-services/classroom-labs/how-to-configure-lab-accounts#specify-an-address-range-for-vms-in-the-lab).
102
96
103
-
You may also need to refer to instructions on [configuring the lab VMs address range](https://docs.microsoft.com/azure/lab-services/classroom-labs/how-to-configure-lab-accounts#specify-an-address-range-for-vms-in-the-lab).
97
+
4.**Enable and review images.** For instructions, see [enabling Azure Marketplace images for lab creators](https://docs.microsoft.com/azure/lab-services/classroom-labs/specify-marketplace-images).
104
98
105
-
4.**Enable and review images**
99
+
To review the contents of each Azure Marketplace image, select the image name. For example, the following screenshot shows the details for the Ubuntu Data Science VM image:
106
100
107
-
Refer to the how-to guide on [enabling Marketplace images for lab creators](https://docs.microsoft.com/azure/lab-services/classroom-labs/specify-marketplace-images) for instructions.
101
+
108
102
109
-
To review contents of each Marketplace image, click on the image name. For example, refer to the following screenshot which shows the details for the Ubuntu Data Science VM image:
103
+
If you have a shared image gallery attached to your lab account, and you want to enable custom images to be shared by lab creators, complete steps similar to those shown in the following screenshot:
If you have a Shared Image Gallery attached to your lab account and you want to enable custom images to be shared by lab creators, you will need to complete similar steps as shown in the following screenshot:
114
-
115
-
105
+
0 commit comments