Merge pull request #311587 from fhryo-msft/patch-60

Enhance guidance on local NVMe disk usage

Author: ttorble

articles/storage/container-storage/TOC.yml

@@ -16,6 +16,8 @@
       href: use-container-storage-with-local-disk.md
     - name: Manage driver placement
       href: manage-local-container-storage-interface-driver-placement.md
+    - name: Best practices for ephemeral NVMe data disks
+      href: /azure/aks/best-practices-storage-nvme?toc=/azure/storage/container-storage/toc.json
   - name: Use with Elastic SAN
     items:
     - name: Configure Elastic SAN

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

@@ -57,6 +57,13 @@ nodepool1   standard_l8s_v3
 > [!NOTE]
 > In Azure Container Storage (version 2.x.x), you can now use clusters with fewer than three nodes.
 
+In scenarios where VM sizes with a single local NVMe disk are used alongside ephemeral OS disks, the local NVMe disk is allocated for the OS, leaving no capacity for Azure Container Storage to utilize. To ensure optimal performance and availability of local NVMe disks for high-performance data processing, we recommend that you do the following:
+
+- Select VM sizes with two or more local NVMe disks.
+- Use managed disks for the OS, freeing up all local NVMe disks for data processing.
+
+For more information, refer to [Best practices for ephemeral NVMe data disks in Azure Kubernetes Service](/azure/aks/best-practices-storage-nvme#ephemeral-nvme-data-disks-with-ephemeral-os-disks).
+
 ## Create a storage class for local NVMe
 
 If you haven't already done so, [install Azure Container Storage.](install-container-storage-aks.md)