Amazon S3 / MinIO Odoo Integration v.19

Instrumentul depinde de biblioteca externă 'boto3'. Instalați-o pe serverul Odoo cu comanda:

1. Activați opțiunea 'Amazon S3 Sync' (Cloud Storage > Configurare > Configurare). Este necesar add-on-ul opțional Amazon S3 Odoo Integration
2. Deschideți consola Amazon S3: https://console.aws.amazon.com/s3/
3. Creați un bucket nou sau alegeți unul existent. Copiați numele exact al bucketului: trebuie introdus în Odoo în câmpul 'Bucket'
4. Deschideți detaliile bucket-ului și copiați AWS Region. Inserați-o în Odoo în câmpul 'Region' (de exemplu, eu-west-1 sau us-east-1)
5. Deschideți consola AWS IAM: https://console.aws.amazon.com/iam/
6. Creați un utilizator IAM nou sau alegeți un utilizator tehnic existent. Acest utilizator trebuie să aibă drepturi complete de a lista, citi, crea, scrie, copia și șterge obiecte în bucket-ul selectat. Puteți alege adminul cu drepturi complete sau crea o politică nouă (vezi mai jos)
7. În formularul utilizatorului IAM deschideți fila 'Security credentials' și apăsați 'Create access key'
8. Pe pagina 'Access key best practices & alternatives' selectați Application running outside AWS. Aceasta este opțiunea corectă când serverul Odoo se conectează la S3 prin cheie de acces din afara AWS, de pe Odoo.sh, de pe propriul server sau de la alt furnizor de găzduire. Dacă Odoo e instalat pe o instanță AWS EC2, puteți alege Application running on an AWS compute service, dar câmpurile copiate în Odoo sunt aceleași
9. Apăsați 'Next'. La pasul următor, opțional introduceți o etichetă de descriere precum Odoo S3 Sync, apoi apăsați 'Create access key'
10. Pe pagina finală AWS, copiați Access key sau Access key ID în câmpul Odoo 'Access Key'
11. Copiați Secret access key în câmpul Odoo „Secret Key“. Important: AWS afișează cheia secretă o singură dată, deci salvați-o înainte de a închide fereastra
12. Dacă folosiți un furnizor compatibil S3 în loc de AWS S3, copiați URL-ul endpoint din panoul de administrare al furnizorului și introduceți-l în Odoo în câmpul 'Amazon S3 endpoint URL'. De exemplu, MinIO folosește adesea un URL ca https://minio.example.com sau http://localhost:9000; LocalStack de obicei http://localhost:4566
13. Mergeți la Odoo Cloud Storage > Configuration > Cloud Clients și apăsați 'Create'
14. Ca referință, introduceți un nume clar pentru toți utilizatorii
15. Ca client Cloud, alegeți «Amazon S3»
16. Ca nume Root folder introduceți un titlu care va fi folosit ca S3 prefix părinte pentru toate dosarele sincronizate. De exemplu, 'Odoo' sau 'OdooERP'
17. Completați câmpurile 'Bucket', 'Region', 'Access Key', 'Secret Key' și, dacă e nevoie, 'Amazon S3 endpoint URL' și stilul de adresare
18. Alegeți dacă Odoo trebuie să folosească URL-uri presigned temporare sau URL-uri publice de bucket/CDN. Pentru bucketuri private, păstrați URL-urile presigned activate și setați durata de viață în secunde
19. Apăsați 'Confirm'. Odoo verifică accesul la bucket și creează sau verifică prefixul folderului rădăcină. Sincronizarea Amazon S3 - Odoo este gata de făcut
20. Aplicați noul cloud client la regulile de dosare și/sau dosarele manuale care trebuie sincronizate cu acel bucket Amazon S3
21. Așteptați pornirea lucrării programate de sincronizare. Doar în scop de testare: declanșați integrarea manual din Cloud Storage > Configurare > Configurare > butonul „Launch sync”.

Documentație AWS utilă: crearea unui bucket S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, gestionarea cheilor de acces IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Exemplu de politică bucket

Amazon S3 are o particularitate importantă: URL-ul afișat în Odoo este întotdeauna un link din partea Amazon.

Dacă Use Public URLs este activat, Odoo salvează un URL direct al obiectului S3. Linkul funcționează doar dacă bucket-ul, prefixul, obiectul, CDN-ul sau endpoint-ul compatibil este citibil public. Altfel Amazon S3 afișează AccessDenied, chiar dacă utilizatorul e autentificat în consola AWS.

Pentru linkuri publice, configurați permisiunile bucketului în Amazon S3 și permiteți citirea publică pentru prefixul Odoo. Exemplu de politică de bucket:

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

Înlocuiți YOUR_BUCKET_NAME cu numele real al bucket-ului și Odoo/ cu prefixul de folder rădăcină ales. Asigurați-vă și că setările Amazon S3 Block public access nu blochează acea politică de bucket.

Dacă Use Public URLs este dezactivat, Odoo salvează linkuri AWS Console către obiectul sau prefixul bucket aferent. Astfel de linkuri sunt utile utilizatorilor Amazon: persoana care deschide trebuie să fie autentificată în AWS și să aibă acces IAM la acel obiect. Dacă utilizatorul nu are acces AWS, Amazon nu va deschide fișierul.

1. Pregătiți un server MinIO pornit
2. Deschideți consola MinIO
3. Creați un bucket nou sau alegeți unul existent. Copiați numele exact al bucketului: trebuie introdus în Odoo în câmpul 'Bucket'
4. Creați acreditări de acces pentru Odoo. În MinIO, folosiți o pereche access key / secret key sau un cont de serviciu cu drepturi de a lista, citi, crea, scrie, copia și șterge obiecte în bucketul selectat
5. Copiați MinIO Access Key în câmpul Odoo „Access Key“
6. Copiați MinIO Secret Key în câmpul Odoo „Secret Key“. Important: salvați secretul înainte de a închide pagina MinIO dacă MinIO îl afișează o singură dată
7. Copiați URL-ul endpoint-ului API S3 MinIO în Odoo în câmpul „Amazon S3 endpoint URL“. De exemplu, un server local folosește de obicei http://localhost:9000, iar un server de producție poate folosi https://minio.example.com
8. Mergeți la Odoo Cloud Storage > Configuration > Cloud Clients și apăsați 'Create'
9. Ca referință, introduceți un nume clar pentru toți utilizatorii
10. Ca client Cloud, alegeți «MinIO»
11. Ca nume Root folder introduceți un titlu care va fi folosit ca MinIO object prefix părinte pentru toate dosarele sincronizate. De exemplu, 'Odoo' sau 'OdooERP'
12. Completați câmpurile 'Bucket', 'Access Key', 'Secret Key' și 'Amazon S3 endpoint URL'. Câmpul 'Region' este opțional pentru MinIO; dacă este gol, Odoo folosește us-east-1 pentru semnarea compatibilă S3
13. Păstrați stilul de adresare Path-style. Aceasta este opțiunea recomandată pentru endpoint-urile MinIO, mai ales când gazda MinIO nu oferă nume DNS specifice bucket-ului
14. Alegeți dacă Odoo trebuie să folosească URL-uri MinIO publice directe. Activați „Use Public URLs” doar când bucketul, prefixul, proxy-ul invers sau CDN-ul sunt citibile public. Pentru bucketuri MinIO private, lăsați dezactivat
15. Apăsați 'Confirm'. Odoo verifică accesul la bucket și creează sau verifică prefixul folderului rădăcină. Sincronizarea MinIO - Odoo este gata de făcut
16. Aplicați noul cloud client la regulile de dosare și/sau dosarele manuale care trebuie sincronizate cu acel bucket MinIO
17. Așteptați pornirea lucrării programate de sincronizare. Doar în scop de testare: declanșați integrarea manual din Cloud Storage > Configurare > Configurare > butonul „Launch sync”.

Documentație MinIO utilă: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.