Habilitación del almacenamiento persistente en Azure Spring Apps

Nota:

Los planes de Básico, Estándar y Enterprise quedarán en desuso a partir de mediados de marzo de 2025, con un período de retiro de 3 años. Se recomienda realizar la transición a Azure Container Apps. Para más información, consulte el anuncio de retirada de Azure Spring Apps.

El plan de consumo estándar y dedicado quedará obsoleto a partir del 30 de septiembre de 2024, con un cierre completo al cabo de seis meses. Se recomienda realizar la transición a Azure Container Apps. Para obtener más información, consulte Migrar el plan de consumo y dedicado Azure Spring Apps Standard a Azure Container Apps.

Este artículo se aplica a:✅ Java ✅ C#

Este artículo se aplica a:✅ Básico/Estándar ✅ Enterprise

En este artículo se explica cómo habilitar su propio almacenamiento persistente en Azure Spring Apps.

Cuando se usa el almacenamiento persistente integrado en Azure Spring Apps, los artefactos generados por la aplicación se cargan en las cuentas de Azure Storage. Microsoft controla las directivas de administración de la vigencia y el cifrado en reposo para esos artefactos.

Cuando usa su propio almacenamiento persistente, los artefactos generados por la aplicación se cargan en una cuenta de almacenamiento controlada por usted. Controlará la directiva de cifrado en reposo, la de administración de la duración y el acceso a la red. Será responsable de los costes asociados a esa cuenta de almacenamiento.

Requisitos previos

• Una cuenta de Azure Storage existente y un recurso compartido de archivos de Azure existente. Si necesita crear una cuenta de almacenamiento y un recurso compartido de archivos en Azure, consulte Creación de un recurso compartido de archivos de SMB de Azure.
• CLI de Azure, versión 2.45.0 o superior.

Importante

Si implementó Azure Spring Apps en su propia red virtual y quiere que solo se acceda a la cuenta de almacenamiento desde la red virtual, consulte Uso de puntos de conexión privados para Azure Storage y la sección Concesión de acceso desde una red virtual de Configuración de firewalls y redes virtuales de Azure Storage.

Montaje de su propio almacenamiento persistente adicional en las aplicaciones

Nota:

La actualización del almacenamiento persistente reinicia las aplicaciones.

Al usar la integración de red virtual, asegúrese de que los puertos 80 y 445 estén abiertos.

Azure Portal

Siga estos pasos para enlazar una cuenta de Azure Storage como un recurso de almacenamiento en el Azure Spring Apps y crear una aplicación con su propio almacenamiento persistente.

1. Vaya a la página Información general que hay en el servicio y seleccione Almacenamiento en el panel de navegación izquierdo.

2. En la página Almacenamiento, seleccione Agregar almacenamiento.

   

3. Escriba la siguiente información en la página Agregar almacenamiento y, después, seleccione Aplicar.

   Configuración	Valor
   Nombre de almacenamiento	El nombre del recurso de almacenamiento es un recurso de nivel de servicio en Azure Spring Apps.
   Nombre de cuenta	El nombre de la cuenta de almacenamiento.
   Clave de cuenta	La clave de la cuenta de almacenamiento.

   

4. Vaya a la página Aplicaciones y seleccione una aplicación para montar el almacenamiento persistente.

   

5. Seleccione Configuración y después seleccione Almacenamiento persistente.

6. Seleccione Agregar almacenamiento persistente. Agregue los valores de la tabla siguiente y después seleccione Aplicar.

   Configuración	Valor
   Nombre de almacenamiento	Nombre del recurso de almacenamiento que escribió anteriormente.
   Tipo de almacenamiento persistente	AzureFileVolume
   Nombre del recurso compartido	Nombre del recurso compartido de archivos Azure en la cuenta de Azure Storage.
   Ruta de acceso de montaje	Ruta de acceso de montaje única.
   Opciones de montaje	Opcionales
   Solo lectura	Opcionales

   

7. Seleccione Guardar para aplicar los cambios en la configuración.

   

CLI de Azure

Use los pasos siguientes para habilitar su propio almacenamiento con la CLI de Azure.

1. Use el siguiente comando para enlazar la cuenta de Azure Storage como un recurso de almacenamiento en la instancia de Azure Spring Apps.

   az spring storage add \
      --resource-group <resource-group-name> \
      --service <Azure-Spring-Apps-instance-name> \
      --name <storage-resource-name> \
      --storage-type StorageAccount \
      --account-name <account-name> \
      --account-key <account-key>
   

2. Use el siguiente comando para crear una aplicación con su propio almacenamiento persistente.

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --persistent-storage <path-to-JSON-file>
   

   En el ejemplo siguiente se muestra un archivo JSON que se pasa al parámetro --persistent-storage.

   {
      "customPersistentDisks": [
         {
             "storageName": "<storage-resource-name>",
             "customPersistentDiskProperties": {
                 "type": "AzureFileVolume",
                 "shareName": "<Azure-file-share-name>",
                 "mountPath": "<unique-mount-path>",
                 "mountOptions": [
                     "uid=0",
                     "gid=0"
                  ],
                  "readOnly": false
               }
         },
         {
             "storageName": "<storage-resource-name>",
             "customPersistentDiskProperties": {
                 "type": "AzureFileVolume",
                 "shareName": "<Azure-file-share-name>",
                 "mountPath": "<unique-mount-path>",
                 "readOnly": true
             }
         }
      ]
   }
   

3. Tiene la opción de usar este comando para agregar almacenamiento persistente adicional a una aplicación existente.

   az spring app append-persistent-storage \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --persistent-storage-type AzureFileVolume \
       --share-name <Azure-file-share-name> \
       --mount-path <unique-mount-path> \
       --storage-name <storage-resource-name>
   

4. Puede optar por usar el siguiente comando para enumerar el almacenamiento persistente que ya esté en un recurso de almacenamiento específico.

   az spring storage list-persistent-storage \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <storage-resource-name>
   

procedimientos recomendados

Use los siguientes procedimientos recomendados al agregar su propio almacenamiento persistente a Azure Spring Apps.

• Para evitar posibles problemas de latencia, coloque la instancia de Azure Spring Apps y la cuenta de Azure Storage en la misma región de Azure.

• En la cuenta de Azure Storage, evite volver a generar la clave de cuenta que se está utilizando. La cuenta de almacenamiento contiene dos claves diferentes. Use un enfoque paso a paso para asegurarse de que el almacenamiento persistente sigue estando disponible para las aplicaciones durante la regeneración de claves.

  Por ejemplo, siga estos pasos para asegurarse de que el almacenamiento persistente sigue estando disponible si usó key1 para enlazar una cuenta de almacenamiento a Azure Spring Apps.

  1. Vuelva a generar key2.
  2. Actualice la clave de cuenta del recurso de almacenamiento para usar la clave regenerada key2.
  3. Reinicie las aplicaciones que montan el almacenamiento persistente desde este recurso de almacenamiento. Use el comando az spring storage list-persistent-storage para enumerar todas las aplicaciones relacionadas.
  4. Vuelva a generar key1.

• Si elimina una cuenta de Azure Storage o un recurso compartido de archivos de Azure, quite el recurso de almacenamiento correspondiente o el almacenamiento persistente de las aplicaciones para evitar posibles errores.

• Si desea escribir archivos en la misma ruta de acceso para cada instancia de aplicación individual, pero mantenerlos en subdirectorios independientes desde la perspectiva del recurso compartido de archivos, puede usar la opción SubPath. Tenga en cuenta que la opción SubPath no es compatible con Solo lectura porque SubPath se usa para escribir nuevos archivos y Solo lectura se usa para leer archivos existentes.

Preguntas más frecuentes

En esta sección se responde a las preguntas más frecuentes sobre el uso de su propio almacenamiento persistente con Azure Spring Apps.

• Si tengo habilitado el almacenamiento persistente integrado y después he habilitado mi propio almacenamiento como almacenamiento persistente adicional, ¿se migran mis datos a mi cuenta de Azure Storage?

  No. Pero vamos a proporcionar un documento que le ayudará a realizar la migración usted mismo pronto.

• ¿Cuáles son las rutas de montaje reservadas?

  Azure Spring Apps reserva las siguientes rutas de montaje:

  • /tmp
  • /persistent
  • /secrets
  • /app-insights/agents
  • /etc/azure-spring-cloud/certs
  • /app-insights/agents/settings
  • /app-lifecycle/settings

• ¿Cuáles son las opciones de montaje disponibles?

  Actualmente se admiten las siguientes opciones de montaje:

  • uid
  • gid
  • file_mode
  • dir_mode

  La propiedad mountOptions es opcional. Los valores predeterminados para estas opciones de montaje son: ["uid=0", "gid=0", "file_mode=0777", "dir_mode=0777"]

• Estoy usando el punto de conexión de servicio para configurar la cuenta de almacenamiento para permitir el acceso solo desde mi propia red virtual. ¿Por qué me ha salido el error Permiso denegado al intentar montar el almacenamiento persistente personalizado en mis aplicaciones?

  Un punto de conexión de servicio solo proporciona acceso a la red en un nivel de subred. Asegúrese de que ha agregado ambas subredes usadas por la instancia de Azure Spring Apps al ámbito del punto de conexión de servicio.

Pasos siguientes

• Cómo usar Logback para escribir registros en el almacenamiento persistente personalizado.
• Escalado de una aplicación en Azure Spring Apps.