Merge pull request #125940 from v-jaswel/aca/v-jaswel_work_item_371940_20250226

[ACA] [371940] Add subPath documentation.

Author: v-dirichards

articles/container-apps/storage-mounts-azure-files.md

@@ -6,7 +6,7 @@ author: craigshoemaker
 ms.service: azure-container-apps
 ms.custom: devx-track-azurecli
 ms.topic: tutorial
-ms.date: 02/03/2025
+ms.date: 03/20/2025
 ms.author: cshoe
 ---
 
@@ -438,30 +438,35 @@ Now you can update the container app configuration to support the storage mount.
 
 1. Open *app.yaml* in a code editor.
 
-1. Replace the `volumes: null` definition in the `template` section with a `volumes:` definition referencing the storage volume.  The template section should look like the following:
+1. Replace the `volumes: null` definition in the `template` section with a `volumes:` definition referencing the storage volume. The template section should look like the following:
 
     ```yml
     template:
-      volumes:
-      - name: my-azure-file-volume
-        storageName: mystoragemount
-        storageType: AzureFile
       containers:
       - image: nginx
+        imageType: ContainerImage
         name: my-container-app
-        volumeMounts:
-        - volumeName: my-azure-file-volume
-          mountPath: /var/log/nginx
         resources:
           cpu: 0.5
-          ephemeralStorage: 3Gi
+          ephemeralStorage: 2Gi
           memory: 1Gi
+        volumeMounts:
+        - volumeName: my-azure-file-volume
+          mountPath: /var/log/nginx
       initContainers: null
       revisionSuffix: ''
       scale:
+        cooldownPeriod: 300
         maxReplicas: 1
         minReplicas: 1
+        pollingInterval: 30
         rules: null
+      serviceBinds: null
+      terminationGracePeriodSeconds: null
+      volumes:
+      - name: my-azure-file-volume
+        storageName: mystoragemount
+        storageType: AzureFile
     ```
 
     The new `template.volumes` section includes the following properties.
@@ -540,78 +545,38 @@ Now that the storage mount is established, you can manipulate files in Azure Sto
 
     ---
 
-    This command may take a moment to open the remote shell. Once the shell is ready, you can interact with the storage mount via file system commands.
+    This command may take a moment to open the remote shell. Once the shell is ready, you can interact with the storage mount via file system commands. For more information see [Connect to a container console in Azure Container Apps](/azure/container-apps/container-console).
 
 1. Change into the nginx */var/log/nginx* folder.
 
-    # [Bash](#tab/bash)
-
-    ```bash
-    cd /var/log/nginx
-    ```
-
-    # [PowerShell](#tab/powershell)
-
-    ```powershell
+    ```sh
     cd /var/log/nginx
     ```
 
-    ---
-
 1. Return to the browser and navigate to the website and refresh the page a few times.
 
     The requests made to the website create a series of log stream entries.
 
 1. Return to your terminal and list the values of the `/var/log/nginx` folder.
 
-    # [Bash](#tab/bash)
-
-    ```bash
+    ```sh
     ls
     ```
 
-    # [PowerShell](#tab/powershell)
-
-    ```powershell
-    ls
-    ```
-
-    ---
-
     Note how the *access.log* and *error.log* files appear in this folder. These files are written to the Azure Files mount in your Azure Storage share created in the previous steps.
 
 1. View the contents of the *access.log* file.
 
-    # [Bash](#tab/bash)
-
-    ```bash
+    ```sh
     cat access.log
     ```
 
-    # [PowerShell](#tab/powershell)
-
-    ```powershell
-    type access.log
-    ```
-
-    ---
-
 1. Exit out of the container's interactive shell to return to your local terminal session.
 
-    # [Bash](#tab/bash)
-
-    ```bash
-    exit
-    ```
-
-    # [PowerShell](#tab/powershell)
-
-    ```powershell
+    ```sh
     exit
     ```
 
-    ---
-
 1. Now, you can view the files in the Azure portal to verify they exist in your Azure Storage account. Print the name of your randomly generated storage account.
 
     # [Bash](#tab/bash)

articles/container-apps/storage-mounts.md

@@ -6,7 +6,7 @@ author: craigshoemaker
 ms.service: azure-container-apps
 ms.custom: devx-track-azurecli
 ms.topic: conceptual
-ms.date: 02/25/2025
+ms.date: 03/20/2025
 ms.author: cshoe
 zone_pivot_groups: arm-azure-cli-portal
 ---
@@ -326,7 +326,7 @@ For a step-by-step tutorial on mounting an SMB file share, refer to [Create an A
     - For each container in the template that you want to mount Azure Files storage, define a volume mount in the `volumeMounts` array of the container definition.
         - The `volumeName` is the name defined in the `volumes` array.
         - The `mountPath` is the path in the container to mount the volume.
-        - The `subPath` (optional) is the path in the volume to mount. If not specified, the volume root is mounted. For more information see [using subPath](https://kubernetes.io/docs/concepts/storage/volumes/#using-subpath).
+        - The `subPath` is the path in the volume to mount. If not specified, the volume root is mounted. For more information see (#sub-path).
 
     # [SMB](#tab/smb)
 
@@ -586,7 +586,7 @@ The following ARM template snippets demonstrate how to add an Azure Files share
     - For each container in the template that you want to mount Azure Files storage, define a volume mount in the `volumeMounts` array of the container definition.
         - The `volumeName` is the name defined in the `volumes` array.
         - The `mountPath` is the path in the container to mount the volume.
-        - The `subPath` (optional) is the path in the volume to mount. If not specified, the volume root is mounted. For more information see [using subPath](https://kubernetes.io/docs/concepts/storage/volumes/#using-subpath).
+        - The `subPath` (optional) is the path in the volume to mount. If not specified, the volume root is mounted. For more information see (#sub-path).
 
 See the [ARM template API specification](azure-resource-manager-api-spec.md) for a full example.
 
@@ -656,10 +656,36 @@ To configure a volume mount for Azure Files storage in the Azure portal, add a f
 
 1. In **Mount path**, enter the absolute path in the container to mount the volume.
 
-1. In **Sub path (optional)**, enter the path in the volume to mount. If not specified, the volume root is mounted. For more information see [using subPath](https://kubernetes.io/docs/concepts/storage/volumes/#using-subpath).
+1. In **Sub path (optional)**, enter the path in the volume to mount. If not specified, the volume root is mounted. For more information see (#sub-path).
 
 1. Select **Save** to save changes and exit the context pane.
 
 1. Select **Create** to create the new revision.
 
 ::: zone-end
+
+### Sub path
+
+When mounting a file share from Azure Files, in addition to the mount path, you can also specify a sub path.
+
+- **Mount path**: The path in the container where you want to mount the volume.
+- **Sub path**: The path in the volume you want to mount.
+
+The sub path is optional. If not specified, the volume root is mounted.
+
+The sub path is a relative path from the volume root. The sub path should not start with `/`. Specifying a sub path that starts with `/` might prevent your container app from starting up. For example, `my-volume-folder` is a valid sub path, where `/my-volume-folder` is not.
+
+The sub path can refer to either a folder or a file in the volume.
+
+- If the sub path refers to a folder, the mount path should refer to an empty folder in the container.
+
+- If the sub path refers to a file, the mount path should refer to a file that does not already exist in the container.
+
+    For example, suppose the sub path is `my-volume-folder/my-volume-file.txt`, and the mount path is `/my-container-folder/my-container-file`. The folder `/my-container-folder` should already exist in the container but should not yet contain the file `my-container-file.txt`.
+
+Any sub path trailing slashes are ignored.
+
+## Related content
+
+- [Tutorial: Create an Azure Files volume mount in Azure Container Apps](storage-mounts-azure-files.md)
+- [Using subPath](https://kubernetes.io/docs/concepts/storage/volumes/#using-subpath)