Merge pull request #278725 from khdownie/kendownie061924-2

split up ephemeral

Author: AnnaMHuff

articles/storage/container-storage/TOC.yml

@@ -13,14 +13,20 @@
   items:
   - name: Create AKS cluster and install Azure Container Storage
     href: install-container-storage-aks.md
-- name: How-to guides
+- name: Storage options
   items:
   - name: Use with Azure Disks
     href: use-container-storage-with-managed-disks.md
-  - name: Use with Ephemeral Disk
-    href: use-container-storage-with-local-disk.md
   - name: Use with Azure Elastic SAN
     href: use-container-storage-with-elastic-san.md
+  - name: Use with local NVMe
+    href: use-container-storage-with-local-disk.md
+  - name: Use with local NVMe replication
+    href: use-container-storage-with-local-nvme-replication.md
+  - name: Use with temp SSD
+    href: use-container-storage-with-temp-ssd.md    
+- name: How-to guides
+  items:
   - name: Use volume snapshot and restore
     href: volume-snapshot-restore.md
   - name: Expand a persistent volume

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

@@ -4,7 +4,7 @@ description: Create a Linux-based Azure Kubernetes Service (AKS) cluster, instal
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: quickstart
-ms.date: 03/21/2024
+ms.date: 06/19/2024
 ms.author: kendownie
 ms.custom: devx-track-azurecli, ignite-2023-container-storage, linux-related-content
 ---
@@ -74,7 +74,7 @@ To connect to the cluster, use the Kubernetes command-line client, `kubectl`. It
    
 ## Choose a data storage option for your storage pool
 
-Before deploying Azure Container Storage, you'll need to decide which back-end storage option you want to use to create your storage pool and persistent volumes. Three options are currently available:
+Before deploying Azure Container Storage, you'll need to decide which back-end storage option you want to use to create your storage pool and volumes. Three options are currently available:
 
 - **Azure Elastic SAN**: Azure Elastic SAN is a good fit for general purpose databases, streaming and messaging services, CI/CD environments, and other tier 1/tier 2 workloads. Storage is provisioned on demand per created volume and volume snapshot. Multiple clusters can access a single SAN concurrently, however persistent volumes can only be attached by one consumer at a time.
 
@@ -190,8 +190,10 @@ az aks update -n <cluster-name> -g <resource-group> --disable-azure-container-st
 
 ## Next step
 
-To create persistent volumes, select the link for the backing storage type you selected.
+To create volumes, select the link for the backing storage type you selected.
 
-- [Create persistent volume claim with Azure managed disks](use-container-storage-with-managed-disks.md#3-create-a-persistent-volume-claim)
-- [Create persistent volume claim with Ephemeral Disk](use-container-storage-with-local-disk.md#create-a-persistent-volume-claim)
-- [Create persistent volume claim with Azure Elastic SAN](use-container-storage-with-elastic-san.md#3-create-a-persistent-volume-claim)
+- [Create persistent volume with Azure managed disks](use-container-storage-with-managed-disks.md#3-create-a-persistent-volume-claim)
+- [Create persistent volume with Azure Elastic SAN](use-container-storage-with-elastic-san.md#3-create-a-persistent-volume-claim)
+- [Create generic ephemeral volume with local NVMe](use-container-storage-with-local-disk.md#create-and-attach-generic-ephemeral-volumes)
+- [Create generic ephemeral volume with temp SSD](use-container-storage-with-temp-ssd.md#create-and-attach-generic-ephemeral-volumes)
+- [Create persistent volume with local NVMe and volume replication](use-container-storage-with-local-nvme-replication.md#create-and-attach-persistent-volumes)

articles/storage/container-storage/container-storage-introduction.md

@@ -77,7 +77,7 @@ Based on feedback from customers, we've included the following capabilities with
 - Scale up by dynamically expanding [volumes](resize-volume.md) and storage pools backed by Azure Disks and Ephemeral Disk without downtime.
 - [Clone persistent volumes](clone-volume.md) within a storage pool.
 - Optimize applications with Azure Linux Container Host.
-- Increase resiliency for applications using [local NVMe volumes with replication](use-container-storage-with-local-disk.md#create-storage-pool-with-volume-replication-nvme-only).
+- Increase resiliency for applications using [local NVMe volumes with replication](use-container-storage-with-local-nvme-replication.md).
 
 For more information on these features, email the Azure Container Storage team at [email protected].
 

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

@@ -223,8 +223,10 @@ Congratulations, you've successfully installed Azure Container Storage. You now
 
 ## Next step
 
-Now you can create a storage pool and persistent volume claim, and then deploy a pod and attach a persistent volume. Follow the steps in the appropriate how-to article.
+Now you can create a storage pool and volumes. Follow the steps in the appropriate article depending on the backing storage type you want to use.
 
-* [Use Azure Container Storage with Azure Elastic SAN](use-container-storage-with-elastic-san.md)
-* [Use Azure Container Storage with Azure Disks](use-container-storage-with-managed-disks.md)
-* [Use Azure Container Storage with Ephemeral Disk (local NVMe or temp SSD)](use-container-storage-with-local-disk.md)
+- [Use Azure managed disks](use-container-storage-with-managed-disks.md)
+- [Use Azure Elastic SAN](use-container-storage-with-elastic-san.md)
+- [Use local NVMe](use-container-storage-with-local-disk.md)
+- [Use temp SSD](use-container-storage-with-temp-ssd.md)
+- [Use local NVMe and volume replication](use-container-storage-with-local-nvme-replication.md)

articles/storage/container-storage/troubleshoot-container-storage.md

@@ -69,7 +69,7 @@ To resolve this, sign in to the [Azure portal](https://portal.azure.com?azure-po
 ### Can't create persistent volumes from ephemeral disk storage pools
 Because ephemeral disks (local NVMe and Temp SSD) are ephemeral and not durable, we enforce the use of [Kubernetes Generic Ephemeral Volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes). If you try to create a persistent volume claim using an ephemeral disk pool, you'll see the following error: *Error from server (Forbidden): error when creating "eph-pvc.yaml": admission webhook "pvc.acstor.azure.com" denied the request: only generic ephemeral volumes are allowed in unreplicated ephemeralDisk storage pools*.
 
-If you need a persistent volume, where the volume has a lifecycle independent of any individual pod that's using the volume, Azure Container Storage supports replication for NVMe. You can create a storage pool with replication and create persistent volumes from there. See [Create storage pool with volume replication](use-container-storage-with-local-disk.md#create-storage-pool-with-volume-replication-nvme-only) for guidance. Note that because ephemeral disk storage pools consume all the available NVMe disks, you must delete any existing ephemeral disk storage pools before creating a new storage pool with replication enabled. If you don't need persistence, you can create a generic ephemeral volume.
+If you need a persistent volume, where the volume has a lifecycle independent of any individual pod that's using the volume, Azure Container Storage supports replication for NVMe. You can create a storage pool with replication and create persistent volumes from there. See [Create storage pool with volume replication](use-container-storage-with-local-nvme-replication.md) for guidance. Note that because ephemeral disk storage pools consume all the available NVMe disks, you must delete any existing ephemeral disk storage pools before creating a new storage pool with replication enabled. If you don't need persistence, you can create a generic ephemeral volume.
 
 ## See also