Filesystem Storage Backend

Configuración

Cuando creas un nuevo backend, debes especificar lo siguiente:

• El nombre del backend. Este es el nombre que se utilizará para identificar el backend en Odoo
• El código del backend. Este código identificará el backend en el campo store_fname del modelo ir.attachment. Este código debe ser único. Se utilizará como scheme. ejemplo del campo store_fname: odoofs://abs34Tg11.
• El protocolo utilizado por el backend. El protocolo se refiere a los protocolos soportados del paquete python fsspec.
• Una ruta de directorio. Este es un directorio raíz desde el cual se montará el filesystem. Este directorio debe existir.
• Las opciones del protocolo. Estas son las opciones que se pasarán al paquete python fsspec al crear el filesystem. Estas opciones dependen del protocolo utilizado y se describen en la documentación de fsspec.
• Resolve env vars. Esta opción resuelve los valores de las opciones del protocolo que empiezan por \$ a partir de variables de entorno
• Check Connection Method. Si se establece, Odoo siempre comprobará la conexión antes de usar un almacenamiento y eliminará la conexión fs de la caché si la comprobación falla.
• Create Marker file: crea un archivo oculto en el remoto y luego comprueba que existe con Úsalo si tienes acceso de escritura al remoto y si no es un problema dejar el archivo marcador en el directorio raíz.
• List file: lista todos los archivos del directorio raíz. Puedes usarlo si la ruta del directorio no contiene una gran lista de archivos (por razones de rendimiento)

Algunos protocolos definidos en el paquete fsspec son envoltorios alrededor de otros protocolos. Por ejemplo, el protocolo SimpleCacheFileSystem es un envoltorio alrededor de cualquier protocolo de filesystem local. En tales casos, debes especificar en las opciones del protocolo el protocolo que se va a envolver y las opciones que se pasarán al protocolo envuelto.

Por ejemplo, si quieres crear un backend que utilice el protocolo SimpleCacheFileSystem, después de seleccionar el protocolo SimpleCacheFileSystem, debes especificar las opciones del protocolo de la siguiente manera:

{
    "directory_path": "/tmp/my_backend",
    "target_protocol": "odoofs",
    "target_options": {...},
}

En este ejemplo, el protocolo SimpleCacheFileSystem se utilizará como envoltorio alrededor del protocolo odoofs.

Entorno del servidor

Para facilitar la gestión de la configuración de los almacenamientos de filesystem en los diferentes entornos, la configuración de los almacenamientos de filesystem se puede definir en archivos de entorno o directamente en el archivo de configuración principal. Por ejemplo, la configuración de un almacenamiento de filesystem con el código fsprod se puede proporcionar en el archivo de configuración principal de la siguiente manera:

[fs_storage.fsprod]
protocol=s3
options={"endpoint_url": "https://my_s3_server/", "key": "KEY", "secret": "SECRET"}
directory_path=my_bucket

Para que funcione, debe existir un registro storage.backend con el código fsprod en la base de datos. En tu sección de configuración, puedes especificar el valor para los siguientes campos:

• protocol
• options
• directory_path

Al evaluar directory_path, {db_name} se reemplaza por el nombre de la base de datos. Esto es útil en multi-tenant con una configuración completamente controlada por archivos de configuración.

Migración desde storage_backend

El addon fs_storage se puede utilizar para reemplazar el addon storage_backend. (Ha sido diseñado para ser un reemplazo directo del addon storage_backend). Para facilitar la migración, el modelo fs.storage define los métodos de alto nivel disponibles en el modelo storage_backend. Estos métodos son:

• add
• get
• list_files
• find_files
• move_files
• delete

Estos métodos son envoltorios alrededor de los métodos de la clase fsspec.AbstractFileSystem (ver ). Estos métodos están marcados como obsoletos y se eliminarán en una versión futura (V18) del addon. Deberías usar los métodos de la clase fsspec.AbstractFileSystem en su lugar, ya que son más flexibles y potentes. Puedes acceder a la instancia de la clase fsspec.AbstractFileSystem utilizando la propiedad fs de un registro fs.storage.