Uso de montajes de almacenamiento en Azure Container Apps

Al configurar un almacenamiento con ámbito de réplica mediante la CLI de Azure, debe usar una definición de YAML para crear o actualizar la aplicación de contenedor.

1. Para actualizar una aplicación de contenedor existente de modo que use el almacenamiento con ámbito de réplica, exporte la especificación de la aplicación a un archivo YAML denominado app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

2. Realice los siguientes cambios en la especificación de la aplicación de contenedor.

   • Agregue una matriz volumes a la sección template de la definición de la aplicación de contenedor y defina un volumen. Si ya tiene una matriz de volumes, agregue un nuevo volumen a la matriz.
     • name es un identificador del volumen.
     • Use EmptyDir como storageType.
   • Para cada contenedor de la plantilla en el que desee montar el volumen, defina un montaje de volumen en la matriz volumeMounts de la definición del contenedor.
     • volumeName es el nombre definido en la matriz volumes.
     • mountPath es la ruta de acceso del contenedor en el que se va a montar el volumen.

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
       activeRevisionsMode: Single
     template:
       containers:
       - image: <IMAGE_NAME1>
         name: my-container-1
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       - image: <IMAGE_NAME_2>
         name: my-container-2
         volumeMounts:
         - mountPath: /myempty
           volumeName: myempty
       volumes:
       - name: myempty
         storageType: EmptyDir
   

3. Actualice la aplicación de contenedor mediante el archivo YAML.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Consulte la especificación de YAML para ver un ejemplo completo.

Para crear un volumen con ámbito de réplica y montarlo en un contenedor, realice los siguientes cambios en el recurso de aplicaciones de contenedor de una plantilla de ARM:

• Agregue una matriz volumes a la sección template de la definición de la aplicación de contenedor y defina un volumen. Si ya tiene una matriz de volumes, agregue un nuevo volumen a la matriz.
  • name es un identificador del volumen.
  • Use EmptyDir como storageType.
• Para cada contenedor de la plantilla en el que desee montar el volumen, defina un montaje de volumen en la matriz volumeMounts de la definición del contenedor.
  • volumeName es el nombre definido en la matriz volumes.
  • mountPath es la ruta de acceso del contenedor en el que se va a montar el volumen.

Ejemplo de fragmento de código de plantilla de ARM:

{
  "apiVersion": "2022-03-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        },
        {
          "name": "sidecar",
          "image": "[parameters('sidecar_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "myempty",
          "storageType": "EmptyDir"
        }
      ]
    }
  }
}

Consulte la especificación de API de la plantilla de ARM para obtener un ejemplo completo.

Para crear un volumen con ámbito de réplica y montarlo en un contenedor, implemente una nueva revisión de la aplicación de contenedor mediante Azure Portal.

1. Vaya a la aplicación de contenedor en Azure Portal.

2. Seleccione Administración de revisiones en el menú izquierdo.

3. Seleccione Crear nueva revisión.

4. Seleccione el contenedor en el que desea montar el volumen.

5. En el panel de contexto Editar un contenedor, seleccione la pestaña Montajes de volúmenes.

6. En la sección Almacenamiento efímero, cree un nuevo volumen con la siguiente información.

   • Nombre del volumen: nombre del volumen efímero.
   • Ruta de acceso de montaje: ruta de acceso absoluta del contenedor para montar el volumen.

7. Seleccione Guardar para guardar los cambios y salir del panel de contexto.

8. Seleccione Crear para crear la nueva revisión.

Al configurar una aplicación contenedora para montar un volumen de Azure Files mediante la CLI de Azure, debe usar una definición de YAML para crear o actualizar la aplicación de contenedor.

Para ver un tutorial paso a paso sobre cómo montar un recurso compartido de archivos SMB, consulte Cómo crear un montaje de volumen Azure Files en Azure Container Apps.

1. Agregue una definición de almacenamiento en el entorno de Container Apps.

   • SMB
   • NFS

   az containerapp env storage set --name my-env --resource-group my-group \
       --storage-name mystorage \
       --storage-type AzureFile \
       --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
       --azure-file-account-key <STORAGE_ACCOUNT_KEY> \
       --azure-file-share-name <STORAGE_SHARE_NAME> \
       --access-mode ReadWrite
   

   Reemplace <STORAGE_ACCOUNT_NAME> y <STORAGE_ACCOUNT_KEY> por el nombre y la clave de su cuenta de almacenamiento. Reemplace <STORAGE_SHARE_NAME> por el nombre del recurso compartido de archivos de la cuenta de almacenamiento.

   Los valores válidos para --access-mode son ReadWrite y ReadOnly.

2. Para actualizar una aplicación de contenedor existente para que monte un recurso compartido de archivos, exporte la especificación de la aplicación a un archivo YAML denominado app.yaml.

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

3. Realice los siguientes cambios en la especificación de la aplicación de contenedor.

   • Agregue una matriz volumes a la sección template de la definición de la aplicación de contenedor y defina un volumen. Si ya tiene una matriz de volumes, agregue un nuevo volumen a la matriz.
     • name es un identificador del volumen.
     • Para storageType, use AzureFile para SMB o NfsAzureFile para NFS. Este valor debe coincidir con el tipo de almacenamiento que definió en el entorno.
     • Para storageName, use el nombre del almacenamiento que definió en el entorno.
     • mountOptions es una cadena separada por comas de opciones de montaje. Para más información, consulte Uso de la configuración mountOptions en Azure Files.
     • La secrets lista es una lista de secretos que se van a montar en el volumen. Para obtener más información, consulte Secretos de montaje en un volumen.
   • Para cada contenedor de la plantilla en el que desee montar el almacenamiento de Azure Files, defina un montaje de volumen en la matriz volumeMounts de la definición del contenedor.
     • volumeName es el nombre definido en la matriz volumes.
     • mountPath es la ruta de acceso del contenedor en el que se va a montar el volumen.
     • subPath es la ruta de acceso del volumen que se va a montar. Si no se especifica, se monta la raíz del volumen. Para obtener más información, consulte (#sub-path).
   • SMB
   • NFS

   properties:
     managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
     configuration:
     template:
       containers:
       - image: <IMAGE_NAME>
         name: my-container
         volumeMounts:
         - volumeName: azure-files-volume
           mountPath: /my-files
           subPath: my-sub-path
       volumes:
       - name: azure-files-volume
         storageType: AzureFile
         storageName: mystorage
   

4. Actualice la aplicación de contenedor mediante el archivo YAML.

   az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
       --yaml app.yaml
   

Consulte la especificación de YAML para ver un ejemplo completo.

Los siguientes fragmentos de código de la plantilla de ARM muestran cómo agregar un recurso compartido de archivos de Azure Files a un entorno de Container Apps y su utilización en una aplicación de contenedor.

1. Agregue un recurso secundario storages al entorno de Container Apps.

   • SMB
   • NFS

   {
     "type": "Microsoft.App/managedEnvironments",
     "apiVersion": "2022-03-01",
     "name": "[parameters('environment_name')]",
     "location": "[parameters('location')]",
     "properties": {
       "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
       "appLogsConfiguration": {
         "destination": "log-analytics",
         "logAnalyticsConfiguration": {
           "customerId": "[parameters('log_analytics_customer_id')]",
           "sharedKey": "[parameters('log_analytics_shared_key')]"
         }
       }
     },
     "resources": [
       {
         "type": "storages",
         "name": "myazurefiles",
         "apiVersion": "2022-03-01",
         "dependsOn": [
           "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
         ],
         "properties": {
           "azureFile": {
             "accountName": "[parameters('storage_account_name')]",
             "accountKey": "[parameters('storage_account_key')]",
             "shareName": "[parameters('storage_share_name')]",
             "accessMode": "ReadWrite"
           }
         }
       }
     ]
   }
   

2. Actualice el recurso de la aplicación de contenedor para que agregue un volumen y un montaje de volumen.

   • SMB
   • NFS

   {
     "apiVersion": "2023-05-01",
     "type": "Microsoft.App/containerApps",
     "name": "[parameters('containerappName')]",
     "location": "[parameters('location')]",
     "properties": {
   
       ...
   
       "template": {
         "revisionSuffix": "myrevision",
         "containers": [
           {
             "name": "main",
             "image": "[parameters('container_image')]",
             "resources": {
               "cpu": 0.5,
               "memory": "1Gi"
             },
             "volumeMounts": [
               {
                 "mountPath": "/myfiles",
                 "volumeName": "azure-files-volume",
                 "subPath": "my-sub-path"
               }
             ]
           }
         ],
         "scale": {
           "minReplicas": 1,
           "maxReplicas": 3
         },
         "volumes": [
           {
             "name": "azure-files-volume",
             "storageType": "AzureFile",
             "storageName": "myazurefiles"
           }
         ]
       }
     }
   }
   

   • Agregue una matriz volumes a la sección template de la definición de la aplicación de contenedor y defina un volumen. Si ya tiene una matriz de volumes, agregue un nuevo volumen a la matriz.
     • name es un identificador del volumen.
     • Para storageType, use AzureFile para SMB o NfsAzureFile para NFS. Este valor debe coincidir con el tipo de almacenamiento que definió en el entorno.
     • Para storageName, use el nombre del almacenamiento que definió en el entorno.
     • mountOptions es una cadena separada por comas de opciones de montaje. Para más información, consulte Uso de la configuración mountOptions en Azure Files.
     • La secrets lista es una lista de secretos que se van a montar en el volumen. Para obtener más información, consulte Secretos de montaje en un volumen.
   • Para cada contenedor de la plantilla en el que desee montar el almacenamiento de Azure Files, defina un montaje de volumen en la matriz volumeMounts de la definición del contenedor.
     • volumeName es el nombre definido en la matriz volumes.
     • mountPath es la ruta de acceso del contenedor en el que se va a montar el volumen.
     • subPath (opcional) es la ruta de acceso del volumen que se va a montar. Si no se especifica, se monta la raíz del volumen. Para obtener más información, consulte (#sub-path).

Consulte la especificación de API de la plantilla de ARM para obtener un ejemplo completo.

Para configurar un montaje de volumen para el almacenamiento de Azure Files en Azure Portal, agregue un recurso compartido de archivos al entorno de Container Apps y, luego, agregue un montaje de volumen a la aplicación de contenedor mediante la creación de una nueva revisión.

1. En Azure Portal, vaya al entorno de Container App.

2. En el panel de navegación, en Configuración, seleccione Azure Files.

3. Seleccione Agregar.

4. Seleccione Bloque de mensajes del servidor (SMB) o Network File System (NFS), en función del protocolo usado por el recurso compartido de archivos.

5. En el panel de contexto Agregar recurso compartido de archivos, escriba la siguiente información:

   • SMB
   • NFS

   • Nombre: nombre del recurso compartido de archivos.
   • Nombre de la cuenta de almacenamiento: nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos.
   • Clave de la cuenta de almacenamiento: clave de acceso de la cuenta de almacenamiento.
   • Recurso compartido de archivos: nombre del recurso compartido de archivos.
   • Modo de acceso: modo de acceso del recurso compartido de archivos. Los valores válidos son Lectura y escritura y Solo lectura.

6. Seleccione Agregar para salir del panel de contexto.

7. Haga clic en Guardar para confirmar los cambios.

8. Vaya a la aplicación de contenedor.

9. En el panel de navegación, en Aplicación, seleccione Revisiones y réplicas.

10. Seleccione Crear nueva revisión.

11. En la página Crear e implementar una nueva revisión, seleccione la pestaña Volúmenes.

12. Seleccione Agregar.

13. En el panel de contexto Agregar volumen, establezca lo siguiente.

    • Tipo de volumen: volumen de archivos de Azure.
    • Nombre: escriba un nombre de volumen.
    • Nombre del recurso compartido de archivos: seleccione el recurso compartido de archivos que creó anteriormente.
    • Opciones de montaje: opcionalmente, escriba una cadena separada por comas de opciones de montaje. Para más información, consulte Uso de la configuración mountOptions en Azure Files.

14. Seleccione Agregar para salir del panel de contexto.

15. En la página Crear e implementar una nueva revisión, seleccione la pestaña Contenedor.

16. Seleccione el contenedor en el que desea montar el volumen.

17. En el panel de contexto Editar un contenedor, seleccione la pestaña Montajes de volúmenes.

18. En Nombre del volumen, seleccione el volumen que creó anteriormente.

19. En Ruta de acceso de montaje, escriba la ruta de acceso absoluta del contenedor para montar el volumen.

20. En Ruta de acceso secundaria (opcional), escriba la ruta de acceso en el volumen que se va a montar. Si no se especifica, se monta la raíz del volumen. Para obtener más información, consulte (#sub-path).

21. Seleccione Guardar para guardar los cambios y salir del panel de contexto.

22. Seleccione Crear para crear la nueva revisión.