Amazon S3 / MinIO Odoo Integration v.19

Tööriist sõltub välisest teegist 'boto3'. Installige see Odoo serverisse käsuga:

1. Lülitage sisse valik 'Amazon S3 Sync' (Cloud Storage > Seadistus > Seadistus). Vajalik on valikuline lisamoodul Amazon S3 Odoo Integration
2. Avage Amazon S3 konsool: https://console.aws.amazon.com/s3/
3. Looge uus bucket või valige olemasolev. Kopeerige täpne bucketi nimi: see tuleb sisestada Odoo väljale „Bucket“
4. Avage bucketi üksikasjad ja kopeerige AWS Region. Sisestage see Odoosse väljale 'Region' (näiteks eu-west-1 või us-east-1)
5. Avage AWS IAM konsool: https://console.aws.amazon.com/iam/
6. Looge uus IAM-kasutaja või valige olemasolev tehniline kasutaja. Sellel kasutajal peavad olema täielikud õigused valitud bucketis objekte loetleda, lugeda, luua, kirjutada, kopeerida ja kustutada. Võite valida täisõigustega admini või luua uue poliitika (vt allpool)
7. IAM kasutaja vormil avage vahekaart 'Security credentials' ja vajutage 'Create access key'
8. Lehel 'Access key best practices & alternatives' valige Application running outside AWS. See on õige valik, kui Odoo server ühendub S3-ga juurdepääsuvõtmega väljaspool AWS-i, Odoo.sh-st, teie serverist või muult hostilt. Kui Odoo on AWS EC2 eksemplaris, võite valida Application running on an AWS compute service, kuid Odoosse kopeeritavad väljad on samad
9. Vajutage 'Next'. Järgmises etapis sisestage soovi korral kirjeldussilt, nt Odoo S3 Sync, seejärel vajutage 'Create access key'
10. Viimasel AWS lehel kopeerige Access key või Access key ID Odoo väljale 'Access Key'
11. Kopeerige Secret access key Odoo väljale „Secret Key“. Oluline: AWS näitab salajast võtit ainult üks kord, seega salvestage see enne akna sulgemist
12. Kui kasutate AWS S3 asemel S3-ühilduvat teenusepakkujat, kopeerige otspunkti URL selle pakkuja halduspaneelilt ja sisestage Odoo väljale 'Amazon S3 endpoint URL'. Näiteks MinIO kasutab sageli URL-i nagu https://minio.example.com või http://localhost:9000; LocalStack tavaliselt http://localhost:4566
13. Minge Odoo Cloud Storage > Configuration > Cloud Clients ja vajutage 'Create'
14. Viiteks sisestage nimi, mis on kõigile kasutajatele selge
15. Cloud kliendiks valige «Amazon S3»
16. Root folder nimeks sisestage pealkiri, mida kasutatakse kõigi sünkroonitud kaustade ülemise S3 prefix jaoks. Näiteks 'Odoo' või 'OdooERP'
17. Täitke väljad 'Bucket', 'Region', 'Access Key', 'Secret Key' ning vajadusel 'Amazon S3 endpoint URL' ja adresseerimisstiil
18. Valige, kas Odoo peaks kasutama ajutisi presigned URL-e või avalikke bucketi/CDN URL-e. Privaatsete bucketite puhul hoidke presigned URL-id sees ja määrake nende eluiga sekundites
19. Vajutage 'Confirm'. Odoo kontrollib bucketi juurdepääsu ning loob või kinnitab juurkausta prefiksi. Amazon S3 - Odoo sünkroonimine on valmis tegemiseks
20. Rakendage äsja loodud cloud client kaustareeglitele ja/või käsitsi kaustadele, mis tuleb sünkroonida selle Amazon S3 bucketiga
21. Oodake, kuni sünkroonimise ajastatud töö käivitub. Ainult testimiseks: käivitage integratsioon käsitsi teelt Cloud Storage > Seaded > Seaded > nupp „Launch sync“.

Kasulik AWS dokumentatsioon: S3 bucketi loomine: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM juurdepääsuvõtmete haldamine: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Bucket poliitika näide

Amazon S3-l on oluline eripära: Odoos näidatud URL on alati Amazoni-poolne link.

Kui Use Public URLs on lubatud, salvestab Odoo otsese S3 objekti URL-i. Link töötab ainult siis, kui seotud S3 bucket, prefiks, objekt, CDN või ühilduv otspunkt on avalikult loetav. Muidu näitab Amazon S3 AccessDenied, isegi kui kasutaja on AWS konsooli sisse logitud.

Avalike linkide jaoks seadistage Amazoni S3 ämbriload ja lubage Odoo eesliitele avalik lugemisõigus. Näidisämbristrateegia:

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

Asendage YOUR_BUCKET_NAME tegeliku bucketi nimega ja Odoo/ valitud juurkausta prefiksiga. Veenduge ka, et Amazon S3 Block public access seaded ei blokeeri seda bucketi poliitikat.

Kui Use Public URLs on keelatud, salvestab Odoo AWS Console linke seotud bucket objektile või prefiksile. Sellised lingid on kasulikud Amazoni kasutajatele: avaja peab olema AWS-i sisse logitud ja omama IAM-ligipääsu sellele objektile. Kui kasutajal AWS-ligipääsu pole, Amazon faili ei ava.

1. Valmistage töötav MinIO server
2. Avage MinIO konsool
3. Looge uus bucket või valige olemasolev. Kopeerige täpne bucketi nimi: see tuleb sisestada Odoo väljale „Bucket“
4. Looge Odoo juurdepääsumandaadid. MinIO-s kasutage access key / secret key paari või teenusekontot, millel on õigus valitud bucketis objekte loetleda, lugeda, luua, kirjutada, kopeerida ja kustutada
5. Kopeerige MinIO Access Key Odoo väljale „Access Key“
6. Kopeerige MinIO Secret Key Odoo väljale „Secret Key“. Oluline: salvestage saladus enne MinIO lehe sulgemist, kui MinIO näitab seda ainult üks kord
7. Kopeerige MinIO S3 API lõpp-punkti URL Odoosse väljale „Amazon S3 endpoint URL“. Näiteks kohalik server kasutab tavaliselt http://localhost:9000, tootmisserver võib kasutada https://minio.example.com
8. Minge Odoo Cloud Storage > Configuration > Cloud Clients ja vajutage 'Create'
9. Viiteks sisestage nimi, mis on kõigile kasutajatele selge
10. Cloud kliendiks valige «MinIO»
11. Root folder nimeks sisestage pealkiri, mida kasutatakse kõigi sünkroonitud kaustade ülemise MinIO object prefix jaoks. Näiteks 'Odoo' või 'OdooERP'
12. Täitke väljad 'Bucket', 'Access Key', 'Secret Key' ja 'Amazon S3 endpoint URL'. Väli 'Region' on MinIO jaoks valikuline; kui see on tühi, kasutab Odoo S3-ühilduvaks allkirjastamiseks us-east-1
13. Hoidke adresseerimislaad Path-style. See on soovitatav valik MinIO otspunktidele, eriti kui MinIO host ei paku bucketipõhiseid DNS-nimesid
14. Valige, kas Odoo peaks kasutama otseseid avalikke MinIO URL-e. Lubage „Use Public URLs“ ainult siis, kui bucket, prefix, pöördproksi või CDN on avalikult loetav. Privaatsete MinIO bucketite puhul jätke see välja
15. Vajutage 'Confirm'. Odoo kontrollib bucketi juurdepääsu ning loob või kinnitab juurkausta prefiksi. MinIO - Odoo sünkroonimine on valmis tegemiseks
16. Rakendage äsja loodud cloud client kaustareeglitele ja/või käsitsi kaustadele, mis tuleb sünkroonida selle MinIO bucketiga
17. Oodake, kuni sünkroonimise ajastatud töö käivitub. Ainult testimiseks: käivitage integratsioon käsitsi teelt Cloud Storage > Seaded > Seaded > nupp „Launch sync“.

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