Amazon S3 / MinIO Odoo Integration v.19

Lo strumento dipende dalla libreria esterna 'boto3'. Installala sul server Odoo con il comando:

1. Attiva l'opzione 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). È richiesto l'add-on opzionale Amazon S3 Odoo Integration
2. Apri la Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Crea un nuovo bucket o scegline uno esistente. Copia il nome esatto del bucket: va inserito in Odoo nel campo 'Bucket'
4. Apri i dettagli del bucket e copia la sua AWS Region. Inseriscila in Odoo nel campo 'Region' (ad esempio, eu-west-1 o us-east-1)
5. Apri la AWS IAM Console: https://console.aws.amazon.com/iam/
6. Crea un nuovo utente IAM o scegli un utente tecnico esistente. Questo utente deve avere pieni diritti per elencare, leggere, creare, scrivere, copiare ed eliminare oggetti nel bucket selezionato. Puoi selezionare l'admin con pieni diritti oppure creare una nuova policy (vedi sotto)
7. Nel modulo utente IAM, apri la scheda 'Security credentials' e premi 'Create access key'
8. Nella pagina 'Access key best practices & alternatives', seleziona l'opzione Application running outside AWS. Questa è l'opzione corretta quando il server Odoo si collega a S3 con access key da fuori AWS, da Odoo.sh, dal tuo server o da un altro hosting. Se Odoo è installato su un'istanza AWS EC2, puoi invece selezionare Application running on an AWS compute service, ma i campi copiati in Odoo sono gli stessi
9. Premi 'Next'. Nel passo successivo, facoltativamente inserisci un tag di descrizione come Odoo S3 Sync, poi premi 'Create access key'
10. Nella pagina AWS finale, copia Access key o Access key ID nel campo Odoo 'Access Key'
11. Copia Secret access key nel campo Odoo 'Secret Key'. Importante: AWS mostra la secret key una sola volta, quindi salvala prima di chiudere la finestra
12. Se usi un provider compatibile S3 invece di AWS S3, copia l'URL dell'endpoint dal pannello di amministrazione di quel provider e inseriscilo in Odoo nel campo 'Amazon S3 endpoint URL'. Ad esempio, MinIO usa spesso un URL come https://minio.example.com o http://localhost:9000; LocalStack usa comunemente http://localhost:4566
13. Vai a Odoo Cloud Storage > Configuration > Cloud Clients e premi 'Create'
14. Come riferimento, inserisci un nome che sia chiaro a tutti gli utenti
15. Come Cloud client, scegli 'Amazon S3'
16. Come Root folder name, inserisci un titolo che verrà usato come prefisso S3 padre per tutte le cartelle sincronizzate. Ad esempio, 'Odoo' o 'OdooERP'
17. Compila i campi 'Bucket', 'Region', 'Access Key', 'Secret Key' e, se necessario, 'Amazon S3 endpoint URL' e addressing style
18. Scegli se Odoo deve usare URL presigned temporanei o URL pubblici di bucket/CDN. Per i bucket privati, tieni attivi gli URL presigned e imposta la loro durata in secondi
19. Premi 'Confirm'. Odoo verifica l'accesso al bucket e crea o controlla il prefisso della cartella radice. La sincronizzazione Amazon S3 - Odoo è pronta per essere eseguita
20. Applica il cloud client appena creato alle regole delle cartelle e/o alle cartelle manuali che devono essere sincronizzate con quel bucket Amazon S3
21. Attendi l'avvio del job pianificato di sync. Solo a scopo di test: avvia l'integrazione manualmente da Cloud Storage > Configuration > Configuration > il pulsante 'Launch sync'.

Documentazione AWS utile: creazione di un bucket S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, gestione delle access key IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Esempio di bucket policy

Amazon S3 ha una peculiarità importante: l'URL mostrato in Odoo è sempre un link lato Amazon.

Se Use Public URLs è attivo, Odoo salva un URL diretto dell'oggetto S3. Il link funziona solo se bucket, prefisso, oggetto, CDN o endpoint compatibile sono pubblicamente leggibili. Altrimenti Amazon S3 mostra AccessDenied, anche se l'utente è collegato alla console AWS.

Per i link pubblici configura i permessi del bucket in Amazon S3 e consenti la lettura pubblica del prefisso Odoo. Esempio di policy del bucket:

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

Sostituisci YOUR_BUCKET_NAME con il nome reale del bucket e Odoo/ con il prefisso della cartella radice scelto. Assicurati anche che le impostazioni Amazon S3 Block public access non blocchino quella policy.

Se Use Public URLs è disattivo, Odoo salva link della AWS Console all'oggetto o al prefisso del bucket. Sono utili per gli utenti Amazon: chi apre il link deve essere collegato ad AWS e avere accesso IAM a quell'oggetto. Senza accesso AWS, Amazon non apre il file.

1. Prepara un server MinIO in esecuzione
2. Apri la MinIO Console
3. Crea un nuovo bucket o scegline uno esistente. Copia il nome esatto del bucket: va inserito in Odoo nel campo 'Bucket'
4. Crea credenziali di accesso per Odoo. In MinIO, usa una coppia access key / secret key o un account di servizio con diritti per elencare, leggere, creare, scrivere, copiare ed eliminare oggetti nel bucket selezionato
5. Copia la Access Key MinIO nel campo Odoo 'Access Key'
6. Copia la Secret Key MinIO nel campo Odoo 'Secret Key'. Importante: salva il secret prima di chiudere la pagina MinIO se MinIO lo mostra una sola volta
7. Copia l'URL dell'endpoint S3 API MinIO in Odoo nel campo 'Amazon S3 endpoint URL'. Ad esempio, un server locale di solito usa http://localhost:9000, mentre un server di produzione può usare https://minio.example.com
8. Vai a Odoo Cloud Storage > Configuration > Cloud Clients e premi 'Create'
9. Come riferimento, inserisci un nome che sia chiaro a tutti gli utenti
10. Come Cloud client, scegli 'MinIO'
11. Come Root folder name, inserisci un titolo che verrà usato come prefisso oggetto MinIO padre per tutte le cartelle sincronizzate. Ad esempio, 'Odoo' o 'OdooERP'
12. Compila i campi 'Bucket', 'Access Key', 'Secret Key' e 'Amazon S3 endpoint URL'. Il campo 'Region' è facoltativo per MinIO; se è vuoto, Odoo usa us-east-1 per la firma compatibile S3
13. Mantieni lo stile di indirizzamento come Path-style. Questa è l'opzione consigliata per gli endpoint MinIO, soprattutto quando l'host MinIO non fornisce nomi DNS specifici per bucket
14. Scegli se Odoo deve usare URL MinIO pubblici diretti. Attiva 'Use Public URLs' solo quando il bucket, il prefisso, il reverse proxy o il CDN è leggibile pubblicamente. Per i bucket MinIO privati, lascialo disattivato
15. Premi 'Confirm'. Odoo verifica l'accesso al bucket e crea o controlla il prefisso della cartella radice. La sincronizzazione MinIO - Odoo è pronta per essere eseguita
16. Applica il cloud client appena creato alle regole delle cartelle e/o alle cartelle manuali che devono essere sincronizzate con quel bucket MinIO
17. Attendi l'avvio del job pianificato di sync. Solo a scopo di test: avvia l'integrazione manualmente da Cloud Storage > Configuration > Configuration > il pulsante 'Launch sync'.

Documentazione MinIO utile: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.