Amazon S3 / MinIO Odoo Integration v.19

La herramienta depende de la biblioteca externa 'boto3'. Instálela en su servidor Odoo con el comando:

1. Active la opción 'Amazon S3 Sync' (Cloud Storage > Configuración > Configuración). Se requiere el complemento opcional Amazon S3 Odoo Integration
2. Abra Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Cree un bucket nuevo o elija uno existente. Copie el nombre exacto del bucket: debe insertarse en Odoo en el campo 'Bucket'
4. Abra los detalles del bucket y copie su AWS Region. Insértela en Odoo en el campo 'Region' (por ejemplo, eu-west-1 o us-east-1)
5. Abra AWS IAM Console: https://console.aws.amazon.com/iam/
6. Cree un usuario IAM nuevo o elija un usuario técnico existente. Este usuario debe tener permisos completos para listar, leer, crear, escribir, copiar y eliminar objetos dentro del bucket seleccionado. Puede elegir el administrador con permisos completos o crear una política nueva (véase más abajo)
7. En el formulario del usuario IAM, abra la pestaña 'Security credentials' y pulse 'Create access key'
8. En la página 'Access key best practices & alternatives', seleccione la opción Application running outside AWS. Es la opción correcta cuando su servidor Odoo se conecta a S3 con access key desde fuera de AWS, desde Odoo.sh, desde su propio servidor o desde otro proveedor de hosting. Si Odoo está instalado en una instancia AWS EC2, puede seleccionar Application running on an AWS compute service, pero los campos que se copian a Odoo son los mismos
9. Pulse 'Next'. En el paso siguiente, opcionalmente introduzca una etiqueta de descripción como Odoo S3 Sync y pulse 'Create access key'
10. En la última página de AWS, copie Access key o Access key ID en el campo de Odoo 'Access Key'
11. Copie Secret access key en el campo de Odoo 'Secret Key'. Importante: AWS muestra la clave secreta solo una vez, así que guárdela antes de cerrar la ventana
12. Si usa un proveedor compatible con S3 en lugar de AWS S3, copie la URL del endpoint desde el panel de administración de ese proveedor e insértela en Odoo en el campo 'Amazon S3 endpoint URL'. Por ejemplo, MinIO suele usar una URL como https://minio.example.com o http://localhost:9000; LocalStack suele usar http://localhost:4566
13. Vaya a Odoo Cloud Storage > Configuración > Cloud Clients y pulse 'Create'
14. Como referencia, introduzca cualquier nombre que resulte claro para todos los usuarios
15. Como Cloud client, elija 'Amazon S3'
16. Como Root folder name, introduzca un título que se usará como prefijo S3 padre para todas las carpetas sincronizadas. Por ejemplo, 'Odoo' u 'OdooERP'
17. Complete los campos 'Bucket', 'Region', 'Access Key', 'Secret Key' y, si hace falta, 'Amazon S3 endpoint URL' y el estilo de direccionamiento
18. Elija si Odoo debe usar URL prefirmadas temporales o URL públicas de bucket/CDN. En buckets privados, deje las URL prefirmadas activas y defina su duración en segundos
19. Pulse 'Confirm'. Odoo comprueba el acceso al bucket y crea o verifica el prefijo de la carpeta raíz. La sincronización Amazon S3 - Odoo está lista
20. Aplique el cliente cloud recién creado a las reglas de carpetas y/o a las carpetas manuales que deban sincronizarse con ese bucket de Amazon S3
21. Espere a que se inicie el trabajo programado de sincronización. Solo para pruebas: lance la integración a mano desde Cloud Storage > Configuración > Configuración > el botón 'Launch sync'.

Documentación útil de AWS: crear un bucket S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, gestionar access keys de IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Ejemplo de política del bucket

Amazon S3 tiene una peculiaridad importante: la URL que muestra Odoo es siempre un enlace del lado de Amazon.

Si Use Public URLs está activo, Odoo guarda una URL directa del objeto S3. El enlace solo funciona si el bucket, prefijo, objeto, CDN o endpoint compatible es de lectura pública. Si no, Amazon S3 muestra AccessDenied, aunque el usuario esté en la consola AWS.

Para enlaces públicos, configure los permisos del bucket en Amazon S3 y permita lectura pública del prefijo Odoo. Ejemplo de política de bucket:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadOdooPrefix",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/Odoo/*"
    }
  ]
}

Sustituya YOUR_BUCKET_NAME por el nombre real del bucket e Odoo/ por el prefijo de carpeta raíz elegido. Asegúrese también de que los ajustes Amazon S3 Block public access no bloqueen esa política.

Si Use Public URLs está desactivado, Odoo guarda enlaces de AWS Console al objeto o prefijo del bucket. Sirven a usuarios de Amazon: quien abre el enlace debe estar en AWS y tener acceso IAM a ese objeto. Sin acceso AWS, Amazon no abre el archivo.

1. Prepare un servidor MinIO en ejecución
2. Abra MinIO Console
3. Cree un bucket nuevo o elija uno existente. Copie el nombre exacto del bucket: debe insertarse en Odoo en el campo 'Bucket'
4. Cree credenciales de acceso para Odoo. En MinIO, use un par access key / secret key o una cuenta de servicio con permisos para listar, leer, crear, escribir, copiar y eliminar objetos dentro del bucket seleccionado
5. Copie la Access Key de MinIO en el campo de Odoo 'Access Key'
6. Copie la Secret Key de MinIO en el campo de Odoo 'Secret Key'. Importante: guarde el secreto antes de cerrar la página de MinIO si MinIO lo muestra solo una vez
7. Copie la URL del endpoint de la API S3 de MinIO en Odoo en el campo 'Amazon S3 endpoint URL'. Por ejemplo, un servidor local suele usar http://localhost:9000, mientras que un servidor de producción puede usar https://minio.example.com
8. Vaya a Odoo Cloud Storage > Configuración > Cloud Clients y pulse 'Create'
9. Como referencia, introduzca cualquier nombre que resulte claro para todos los usuarios
10. Como Cloud client, elija 'MinIO'
11. Como Root folder name, introduzca un título que se usará como prefijo de objeto padre de MinIO para todas las carpetas sincronizadas. Por ejemplo, 'Odoo' u 'OdooERP'
12. Complete los campos 'Bucket', 'Access Key', 'Secret Key' y 'Amazon S3 endpoint URL'. El campo 'Region' es opcional para MinIO; si está vacío, Odoo usa us-east-1 para la firma compatible con S3
13. Mantenga el estilo de direccionamiento como Path-style. Es la opción recomendada para endpoints MinIO, especialmente cuando el host de MinIO no ofrece nombres DNS específicos del bucket
14. Elija si Odoo debe usar URL públicas directas de MinIO. Active 'Use Public URLs' solo cuando el bucket, el prefijo, el proxy inverso o el CDN sean de lectura pública. En buckets MinIO privados, déjelo desactivado
15. Pulse 'Confirm'. Odoo comprueba el acceso al bucket y crea o verifica el prefijo de la carpeta raíz. La sincronización MinIO - Odoo está lista
16. Aplique el cliente cloud recién creado a las reglas de carpetas y/o a las carpetas manuales que deban sincronizarse con ese bucket de MinIO
17. Espere a que se inicie el trabajo programado de sincronización. Solo para pruebas: lance la integración a mano desde Cloud Storage > Configuración > Configuración > el botón 'Launch sync'.

Documentación MinIO útil: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.