Skip to content

Commit 2ecc9ca

Browse files
committed
fixed feedback
1 parent 60dfc8c commit 2ecc9ca

File tree

7 files changed

+60
-57
lines changed

7 files changed

+60
-57
lines changed

articles/lab-services/classroom-labs/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,9 +31,9 @@
3131
- name: Administrator guide
3232
href: administrator-guide.md
3333
- name: Accelerated lab account set up guide
34-
href: lab-account-setup-guide.md
34+
href: account-setup-guide.md
3535
- name: Accelerated lab set up guide
36-
href: lab-setup-guide.md
36+
href: setup-guide.md
3737
- name: Classroom labs - class types
3838
items:
3939
- name: Class types overview

articles/lab-services/classroom-labs/lab-account-setup-guide.md renamed to articles/lab-services/classroom-labs/account-setup-guide.md

Lines changed: 24 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Accelerated lab account set up guide | Azure Lab Services
2+
title: Accelerated Lab Account Setup Guide Azure | Lab Services
33
description: This guide helps administrators quickly set up a lab account for use within their school.
44
services: lab-services
55
documentationcenter: na
@@ -17,61 +17,62 @@ ms.author: spelluru
1717

1818
---
1919

20-
# Lab Account Set Up Guide
20+
# Lab Account Setup Guide
2121

2222
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.
2323

2424
## Understand Your School's Lab Account Requirements
2525

2626
To understand how to configure your lab account based on your school's needs, you should consider the following questions:
2727

28-
1. **Do I have access to an Azure subscription?**
28+
- **Do I have access to an Azure subscription?**
2929

3030
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. If you don't have a subscription, you should contact your account specialist to help with setting this up.
3131

32-
1. **How many lab accounts need to be created?**
32+
- **How many lab accounts need to be created?**
3333

3434
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.
3535

36-
1. **Who should be owners and contributors of the lab account?**
36+
- **Who should be owners and contributors of the lab account?**
3737

3838
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.
3939

40-
1. **Who will be allowed to create\manage labs?**
40+
- **Who will be allowed to create\manage labs?**
4141

4242
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.
4343

44-
1. **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?**
4545

4646
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.
4747

4848
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.
4949

5050
When you have a Shared Image Gallery attached to your lab account
5151

52-
1. **Which images in the Azure Marketplace will your classroom labs use?**
52+
**Which images in the Azure Marketplace will your classroom labs use?**
5353

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.
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.
5555

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.
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.
5757

58-
1. **Do the lab's virtual machines (VMs) need to have access to other Azure or on-prem resources?**
58+
**Do the lab's virtual machines (VMs) need to have access to other Azure or on-prem resources?**
5959

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:
61-
- **Do you need to provide access to a licensing server?**
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:
61+
62+
- **Do you need to provide access to a licensing server?**
6263

63-
> [!NOTE]
64+
> [!NOTE]
6465
> 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.
6566
66-
- **Do the lab VMs need access to other on-prem resources, such as a file share, database, etc.?**
67+
- **Do the lab VMs need access to other on-prem resources, such as a file share, database, etc.?**
6768

68-
> [!NOTE]
69-
> 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.
69+
> [!NOTE]
70+
> 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.
7071
71-
- **Do the lab VMs need access to other Azure resources that are located within a VNet?**
72+
- **Do the lab VMs need access to other Azure resources that are located within a VNet?**
7273

73-
> [!NOTE]
74-
> 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.
74+
> [!NOTE]
75+
> 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.
7576
7677
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.
7778

@@ -96,7 +97,7 @@ Once you understand the requirements for your lab account, you are ready to set
9697

9798
Refer to the how-to guide on [adding users to the Lab Creator role](https://docs.microsoft.com/azure/lab-services/classroom-labs/add-lab-creator) for instructions.
9899

99-
Also, for more information on the different roles that can be assigned to suers 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).
100+
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).
100101

101102
3. **Connect to a peer VNet**
102103

@@ -110,8 +111,8 @@ Once you understand the requirements for your lab account, you are ready to set
110111

111112
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:
112113

113-
![Review Marketplace images](../media/setup-azlabs-guide/review-marketplace-images.png)
114+
![Review Marketplace images](../media/setup-guide/review-marketplace-images.png)
114115

115116
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:
116117

117-
![Enabling custom images in Shared Image Gallery](../media/setup-azlabs-guide/enable-sig-custom-images.png)
118+
![Enabling custom images in Shared Image Gallery](../media/setup-guide/enable-sig-custom-images.png)

articles/lab-services/classroom-labs/lab-setup-guide.md renamed to articles/lab-services/classroom-labs/setup-guide.md

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Accelerated classroom lab set up guide | Azure Lab Services
2+
title: Accelerated Classroom Lab Setup Guide Azure | Lab Services
33
description: This guide helps lab creators quickly set up a lab account for use within their school.
44
services: lab-services
55
documentationcenter: na
@@ -17,65 +17,67 @@ ms.author: spelluru
1717

1818
---
1919

20-
# Classroom Lab Set Up Guide
20+
# Classroom Lab Setup Guide
2121

2222
The process for publishing a lab to your students can take up to several hours depending on the number of virtual machines (VMs) that will be created in your lab. You should give yourself at least a day to set up a lab to ensure that it's working properly and to allow enough time to publish students' VMs.
2323

24-
## Understand your class's lab requirements
24+
## Understand Your Class's Lab Requirements
2525

2626
Before you set up a new lab, you should consider the following questions:
2727

28-
1. **What software requirements does the class have?**
28+
**What software requirements does the class have?**
2929

30-
Based on your class's learning objectives, you should decide which OS, applications, tools, etc. need to be installed on the lab's VMs. To set up lab VMs, you have three options:
30+
Based on your class's learning objectives, you should decide which OS, applications, tools, etc. need to be installed on the lab's VMs. To set up lab VMs, you have three options:
3131

32-
- **Use an Azure Marketplace image** – The Marketplace provides hundreds of images that you can use when creating a lab. For some classes, a marketplace image may already contain everything that you need for your class.
32+
- **Use an Azure Marketplace image** – The Marketplace provides hundreds of images that you can use when creating a lab. For some classes, a marketplace image may already contain everything that you need for your class.
3333

34-
- **Create a new custom image** - You may create your own custom image by using a marketplace image as a starting point and customizing it by installing additional software, making configuration changes, etc.
34+
- **Create a new custom image** - You may create your own custom image by using a marketplace image as a starting point and customizing it by installing additional software, making configuration changes, etc.
3535

36-
- **Use an existing custom image** - You may reuse existing custom images that you previously created or that were created by other administrators\faculty at your school; this requires your administrators to have configured a Shared Image Gallery which is a repository for saving custom images.
36+
- **Use an existing custom image** - You may reuse existing custom images that you previously created or that were created by other administrators\faculty at your school; this requires your administrators to have configured a Shared Image Gallery which is a repository for saving custom images.
3737

38-
> [!NOTE]
39-
> Your administrators are responsible for enabling Marketplace and custom images so that you can use them; you will need to coordinate with your IT department to ensure that images that you need are enabled. Custom images that you create are automatically enabled for use within labs that you own.
38+
> [!NOTE]
39+
> Your administrators are responsible for enabling Marketplace and custom images so that you can use them; you will need to coordinate with your IT department to ensure that images that you need are enabled. Custom images that you create are automatically enabled for use within labs that you own.
4040
41-
1. **What hardware requirements does the class have?**
41+
**What hardware requirements does the class have?**
4242

43-
There are a variety of compute sizes that you can choose from that includes:
44-
- Nested virtualization sizes so that you can give access to students to a VM that is capable of hosting multiple nested VMs; for example, this compute size is often used for Networking courses.
45-
- GPU sizes so that your students can use computer-intensive types of applications, such as for Artificial Intelligence and Machine Learning.
43+
There are a variety of compute sizes that you can choose from that includes:
4644

47-
Refer to the guide on [VM sizing](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#vm-sizing) to see the complete list of available compute sizes.
45+
- Nested virtualization sizes so that you can give access to students to a VM that is capable of hosting multiple nested VMs; for example, this compute size is often used for Networking courses.
4846

49-
> [!NOTE]
47+
- GPU sizes so that your students can use computer-intensive types of applications, such as for Artificial Intelligence and Machine Learning.
48+
49+
Refer to the guide on [VM sizing](https://docs.microsoft.com/azure/lab-services/classroom-labs/administrator-guide#vm-sizing) to see the complete list of available compute sizes.
50+
51+
> [!NOTE]
5052
> Depending on the region you select for your lab, you may see fewer compute sizes available since this varies by region. If you need to create a lab using a large number of GPU VMs, you should coordinate with your account specialist to submit a request to ensure that the number VMs are available within your region. Our general recommendation is to select the smallest compute size that is closest to your needs. With Lab Services, you can easily set up a new lab with a different compute capacity later if needed.
5153
52-
1. **What dependencies does the class have on external Azure or network resources?**
54+
**What dependencies does the class have on external Azure or network resources?**
5355

54-
If your lab VMs need to use external resources, such as a database, file share, licensing server, etc. you will need to coordinate with your administrators to ensure that your lab has access to these resources.
56+
If your lab VMs need to use external resources, such as a database, file share, licensing server, etc. you will need to coordinate with your administrators to ensure that your lab has access to these resources.
5557

56-
For access to Azure resources that are *not* secured by a virtual network, then you can access these resources via the public internet without any additional configuration by your administrators.
58+
For access to Azure resources that are *not* secured by a virtual network, then you can access these resources via the public internet without any additional configuration by your administrators.
5759

58-
> [!NOTE]
59-
> You should consider whether you can reduce your lab's dependencies to external resources by providing the resource directly on the VM. For example, to eliminate the need to read data from an external database, you could install the database directly on the VM.
60+
> [!NOTE]
61+
> You should consider whether you can reduce your lab's dependencies to external resources by providing the resource directly on the VM. For example, to eliminate the need to read data from an external database, you could install the database directly on the VM.
6062
61-
1. **How will costs be controlled?**
63+
**How will costs be controlled?**
6264

63-
Lab Services uses a pay-as-you go pricing model which means that you only pay for the time that a lab VM is running. To control costs, you have three options that are typically used in conjunction with one another:
65+
Lab Services uses a pay-as-you go pricing model which means that you only pay for the time that a lab VM is running. To control costs, you have three options that are typically used in conjunction with one another:
6466

65-
- **Schedule** - A schedule allows you to automatically control when your labs' VMs are started and shut down.
66-
- **Quota** - The quota controls the number of hours that students will have access to a VM outside of the scheduled hours. If the quota is reached while a student is using it, the VM is automatically shut down and the student is not able to restart the VM unless the quota is increased.
67-
- **Auto-shutdown** - When enabled, the auto-shutdown setting causes Windows VMs to automatically shut down after a certain length of time once a student has disconnected from their RDP session. By default, this setting is disabled.
67+
- **Schedule** - A schedule allows you to automatically control when your labs' VMs are started and shut down.
68+
- **Quota** - The quota controls the number of hours that students will have access to a VM outside of the scheduled hours. If the quota is reached while a student is using it, the VM is automatically shut down and the student is not able to restart the VM unless the quota is increased.
69+
- **Auto-shutdown** - When enabled, the auto-shutdown setting causes Windows VMs to automatically shut down after a certain length of time once a student has disconnected from their RDP session. By default, this setting is disabled.
6870

69-
> [!NOTE]
70-
> This setting currently only exists for Windows; Linux support is coming soon.
71+
> [!NOTE]
72+
> This setting currently only exists for Windows.
7173
72-
1. **How will students connect to their VM?**
74+
**How will students connect to their VM?**
7375

74-
For RDP to Windows VMs, we recommend students use [Microsoft Remote Desktop client](https://docs.microsoft.com/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients). Remote Desktop client supports Macs, Chromebooks, and Windows.
76+
For RDP to Windows VMs, we recommend students use [Microsoft Remote Desktop client](https://docs.microsoft.com/windows-server/remote/remote-desktop-services/clients/remote-desktop-clients). Remote Desktop client supports Macs, Chromebooks, and Windows.
7577

76-
For Linux VMs, students may use either SSH or RDP. To connect using RDP, you are responsible for installing and configuring the necessary RDP and GUI packages. More details on this is provided below.
78+
For Linux VMs, students may use either SSH or RDP. To connect using RDP, you are responsible for installing and configuring the necessary RDP and GUI packages. More details on this is provided below.
7779

78-
## Set up your lab
80+
## Set Up Your Lab
7981

8082
Once you understand the requirements for your class's lab, you are ready to set it up. Follow the links in this section to see how to set up your lab.
8183

Binary file not shown.
Binary file not shown.
127 KB
Loading
276 KB
Loading

0 commit comments

Comments
 (0)