Skip to content

Commit 1e0cfe1

Browse files
Merge pull request #308142 from eh8/patch-eh8-1
Readability improvements for Azure Container Storage local NVMe page
2 parents 01dbf1b + 1d47183 commit 1e0cfe1

2 files changed

Lines changed: 12 additions & 7 deletions

File tree

articles/storage/container-storage/install-container-storage-aks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -140,5 +140,5 @@ After installation, configure `kubectl` to connect to your cluster and verify th
140140
141141
## Next step
142142
143-
- [Create generic ephemeral volume with local NVMe](use-container-storage-with-local-disk.md)
143+
- [Use Azure Container Storage with local NVMe](use-container-storage-with-local-disk.md)
144144
- [Overview of deploying a highly available PostgreSQL database on Azure Kubernetes Service (AKS)](/azure/aks/postgresql-ha-overview#storage-considerations)

articles/storage/container-storage/use-container-storage-with-local-disk.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ ms.custom: references_regions
1919
2020
## What is local NVMe?
2121

22-
When your application needs sub-millisecond storage latency and high throughput, you can use local NVMe with Azure Container Storage to meet your performance requirements. Ephemeral means that the disks are deployed on the local virtual machine (VM) hosting the AKS cluster and not saved to an Azure storage service. Data is lost on these disks if you stop/deallocate your VM. Local NVMe disks are offered on select Azure VM families such as [storage-optimized](/azure/virtual-machines/sizes/overview#storage-optimized) VMs.
22+
When your application needs sub-millisecond storage latency and high throughput, you can use local NVMe disks with Azure Container Storage to meet your performance requirements. Ephemeral means that the disks are deployed on the local virtual machine (VM) hosting the AKS cluster and not saved to an Azure storage service. Data is lost on these disks if you stop/deallocate your VM. Local NVMe disks are offered on select Azure VM families such as [storage-optimized](/azure/virtual-machines/sizes/overview#storage-optimized) VMs.
2323

2424
By default, Azure Container Storage creates *generic ephemeral volumes* when using local NVMe disks. For use cases that require *persistent volume claims*, you can add the annotation `localdisk.csi.acstor.io/accept-ephemeral-storage: "true"` in your persistent volume claim template.
2525

@@ -35,14 +35,14 @@ For example, the [Lsv3 series](/azure/virtual-machines/sizes/storage-optimized/l
3535

3636
- 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.
3737

38-
- 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). Don't use Azure Cloud Shell, because `az upgrade` isn't available in Cloud Shell. Be sure to run the commands in this article with administrative privileges.
38+
- 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.
39+
40+
- [Review the installation instructions](install-container-storage-aks.md) and ensure Azure Container Storage is properly installed.
3941

4042
- You need the Kubernetes command-line client, `kubectl`. You can install it locally by running the `az aks install-cli` command.
4143

4244
- Check if your target region is supported in [Azure Container Storage regions](container-storage-introduction.md#regional-availability).
4345

44-
- You can now use clusters with a single node, though multi-node configurations are still recommended.
45-
4646
## Choose a VM type that supports local NVMe
4747

4848
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.
@@ -66,11 +66,12 @@ nodepool1 standard_l8s_v3
6666
6767
## Create and attach generic ephemeral volumes
6868

69-
Follow these steps to create and attach a generic ephemeral volume using Azure Container Storage.
69+
If you haven't already done so, [install Azure Container Storage.](install-container-storage-aks.md)
7070

71+
Follow these steps to create and attach a generic ephemeral volume using Azure Container Storage.
7172
### 1. Create a storage class
7273

73-
Unlike previous versions that required creating a custom storage pool resource, Azure Container Storage (version 2.x.x) uses standard Kubernetes storage classes. This change simplifies the storage configuration process.
74+
Unlike previous versions that required creating a custom storage pool resource, Azure Container Storage (version 2.x.x) uses standard Kubernetes storage classes.
7475

7576
Follow these steps to create a storage class using local NVMe.
7677

@@ -175,6 +176,8 @@ While generic ephemeral volumes are recommended for ephemeral storage, Azure Con
175176
176177
### 1. Create a storage class (if not already created)
177178

179+
If you haven't already done so, [install Azure Container Storage.](install-container-storage-aks.md)
180+
178181
If you did not create a storage class that uses local NVMe in the previous section, create one now:
179182

180183
1. Use your favorite text editor to create a YAML manifest file such as `code storageclass.yaml`.
@@ -303,5 +306,7 @@ kubectl delete storageclass local
303306
## See also
304307

305308
- [What is Azure Container Storage?](container-storage-introduction.md)
309+
- [Install Azure Container Storage with AKS](install-container-storage-aks.md)
306310
- [Use Azure Container Storage (version 1.x.x) with local NVMe](use-container-storage-with-local-disk-version-1.md)
307311
- [Overview of deploying a highly available PostgreSQL database on Azure Kubernetes Service (AKS)](/azure/aks/postgresql-ha-overview#storage-considerations)
312+
- [Best practices for ephemeral NVMe data disks in Azure Kubernetes Service (AKS)](/azure/aks/best-practices-storage-nvme)

0 commit comments

Comments
 (0)