Almacenamiento de archivos persistente para aplicaciones alojadas

Conserve los archivos de aplicación en los reinicios y los nuevos despliegues de contenedor con File Storage gestionado por servicio en OCI Generative AI.

Asocie el almacenamiento de archivos a una aplicación alojada y especifique una ruta de contenedor absoluta donde el servicio lo monte. Los archivos escritos en esa ruta permanecen disponibles en los reinicios y los nuevos despliegues. Utilice archivos persistentes para artefactos de modelo, resultados intermedios, puntos de control y estado de aplicación que la carga de trabajo necesita en estos eventos.

Cada aplicación recibe un sistema de archivos independiente, incluso cuando las aplicaciones utilizan el mismo recurso de almacenamiento gestionado. La reutilización de una configuración de almacenamiento no comparte archivos entre aplicaciones. Las aplicaciones acceden a sus propios archivos a través de la ruta de montaje configurada.

Importante

El almacenamiento de archivos persistente admite una réplica en esta versión. Defina los recuentos de réplicas mínimo y máximo de la aplicación en 1.
  • Una aplicación puede tener un montaje de almacenamiento de archivos y un recurso de almacenamiento asociado de cada tipo de almacenamiento.
  • Cada asociación de almacenamiento de archivos tiene una cuota fija de 50 GB (50 000 000 000 bytes).
  • Debe especificar la ruta de montaje al crear la aplicación. No puede cambiarlo después.
  • Los archivos escritos fuera de la ruta de montaje no ganan persistencia de esta asociación. Utilice /tmp para los archivos temporales.

Puede configurar el almacenamiento de archivos mediante la consola o la API de IA generativa. Para el flujo de trabajo de la consola, consulte Almacenamiento.

Selección de una ruta de montaje

La ruta de montaje recomendada es /mnt/persistent/data. Puede especificar otra ruta válida, como /data, /app/storage o /mount. Configure la aplicación para que lea y escriba archivos persistentes en la ruta de acceso seleccionada.

La ruta debe cumplir los siguientes requisitos:

  • Utilice una ruta de acceso absoluta en formato canónico UTF-8, con un máximo de 4.096 bytes en total y 255 bytes por componente de ruta.
  • No incluya componentes vacíos, componentes . o .., caracteres de control ni una barra final.
  • No utilice la ruta raíz (/) ni una ruta que se superponga con otro montaje de volumen de contenedor.
  • No utilice una ruta que se superponga con un directorio de sistema reservado o un montaje de plataforma.

Las siguientes rutas están reservadas:

  • /bin, /boot, /dev, /etc, /lib, /lib64, /proc, /sbin y /sys
  • /run, /tmp y /var/run
  • /usr/bin, /usr/sbin, /usr/lib y /usr/lib64
  • /usr/local/bin, /usr/local/sbin, /usr/local/lib y /usr/local/lib64

File Storage requiere una ruta de montaje explícita. Las rutas de montaje generadas y la configuración environmentVariableKey no están soportadas para este tipo de almacenamiento.

Creación de almacenamiento de archivos con la API

Asegúrese de tener permiso para crear aplicaciones alojadas y de almacenamiento gestionado. Consulte Permisos de nivel de API para el almacenamiento de aplicaciones y Permisos para desplegar aplicaciones.

Configure la aplicación con recuentos de réplicas mínimos y máximos de 1. El almacenamiento de archivos persistente admite una réplica en esta versión.

Utilice la API del plano de control de IA generativa para crear un recurso de almacenamiento gestionado y, a continuación, haga referencia a él en la configuración de almacenamiento de la aplicación.

  1. Cree el recurso de almacenamiento con CreateHostedApplicationStorage.

    Envíe una solicitud POST a /20231130/hostedApplicationStorages con un cuerpo de solicitud CreateHostedApplicationStorageDetails. Proporcione el OCID del compartimento, un nombre mostrado y FILE_STORAGE como tipo de almacenamiento.

    {
      "compartmentId": "<compartment-ocid>",
      "displayName": "application-files",
      "storageType": "FILE_STORAGE"
    }

    También puede proporcionar una descripción opcional, etiquetas definidas y etiquetas de formato libre.

  2. Registre el OCID del recurso HostedApplicationStorage creado. Si utiliza el almacenamiento de archivos existente, utilice el OCID del recurso de almacenamiento gestionado.
  3. Incluya una entrada de File Storage en storageConfigs al crear la aplicación alojada.

    En la entrada StorageConfig, defina storageId en el OCID del recurso de almacenamiento gestionado y mountPath en la ruta de contenedor seleccionada. Omita environmentVariableKey.

    El siguiente fragmento muestra solo la configuración de anexo. Incluya las otras propiedades necesarias para la operación de creación de aplicaciones que utilice.

    {
      "storageConfigs": [
        {
          "storageId": "<hosted-application-storage-ocid>",
          "mountPath": "/mnt/persistent/data"
        }
      ]
    }

    La aplicación admite hasta cuatro configuraciones de almacenamiento, con una asociación por tipo de almacenamiento. Para el almacenamiento en caché, PostgreSQL y ADB, proporcione environmentVariableKey y omita mountPath.

  4. Compruebe que la aplicación ha devuelto storageConfigs[].fileStorageDetails.mountState antes de utilizar el montaje.

    READY significa que la revisión de la aplicación activa puede utilizar la ruta de montaje configurada. Consulte Comprobación del estado de los anexos.

Comprobando estado de anexo

La entrada storageConfigs de la aplicación incluye fileStorageDetails con el estado de anexo. Consulte FileStorageDetails en la referencia de API. Estos campos indican el estado gestionado por el servicio.

Estado de anexo de File Storage
CampoDescripción
mountStateREADY significa que el servicio ha conciliado la asociación y que la revisión de la aplicación activa puede utilizar la ruta de montaje configurada. Otros valores son CREATING, NEEDS_ATTENTION, DELETING, DELETED y FAILED. En estos estados, la asociación no se vuelve al almacenamiento local ni a un montaje NFS directo.
lifecycleDetailsCuando se proporciona, describe un fallo de montaje o asociación y la acción que puede realizar.
quotaLimitInGigabytesLa cuota de asociación fija de 50 GB.

Comprobación del uso de almacenamiento

Utilice los campos de uso de fileStorageDetails para revisar el consumo observado más recientemente. Los valores de uso son consultivos. El almacenamiento de archivos aplica la cuota fija.

Uso de almacenamiento de archivos
CampoDescripción
usageStateCURRENT indica un ejemplo actual. STALE indica un ejemplo anterior al destino de frescura del servicio. UNAVAILABLE indica que no hay ninguna muestra de uso disponible.
usageInBytesUso observado más recientemente en bytes.
usagePercentageEl porcentaje más reciente observado de la cuota de 50 GB en uso.
timeUsageObservedLa hora de la observación de uso, en formato RFC 3339.

Los valores de uso y el tiempo de observación se devuelven solo cuando usageState es CURRENT o STALE. Cuando es UNAVAILABLE, estos campos se omiten. Los valores que faltan no significan que no haya almacenamiento en uso.