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.
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
/tmppara 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,/sbiny/sys/run,/tmpy/var/run/usr/bin,/usr/sbin,/usr/liby/usr/lib64/usr/local/bin,/usr/local/sbin,/usr/local/liby/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.
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.
| Campo | Descripción |
|---|---|
mountState | READY 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. |
lifecycleDetails | Cuando se proporciona, describe un fallo de montaje o asociación y la acción que puede realizar. |
quotaLimitInGigabytes | La 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.
| Campo | Descripción |
|---|---|
usageState | CURRENT 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. |
usageInBytes | Uso observado más recientemente en bytes. |
usagePercentage | El porcentaje más reciente observado de la cuota de 50 GB en uso. |
timeUsageObserved | La 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.