Merge pull request #278794 from khdownie/kendownie062024

ephemeral disk guidance

Author: prmerger-automator[bot]

articles/storage/container-storage/index.yml

@@ -10,7 +10,7 @@ metadata:
   ms.topic: landing-page # Required
   author: khdownie #Required; your GitHub user alias, with correct capitalization.
   ms.author: kendownie #Required; microsoft alias of author; optional team alias.
-  ms.date: 03/05/2024
+  ms.date: 06/20/2024
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
 
@@ -39,14 +39,16 @@ landingContent:
     linkLists:
       - linkListType: how-to-guide
         links:
-          - text: Install Azure Container Storage
-            url: install-container-storage-aks.md
           - text: Use Azure Container Storage with Azure Disks
             url: use-container-storage-with-managed-disks.md
-          - text: Use Azure Container Storage with Ephemeral Disk
-            url: use-container-storage-with-local-disk.md
           - text: Use Azure Container Storage with Azure Elastic SAN
             url: use-container-storage-with-elastic-san.md
+          - text: Use Azure Container Storage with local NVMe
+            url: use-container-storage-with-local-disk.md
+          - text: Use Azure Container Storage with local NVMe replication
+            url: use-container-storage-with-local-nvme-replication.md
+          - text: Use Azure Container Storage with temp SSD
+            url: use-container-storage-with-temp-ssd.md
 
 # Card (optional)
   - title: Frequently asked questions

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

@@ -1,10 +1,10 @@
 ---
 title: Install Azure Container Storage Preview with Azure Kubernetes Service (AKS)
-description: Learn how to install Azure Container Storage for use with Azure Kubernetes Service. Create an AKS cluster, label the node pool, and install the Azure Container Storage extension.
+description: Learn how to install Azure Container Storage for use with Azure Kubernetes Service. Create an AKS cluster, label the node pool, and install Azure Container Storage.
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: tutorial
-ms.date: 05/30/2024
+ms.date: 06/20/2024
 ms.author: kendownie
 ms.custom: devx-track-azurecli
 ---
@@ -110,7 +110,7 @@ To use Azure Container Storage, you'll need a node pool of at least three Linux
 
 If you intend to use Azure Elastic SAN or Azure Disks with Azure Container Storage, then you should choose a [general purpose VM type](../../virtual-machines/sizes-general.md) such as **standard_d4s_v5** for the cluster nodes.
 
-If you intend to use Ephemeral Disk, choose a [storage optimized VM type](../../virtual-machines/sizes-storage.md) such as **standard_l8s_v3**.
+If you intend to use Ephemeral Disk with local NVMe, choose a [storage optimized VM type](../../virtual-machines/sizes-storage.md) such as **standard_l8s_v3**. If you intend to use Ephemeral Disk with temp SSD, a [Ev3 and Esv3-series VM](../../virtual-machines/ev3-esv3-series.md) is required.
 
 > [!IMPORTANT]
 > You must choose a VM type that supports [Azure premium storage](../../virtual-machines/premium-storage-performance.md).

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

@@ -4,7 +4,7 @@ description: Configure Azure Container Storage for use with Ephemeral Disk using
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: how-to
-ms.date: 06/19/2024
+ms.date: 06/20/2024
 ms.author: kendownie
 ms.custom: references_regions
 ---
@@ -13,8 +13,11 @@ ms.custom: references_regions
 
 [Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. This article shows you how to configure Azure Container Storage to use Ephemeral Disk with local NVMe as back-end storage for your Kubernetes workloads. At the end, you'll have a pod that's using local NVMe as its storage.
 
-> [!IMPORTANT]
-> Local disks are ephemeral, meaning that they're created on the local virtual machine (VM) storage and not saved to an Azure storage service. Data will be lost on these disks if you stop/deallocate your VM. Therefore, you can only create [Kubernetes generic ephemeral volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes) from an Ephemeral Disk storage pool unless you [use local NVMe with volume replication](use-container-storage-with-local-nvme-replication.md).
+## What is Ephemeral Disk?
+
+When your application needs sub-millisecond storage latency and doesn't require data durability, you can use Ephemeral Disk 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 will be lost on these disks if you stop/deallocate your VM. Therefore, you can only create [Kubernetes generic ephemeral volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes) from an Ephemeral Disk storage pool unless you [use local NVMe with volume replication](use-container-storage-with-local-nvme-replication.md). Replication copies data across volumes on different nodes and restores a volume when a replica is lost, providing data durability.
+
+There are two types of Ephemeral Disk available: NVMe and [temp SSD](use-container-storage-with-temp-ssd.md). NVMe is designed for high-speed data transfer between storage and CPU. Choose NVMe when your application requires higher IOPS and throughput than temp SSD, or if your workload requires replication. Replication isn't currently supported for temp SSD.
 
 ## Prerequisites
 

articles/storage/container-storage/use-container-storage-with-local-nvme-replication.md

@@ -4,14 +4,20 @@ description: Configure Azure Container Storage for use with Ephemeral Disk using
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: how-to
-ms.date: 06/19/2024
+ms.date: 06/20/2024
 ms.author: kendownie
 ms.custom: references_regions
 ---
 
 # Use Azure Container Storage Preview with local NVMe and volume replication
 
-[Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. Applications that use local NVMe can leverage storage replication for improved resiliency. This article shows you how to configure Azure Container Storage to use Ephemeral Disk with local NVMe and volume replication as back-end storage for your Kubernetes workloads. At the end, you'll have a pod that's using local NVMe as its storage.
+[Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. This article shows you how to configure Azure Container Storage to use Ephemeral Disk with local NVMe and volume replication as back-end storage for your Kubernetes workloads. At the end, you'll have a pod that's using local NVMe as its storage. Replication copies data across volumes on different nodes and restores a volume when a replica is lost, providing data durability for Ephemeral Disk.
+
+## What is Ephemeral Disk?
+
+When your application needs sub-millisecond storage latency, you can use Ephemeral Disk 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 will be lost on these disks if you stop/deallocate your VM. Therefore, you can only create [Kubernetes generic ephemeral volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes) from an Ephemeral Disk storage pool unless you use local NVMe with volume replication as described in this article.
+
+There are two types of Ephemeral Disk available: NVMe and [temp SSD](use-container-storage-with-temp-ssd.md). NVMe is designed for high-speed data transfer between storage and CPU. Choose NVMe when your application requires higher IOPS and throughput than temp SSD, or if your workload requires replication. Replication isn't currently supported for temp SSD.
 
 ## Prerequisites
 

articles/storage/container-storage/use-container-storage-with-temp-ssd.md

@@ -4,7 +4,7 @@ description: Configure Azure Container Storage for use with Ephemeral Disk using
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: how-to
-ms.date: 06/19/2024
+ms.date: 06/20/2024
 ms.author: kendownie
 ms.custom: references_regions
 ---
@@ -13,8 +13,11 @@ ms.custom: references_regions
 
 [Azure Container Storage](container-storage-introduction.md) is a cloud-based volume management, deployment, and orchestration service built natively for containers. This article shows you how to configure Azure Container Storage to use Ephemeral Disk with temp SSD as back-end storage for your Kubernetes workloads. At the end, you'll have a pod that's using temp SSD as its storage.
 
-> [!IMPORTANT]
-> Local disks are ephemeral, meaning that they're created on the local virtual machine (VM) storage and not saved to an Azure storage service. Data will be lost on these disks if you stop/deallocate your VM. You can only create [Kubernetes generic ephemeral volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes) from a temp SSD storage pool. If you want to create a persistent volume using Ephemeral Disk, you have to [use local NVMe with volume replication](use-container-storage-with-local-nvme-replication.md).
+## What is Ephemeral Disk?
+
+When your application needs sub-millisecond storage latency and doesn't require data durability, you can use Ephemeral Disk 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 will be lost on these disks if you stop/deallocate your VM. Therefore, you can only create [Kubernetes generic ephemeral volumes](https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/#generic-ephemeral-volumes) from an Ephemeral Disk storage pool unless you [use local NVMe with volume replication](use-container-storage-with-local-nvme-replication.md). Replication copies data across volumes on different nodes and restores a volume when a replica is lost, providing data durability.
+
+There are two types of Ephemeral Disk available: [NVMe](use-container-storage-with-local-disk.md) and temp SSD. NVMe is designed for high-speed data transfer between storage and CPU. Choose NVMe when your application requires higher IOPS and throughput than temp SSD, or if your workload requires replication. Replication isn't currently supported for temp SSD.
 
 ## Prerequisites