Skip to content

Commit 1c198a8

Browse files
committed
Clarify storage and IP address requirements
1 parent 2cb487b commit 1c198a8

File tree

3 files changed

+18
-25
lines changed

3 files changed

+18
-25
lines changed

articles/cloud-shell/persisting-shell-storage.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: Walkthrough of how Azure Cloud Shell persists files.
33
ms.contributor: jahelmic
4-
ms.date: 04/25/2023
4+
ms.date: 09/29/2023
55
ms.topic: article
66
tags: azure-resource-manager
77
ms.custom: devx-track-linux
@@ -38,13 +38,10 @@ This fileshare is used for both Bash and PowerShell.
3838

3939
## Use existing resources
4040

41-
Using the advanced option, you can associate existing resources. When selecting a Cloud Shell region,
42-
you must select a backing storage account co-located in the same region. For example, if your
43-
assigned region is West US then you must associate a fileshare that resides within West US as well.
44-
45-
When the storage setup prompt appears, select **Show advanced settings** to view more options. The
46-
populated storage options filter for locally redundant storage (LRS), geo-redundant storage (GRS),
47-
and zone-redundant storage (ZRS) accounts.
41+
Using the advanced option, you can associate existing resources. When the storage setup prompt
42+
appears, select **Show advanced settings** to view more options. The populated storage options
43+
filter for locally redundant storage (LRS), geo-redundant storage (GRS), and zone-redundant storage
44+
(ZRS) accounts.
4845

4946
> [!NOTE]
5047
> Using GRS or ZRS storage accounts are recommended for additional resiliency for your backing file
@@ -82,9 +79,7 @@ Cloud Shell machines exist in the following regions:
8279
| Europe | North Europe, West Europe |
8380
| Asia Pacific | India Central, Southeast Asia |
8481

85-
Customers should choose a primary region, unless they have a requirement that their data at rest be
86-
stored in a particular region. If they have such a requirement, a secondary storage region should be
87-
used.
82+
You should choose a region that meets your requirements.
8883

8984
### Secondary storage regions
9085

@@ -102,10 +97,9 @@ of their fileshare.
10297

10398
## Restrict resource creation with an Azure resource policy
10499

105-
Storage accounts that you create in Cloud Shell are tagged with
106-
`ms-resource-usage:azure-cloud-shell`. If you want to disallow users from creating storage accounts
107-
in Cloud Shell, create an [Azure resource policy for tags][02] that is triggered by this specific
108-
tag.
100+
Storage accounts that created in Cloud Shell are tagged with `ms-resource-usage:azure-cloud-shell`.
101+
If you want to disallow users from creating storage accounts in Cloud Shell, create an
102+
[Azure resource policy for tags][02] that's triggered by this specific tag.
109103

110104
## How Cloud Shell storage works
111105

articles/cloud-shell/quickstart-deploy-vnet.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: This article provides step-by-step instructions to deploy Azure Cloud Shell in a private virtual network.
33
ms.contributor: jahelmic
4-
ms.date: 06/29/2023
4+
ms.date: 09/29/2023
55
ms.topic: article
66
ms.custom: devx-track-arm-template
77
title: Deploy Azure Cloud Shell in a VNET with quickstart templates
@@ -125,7 +125,9 @@ the **Azure Cloud Shell - VNet storage** template.
125125
Use the [Azure Cloud Shell - VNet][08] template to create Cloud Shell resources in a virtual
126126
network. The template creates three subnets under the virtual network created earlier. You may
127127
choose to change the supplied names of the subnets or use the defaults. The virtual network, along
128-
with the subnets, require valid IP address assignments.
128+
with the subnets, require valid IP address assignments. You need at least one IP address for the
129+
Relay subnet and enough IP addresses in the container subnet to support the number of concurrent
130+
sessions you expect to use.
129131

130132
The ARM template requires specific information about the resources you created earlier, along with
131133
naming information for new resources. This information is filled out along with the prefilled

articles/cloud-shell/troubleshooting.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: This article covers troubleshooting Cloud Shell common scenarios.
33
ms.contributor: jahelmic
4-
ms.date: 05/03/2023
4+
ms.date: 09/29/2023
55
ms.topic: article
66
tags: azure-resource-manager
77
ms.custom: has-azure-ad-ps-ref
@@ -123,10 +123,10 @@ Azure Cloud Shell has the following known limitations:
123123

124124
### Quota limitations
125125

126-
Azure Cloud Shell has a limit of 20 concurrent users per tenant per region. Opening more than 20
127-
simultaneous sessions produces a "Tenant User Over Quota" error. If you have a legitimate need to
128-
have more than 20 sessions open, such as for training sessions, contact Support to request a quota
129-
increase before your anticipated usage.
126+
Azure Cloud Shell has a limit of 20 concurrent users per tenant. Opening more than 20 simultaneous
127+
sessions produces a "Tenant User Over Quota" error. If you have a legitimate need to have more than
128+
20 sessions open, such as for training sessions, contact Support to request a quota increase before
129+
your anticipated usage.
130130

131131
Cloud Shell is provided as a free service for managing your Azure environment. It's not as a general
132132
purpose computing platform. Excessive automated usage may be considered in breach to the Azure Terms
@@ -141,8 +141,6 @@ considerations include:
141141

142142
- With mounted storage, only modifications within the `clouddrive` directory are persisted. In Bash,
143143
your `$HOME` directory is also persisted.
144-
- Azure fileshares can be mounted only from within your [assigned region][05].
145-
- In Bash, run `env` to find your region set as `ACC_LOCATION`.
146144
- Azure Files supports only locally redundant storage and geo-redundant storage accounts.
147145

148146
### Browser support
@@ -290,5 +288,4 @@ Azure Cloud Shell in Azure Government is only accessible through the Azure porta
290288
291289
<!-- link references -->
292290
[04]: https://docs.docker.com/desktop/
293-
[05]: persisting-shell-storage.md#mount-a-new-clouddrive
294291
[06]: /powershell/microsoftgraph/migration-steps

0 commit comments

Comments
 (0)