Merge pull request #251964 from khdownie/kendownie091823

clone volume

Author: denrea

articles/storage/container-storage/TOC.yml

@@ -22,7 +22,9 @@
   - name: Use volume snapshot and restore
     href: volume-snapshot-restore.md
   - name: Expand a persistent volume
-    href: resize-volume.md    
+    href: resize-volume.md
+  - name: Clone a persistent volume
+    href: clone-volume.md       
   - name: Remove Azure Container Storage
     href: remove-container-storage.md
 - name: Concepts

articles/storage/container-storage/clone-volume.md

@@ -0,0 +1,106 @@
+---
+title: Clone persistent volumes in Azure Container Storage Preview
+description: Clone persistent volumes in Azure Container Storage Preview. You can only clone volumes of the same size that are in the same storage pool.
+author: khdownie
+ms.service: azure-container-storage
+ms.topic: how-to
+ms.date: 09/18/2023
+ms.author: kendownie
+---
+
+# Clone persistent volumes in Azure Container Storage Preview
+You can clone persistent volumes in [Azure Container Storage](container-storage-introduction.md). A cloned volume is a duplicate of an existing persistent volume. You can only clone volumes of the same size that are in the same storage pool.
+
+## Prerequisites
+
+- This article requires version 2.0.64 or later 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.
+- 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.md). Azure Elastic SAN Preview doesn't support resizing volumes.
+
+## Clone a volume
+
+Follow the instructions below to clone a persistent volume. 
+
+1. Use your favorite text editor to create a YAML manifest file such as `code acstor-clonevolume.yaml`.
+
+1. Paste in the following code and save the file. A built-in storage class supports volume cloning, so for **dataSource** be sure to reference a PVC previously created by the Azure Container Storage storage class. For example, if you created the PVC for Azure Disks, it might be called `azurediskpvc`. For **storage**, specify the size of the original PVC.
+
+   ```yml
+   apiVersion: v1
+   kind: PersistentVolumeClaim
+   metadata:
+     name: pvc-acstor-cloning
+   spec:
+     accessModes:
+       - ReadWriteOnce
+     storageClassName: acstor-azuredisk
+     resources:
+       requests:
+         storage: 100Gi
+     dataSource:
+       kind: PersistentVolumeClaim
+       name: azurediskpvc
+   ```
+
+1. Apply the YAML manifest file to clone the PVC.
+   
+   ```azurecli-interactive
+   kubectl apply -f acstor-clonevolume.yaml 
+   ```
+
+   You should see output similar to:
+   
+   ```output
+   persistentvolumeclaim/pvc-acstor-cloning created
+   ```
+
+1. Use your favorite text editor to create a YAML manifest file such as `code acstor-pod.yaml`.
+
+1. Paste in the following code and save the file. For **claimName**, be sure to reference the cloned PVC.
+
+   ```yml
+   kind: Pod
+   apiVersion: v1
+   metadata:
+     name: fiopod2
+   spec:
+     nodeSelector:
+       acstor.azure.com/io-engine: acstor
+     volumes:
+       - name: azurediskpv
+         persistentVolumeClaim:
+           claimName: pvc-acstor-cloning
+     containers:
+       - name: fio
+         image: nixery.dev/shell/fio
+         args:
+           - sleep
+           - "1000000"
+         volumeMounts:
+           - mountPath: "/volume"
+             name: azurediskpv
+   ```
+
+1. Apply the YAML manifest file to deploy the new pod.
+   
+   ```azurecli-interactive
+   kubectl apply -f acstor-pod.yaml
+   ```
+   
+   You should see output similar to the following:
+   
+   ```output
+   pod/fiopod2 created
+   ```
+
+1. Check that the pod is running and that the persistent volume claim has been bound successfully to the pod:
+
+   ```azurecli-interactive
+   kubectl describe pod fiopod2
+   kubectl describe pvc azurediskpvc
+   ```
+   
+
+## See also
+
+- [What is Azure Container Storage?](container-storage-introduction.md)

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

@@ -4,7 +4,7 @@ description: An overview of Azure Container Storage Preview, a service built nat
 author: khdownie
 ms.service: azure-container-storage
 ms.topic: overview
-ms.date: 09/07/2023
+ms.date: 09/18/2023
 ms.author: kendownie
 ms.custom: references_regions
 ---
@@ -51,8 +51,8 @@ Azure Container Storage offers persistent volume support with ReadWriteOnce acce
 
 Based on feedback from customers, we've included the following capabilities in the Azure Container Storage Preview update:
 
-- Scale up by resizing volumes backed by Azure Disks and NVMe storage pools without downtime
-- Clone persistent volumes within a storage pool
+- Scale up by [resizing volumes](resize-volume.md) backed by Azure Disks and NVMe storage pools without downtime
+- [Clone persistent volumes](clone-volume.md) within a storage pool
 
 For more information on these features, email the Azure Container Storage team at [email protected].