Merge pull request #311495 from eh8/main

v-shils · web-flow · commit 2e6c3b40a74c · 2026-02-06T13:21:21.000-08:00
Reorganize ACStor TOC and prerequisites
diff --git a/articles/storage/container-storage/TOC.yml b/articles/storage/container-storage/TOC.yml
@@ -6,41 +6,44 @@
   - name: What is Azure Container Storage?
     href: container-storage-introduction.md
 - name: How-to guides
+  expanded: true
   items:
   - name: Install Azure Container Storage
     href: install-container-storage-aks.md
   - name: Use with local NVMe
-    href: use-container-storage-with-local-disk.md
-  - name: Manage Local CSI driver placement
-    href: manage-local-container-storage-interface-driver-placement.md
+    items:
+    - name: Configure local NVMe
+      href: use-container-storage-with-local-disk.md
+    - name: Manage driver placement
+      href: manage-local-container-storage-interface-driver-placement.md
   - name: Use with Elastic SAN
-    href: use-container-storage-with-elastic-san.md
-  - name: Remove Azure Container Storage
-    href: remove-container-storage.md
-- name: Concepts
-  items:
-  - name: Frequently asked questions
-    href: container-storage-faq.md
-  - name: Enable zone-redundant storage
-    href: enable-multi-zone-redundancy.md
+    items:
+    - name: Configure Elastic SAN
+      href: use-container-storage-with-elastic-san.md
+    - name: Enable zone-redundant storage
+      href: enable-multi-zone-redundancy.md
+    - name: Volume snapshots
+      href: volume-snapshot-restore.md
+    - name: Configure encryption
+      href: configure-encryption-for-elastic-san.md
   - name: Resize persistent volumes
     href: resize-volume.md
-  - name: Volume snapshots
-    href: volume-snapshot-restore.md
-  - name: Configure encryption
-    href: configure-encryption-for-elastic-san.md
   - name: Connect with Prometheus
     href: enable-monitoring.md
   - name: Connect with Grafana
     href: use-grafana-dashboard.md
-  - name: Understand billing
-    href: container-storage-billing.md 
+  - name: Remove Azure Container Storage
+    href: remove-container-storage.md
 - name: Resources
   items:
-  - name: Pricing for Azure Container Storage
-    href: https://azure.microsoft.com/pricing/details/container-storage/
   - name: Release notes for Azure Container Storage
     href: container-storage-release-notes.md
+  - name: Frequently asked questions
+    href: container-storage-faq.md
+  - name: Understand billing
+    href: container-storage-billing.md 
+  - name: Pricing for Azure Container Storage
+    href: https://azure.microsoft.com/pricing/details/container-storage/
 - name: Reference
   items:
   - name: Storage pool parameters (version 1.x.x)
diff --git a/articles/storage/container-storage/clone-volume.md b/articles/storage/container-storage/clone-volume.md
@@ -18,7 +18,7 @@ You can clone persistent volumes in Azure Container Storage (version 1.x.x). A c
 
 ## Prerequisites
 
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you're using Azure Cloud Shell, the latest version is already installed. If you plan to run the commands locally instead of in Azure Cloud Shell, be sure to run them with administrative privileges.
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 - You'll need an Azure Kubernetes Service (AKS) cluster with a node pool of at least three virtual machines (VMs) for the cluster nodes, each with a minimum of four virtual CPUs (vCPUs).
 - This article assumes you've already installed Azure Container Storage on your AKS cluster, and that you've created a storage pool and persistent volume claim (PVC) using either [Azure Disks](use-container-storage-with-managed-disks.md) or [ephemeral disk (local storage)](use-container-storage-with-local-disk-version-1.md). Azure Elastic SAN doesn't support resizing volumes.
 
diff --git a/articles/storage/container-storage/configure-encryption-for-elastic-san.md b/articles/storage/container-storage/configure-encryption-for-elastic-san.md
@@ -17,8 +17,8 @@ This article shows how to configure encryption for an Elastic SAN volume group b
 
 ## Prerequisites
 
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you use Azure Cloud Shell, the latest version is already installed. If you run commands locally, use an account with administrative privileges.
-- This article assumes you installed Azure Container Storage version 2.1.0 or later on your Azure Kubernetes Service (AKS) cluster.
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
+- This article assumes you [installed Azure Container Storage version 2.1.0 or later](./install-container-storage-aks.md) on your Azure Kubernetes Service (AKS) cluster.
 
 ## Configure the key vault
 
diff --git a/articles/storage/container-storage/container-storage-aks-quickstart-version-1.md b/articles/storage/container-storage/container-storage-aks-quickstart-version-1.md
@@ -19,14 +19,7 @@ Azure Container Storage is a cloud-based volume management, deployment, and orch
 
 ## Prerequisites
 
-- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
-
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you're using the Bash environment in Azure Cloud Shell, the latest version is already installed. If you plan to run the commands locally instead of in Azure Cloud Shell, be sure to run them with administrative privileges. For more information, see [Get started with Azure Cloud Shell](/azure/cloud-shell/get-started).
-
-- You'll need the Kubernetes command-line client, `kubectl`. It's already installed if you're using Azure Cloud Shell, or you can install it locally by running the `az aks install-cli` command.
-
-- Check if your target region is supported in [Azure Container Storage regions](container-storage-introduction-version-1.md#regional-availability).
-
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 - If you haven't already created an AKS cluster, follow the instructions for [Installing an AKS Cluster](install-container-storage-aks-version-1.md).
 
 ## Getting started
diff --git a/articles/storage/container-storage/enable-multi-zone-redundancy-version-1.md b/articles/storage/container-storage/enable-multi-zone-redundancy-version-1.md
@@ -18,10 +18,8 @@ You can improve stateful application availability by using multi-zone storage po
 
 ## Prerequisites
 
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you're using Azure Cloud Shell, the latest version is already installed. If you plan to run the commands locally instead of in Azure Cloud Shell, be sure to run them with administrative privileges.
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 - You'll need an AKS cluster with a node pool of at least three virtual machines (VMs) for the cluster nodes, each with a minimum of four virtual CPUs (vCPUs).
-- This article assumes you've already [installed Azure Container Storage (version 1.x.x)](container-storage-aks-quickstart-version-1.md) on your AKS cluster.
-- You'll need the Kubernetes command-line client, `kubectl`. It's already installed if you're using Azure Cloud Shell, or you can install it locally by running the `az aks install-cli` command.
 
 ## Create a multi-zone storage pool
 
diff --git a/articles/storage/container-storage/enable-multi-zone-redundancy.md b/articles/storage/container-storage/enable-multi-zone-redundancy.md
@@ -22,19 +22,14 @@ With Azure Container Storage, you can improve stateful application availability
 ## Prerequisites
 
 [!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
-
 - If you use Elastic SAN for the first time in the subscription, run this one-time registration command:
-
 ```azurecli-interactive
 az provider register --namespace Microsoft.ElasticSan
 ```
-
 - When ZRS is newly enabled in a region, you might need to register a subscription-level feature flag so Azure Container Storage can deploy SAN targets:
-
 ```azurecli
 Register-AzProviderFeature -FeatureName EnableElasticSANTargetDeployment -ProviderNamespace Microsoft.ElasticSan
 ```
-
 - Verify that the region supports your chosen redundancy option. See the current [Elastic SAN region availability](../elastic-san/elastic-san-create.md#).
 
 ## Create a StorageClass with locally redundant storage
diff --git a/articles/storage/container-storage/install-container-storage-aks-version-1.md b/articles/storage/container-storage/install-container-storage-aks-version-1.md
@@ -28,13 +28,11 @@ Azure Container Storage is a cloud-based volume management, deployment, and orch
 
 ## Prerequisites
 
-* If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
-
-* This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you're using the Bash environment in Azure Cloud Shell, the latest version is already installed. If you plan to run the commands locally instead of in Azure Cloud Shell, be sure to run them with administrative privileges. For more information, see [Get started with Azure Cloud Shell](/azure/cloud-shell/get-started).
-
-* You'll need the Kubernetes command-line client, `kubectl`. It's already installed if you're using Azure Cloud Shell, or you can install it locally by running the `az aks install-cli` command.
-
-* Check if your target region is supported in [Azure Container Storage regions](container-storage-introduction.md#regional-availability).
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
+- Plan your node pool configuration:
+  - Use Linux as the OS type (Windows isn't supported).
+  - Select a virtual machine (VM) SKU that supports local NVMe data disks if you plan to use the local NVMe storage type, such as [storage-optimized](/azure/virtual-machines/sizes/overview#storage-optimized) or [GPU-accelerated](/azure/virtual-machines/sizes/overview#gpu-accelerated) VMs.
+  - For existing clusters, ensure node pools already use a supported VM SKU before enabling Azure Container Storage.
 
 ## Getting started
 
diff --git a/articles/storage/container-storage/install-container-storage-aks.md b/articles/storage/container-storage/install-container-storage-aks.md
@@ -34,14 +34,11 @@ By the end of this tutorial, you can:
 
 ## Prerequisites
 
-- Create an Azure subscription if you don't already have one by signing up for a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
-- Confirm that your target region is supported by reviewing the [Azure Container Storage regional availability](container-storage-introduction.md#regional-availability).
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 - Plan your node pool configuration:
   - Use Linux as the OS type (Windows isn't supported).
   - Select a virtual machine (VM) SKU that supports local NVMe data disks if you plan to use the local NVMe storage type, such as [storage-optimized](/azure/virtual-machines/sizes/overview#storage-optimized) or [GPU-accelerated](/azure/virtual-machines/sizes/overview#gpu-accelerated) VMs.
   - For existing clusters, ensure node pools already use a supported VM SKU before enabling Azure Container Storage.
-- Install the latest version of the [Azure CLI](/cli/azure/install-azure-cli) (2.83.0 or later), then sign in with `az login`. Avoid Azure Cloud Shell because `az upgrade` isn't available there. Disable conflicting extensions such as `aks-preview` if issues occur.
-- Install the Kubernetes command-line client, `kubectl`. You can install it locally by running `az aks install-cli`.
 - If you use Elastic SAN for the first time in the subscription, run this one-time registration command:
 
 ```azurecli-interactive
@@ -161,11 +158,10 @@ This command installs the installer, deploys the Elastic SAN CSI driver, and cre
   - Use Linux as the OS type (Windows isn't supported).
   - Select a virtual machine (VM) SKU that supports local NVMe data disks, such as [storage-optimized](/azure/virtual-machines/sizes/overview#storage-optimized) or [GPU-accelerated](/azure/virtual-machines/sizes/overview#gpu-accelerated) VMs.
   - For existing clusters, ensure node pools already use a supported VM SKU before enabling Azure Container Storage.
-- Install the [Azure CLI](/cli/azure/install-azure-cli) version 2.77.0 or later, then sign in with `az login`.
+- Install the [Azure CLI](/cli/azure/install-azure-cli) version 2.83.0 or later, then sign in with `az login`.
 - Install [Terraform](https://developer.hashicorp.com/terraform/install) version 1.5 or later and confirm the installation with `terraform version`. Terraform can reuse your Azure CLI authentication.
 - Install `kubectl` so you can validate the cluster after deployment. If needed, run `az aks install-cli` to install it locally.
 - If you use Elastic SAN for the first time in the subscription, run this one-time registration command:
-
 ```azurecli
 az provider register --namespace Microsoft.ElasticSan
 ```
diff --git a/articles/storage/container-storage/install-container-storage-azure-arc.md b/articles/storage/container-storage/install-container-storage-azure-arc.md
@@ -19,13 +19,7 @@ This article shows you how to create an [Azure Kubernetes Service (AKS)](/azure/
 
 ## Prerequisites
 
-* If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
-
-* This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you're using the Bash environment in Azure Cloud Shell, the latest version is already installed. If you plan to run the commands locally instead of in Azure Cloud Shell, be sure to run them with administrative privileges. For more information, see [Get started with Azure Cloud Shell](/azure/cloud-shell/get-started).
-
-* You'll need the Kubernetes command-line client, `kubectl`. It's already installed if you're using Azure Cloud Shell, or you can install it locally by running the `az aks install-cli` command.
-
-* Check if your target region is supported in [Azure Container Storage regions](container-storage-introduction-version-1.md#regional-availability).
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 
 ## Getting started
 
diff --git a/articles/storage/container-storage/resize-volume.md b/articles/storage/container-storage/resize-volume.md
@@ -17,8 +17,8 @@ You can't increase a volume beyond the maximum capacity available in your Elasti
 
 ## Prerequisites
 
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you use Azure Cloud Shell, the latest version is already installed. If you run commands locally, use an account with administrative privileges.
-- This article assumes you installed Azure Container Storage version 2.x.x on your AKS cluster and created a persistent volume claim (PVC) using [Elastic SAN](use-container-storage-with-elastic-san.md) or [ephemeral disk (local NVMe)](use-container-storage-with-local-disk.md).
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
+- This article assumes you [installed Azure Container Storage version 2.x.x](./install-container-storage-aks.md) on your AKS cluster and created a persistent volume claim (PVC) using [Elastic SAN](use-container-storage-with-elastic-san.md) or [ephemeral disk (local NVMe)](use-container-storage-with-local-disk.md).
 
 ## Expand a volume
 
diff --git a/articles/storage/container-storage/use-container-storage-with-elastic-san-version-1.md b/articles/storage/container-storage/use-container-storage-with-elastic-san-version-1.md
@@ -24,9 +24,7 @@ This article shows you how to configure Azure Container Storage (version 1.x.x)
 ## Prerequisites
 
 [!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
-
 - Ensure you have either an [Azure Container Storage Owner](../../role-based-access-control/built-in-roles/containers.md#azure-container-storage-owner) role or [Azure Container Storage Contributor](../../role-based-access-control/built-in-roles/containers.md#azure-container-storage-contributor) role on your subscription. The Azure Container Storage Contributor role grants you permissions needed to perform Azure Arc extension actions and to write to and delete resources. The Azure Container Storage Owner role grants you the same permissions and allows you to manage Elastic SAN volumes outside of your cluster. To make this change, go to your subscription page in the Azure portal. Select **Access control (IAM) > Add role assignment** and search for either "Azure Container Storage Owner" or "Azure Container Storage Contributor" in the **Job function roles** tab. Select **View > Assignments > Add assignment** and add your account.
-
 - To use Azure Container Storage (version 1.x.x) with Azure Elastic SAN (preview), your AKS cluster must have a node pool of at least three [general purpose VMs](/azure/virtual-machines/sizes-general) such as **standard_d4s_v5** for the cluster nodes, each with a minimum of four virtual CPUs (vCPUs).
 
 ## Limitations
diff --git a/articles/storage/container-storage/use-container-storage-with-elastic-san.md b/articles/storage/container-storage/use-container-storage-with-elastic-san.md
@@ -26,6 +26,7 @@ Azure Elastic SAN is a managed, shared block-storage service that provides a cen
 ## Prerequisites
 
 [!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
+- [Review the installation instructions](install-container-storage-aks.md) and ensure Azure Container Storage is properly installed.
 
 ## Limitations
 
diff --git a/articles/storage/container-storage/use-container-storage-with-local-disk.md b/articles/storage/container-storage/use-container-storage-with-local-disk.md
@@ -33,16 +33,9 @@ For example, the [Lsv3 series](/azure/virtual-machines/sizes/storage-optimized/l
 
 ## Prerequisites
 
-- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn) before you begin.
-
-- This article requires the latest version (2.77.0 or later) of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). Avoid Azure Cloud Shell, because `az upgrade` isn't available in Cloud Shell. Be sure to run the commands in this article with administrative privileges.
-
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
 - [Review the installation instructions](install-container-storage-aks.md) and ensure Azure Container Storage is properly installed.
 
-- You need the Kubernetes command-line client, `kubectl`. You can install it locally by running the `az aks install-cli` command.
-
-- Check if your target region is supported in [Azure Container Storage regions](container-storage-introduction.md#regional-availability).
-
 ## Choose a VM type that supports local NVMe
 
 Local NVMe disks are only available in certain types of VMs, for example, [storage-optimized VMs](/azure/virtual-machines/sizes/overview#storage-optimized) or [GPU accelerated VMs](/azure/virtual-machines/sizes/overview#gpu-accelerated). If you plan to use local NVMe capacity, choose one of these VM sizes.
diff --git a/articles/storage/container-storage/use-container-storage-with-managed-disks.md b/articles/storage/container-storage/use-container-storage-with-managed-disks.md
@@ -20,7 +20,6 @@ Azure Container Storage is a cloud-based volume management, deployment, and orch
 ## Prerequisites
 
 [!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
-
 - To use Azure Container Storage with Azure managed disks, your AKS cluster must have a node pool of at least three [general purpose VMs](/azure/virtual-machines/sizes-general) such as **standard_d4s_v5** for the cluster nodes, each with a minimum of four virtual CPUs (vCPUs).
 
 ## Create and attach persistent volumes
diff --git a/articles/storage/container-storage/volume-snapshot-restore.md b/articles/storage/container-storage/volume-snapshot-restore.md
@@ -19,8 +19,8 @@ Volume snapshots aren't supported when you use ephemeral disk (local NVMe) as ba
 
 ## Prerequisites
 
-- This article requires the latest version of the Azure CLI. See [How to install the Azure CLI](/cli/azure/install-azure-cli). If you use Azure Cloud Shell, the latest version is already installed. If you run commands locally, use an account with administrative privileges.
-- This article assumes you installed Azure Container Storage on your Azure Kubernetes Service (AKS) cluster and created a PVC using [Azure Elastic SAN](use-container-storage-with-elastic-san.md).
+[!INCLUDE [container-storage-prerequisites](../../../includes/container-storage-prerequisites.md)]
+- This article assumes you [installed Azure Container Storage](./install-container-storage-aks.md) on your Azure Kubernetes Service (AKS) cluster and created a PVC using [Azure Elastic SAN](use-container-storage-with-elastic-san.md).
 
 ## Create a volume snapshot class
 
diff --git a/includes/container-storage-prerequisites.md b/includes/container-storage-prerequisites.md
