Amazon S3 / MinIO Odoo Integration v.19

Orodje je odvisno od zunanje knjižnice 'boto3'. Namestite jo na strežnik Odoo z ukazom:

1. Vklopite možnost 'Amazon S3 Sync' (Cloud Storage > Konfiguracija > Konfiguracija). Potreben je izbirni dodatek Amazon S3 Odoo Integration
2. Odprite konzolo Amazon S3: https://console.aws.amazon.com/s3/
3. Ustvarite nov bucket ali izberite obstoječega. Kopirajte točno ime bucketa: vnesti ga je treba v Odoo v polje »Bucket«
4. Odprite podrobnosti bucket in kopirajte AWS Region. Vstavite jo v Odoo v polje 'Region' (na primer eu-west-1 ali us-east-1)
5. Odprite konzolo AWS IAM: https://console.aws.amazon.com/iam/
6. Ustvarite novega uporabnika IAM ali izberite obstoječega tehničnega uporabnika. Ta uporabnik mora imeti polne pravice za seznam, branje, ustvarjanje, pisanje, kopiranje in brisanje objektov v izbranem bucketu. Izberete lahko skrbnika s polnimi pravicami ali ustvarite novo politiko (glejte spodaj)
7. Na obrazcu uporabnika IAM odprite zavihek 'Security credentials' in pritisnite 'Create access key'
8. Na strani 'Access key best practices & alternatives' izberite Application running outside AWS. To je pravilna možnost, ko se strežnik Odoo poveže s S3 s ključem za dostop zunaj AWS, iz Odoo.sh, z lastnega strežnika ali drugega gostitelja. Če je Odoo nameščen na instanci AWS EC2, lahko izberete Application running on an AWS compute service, vendar so polja, kopirana v Odoo, enaka
9. Pritisnite 'Next'. Na naslednjem koraku po želji vnesite oznako opisa, npr. Odoo S3 Sync, nato pritisnite 'Create access key'
10. Na zadnji strani AWS kopirajte Access key ali Access key ID v polje Odoo 'Access Key'
11. Kopirajte Secret access key v polje Odoo »Secret Key«. Pomembno: AWS tajni ključ pokaže samo enkrat, zato ga shranite pred zaprtjem okna
12. Če namesto AWS S3 uporabljate S3-združljivega ponudnika, kopirajte URL končne točke iz skrbniške plošče tega ponudnika in ga vnesite v Odoo v polje 'Amazon S3 endpoint URL'. Na primer, MinIO pogosto uporablja URL kot https://minio.example.com ali http://localhost:9000; LocalStack običajno http://localhost:4566
13. Pojdite na Odoo Cloud Storage > Configuration > Cloud Clients in pritisnite 'Create'
14. Kot sklic vnesite ime, razumljivo vsem uporabnikom
15. Kot Cloud odjemalec izberite «Amazon S3»
16. Kot ime Root folder vnesite naslov, ki bo uporabljen kot nadrejeni S3 prefix za vse sinhronizirane mape. Na primer 'Odoo' ali 'OdooERP'
17. Izpolnite polja 'Bucket', 'Region', 'Access Key', 'Secret Key' in po potrebi 'Amazon S3 endpoint URL' ter slog naslavljanja
18. Izberite, ali naj Odoo uporablja začasne presigned URL ali javne URL bucket/CDN. Za zasebne bucket pustite presigned URL omogočene in nastavite njihovo življenjsko dobo v sekundah
19. Pritisnite 'Confirm'. Odoo preveri dostop do bucket in ustvari ali potrdi predpono korenske mape. Sinhronizacija Amazon S3 - Odoo je pripravljena
20. Novi cloud client uporabite na pravilih map in/ali ročnih mapah, ki naj se sinhronizirajo s tistim vedrom Amazon S3
21. Počakajte, da se zažene načrtovano opravilo sinhronizacije. Samo za testiranje: sprožite integracijo ročno iz Cloud Storage > Nastavitve > Nastavitve > gumb »Launch sync«.

Koristna dokumentacija AWS: ustvarjanje S3 bucket: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, upravljanje IAM dostopnimi ključi: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Primer politike bucket

Amazon S3 ima pomembno posebnost: URL, prikazan v Odoo, je vedno povezava na strani Amazon.

Če je Use Public URLs omogočeno, Odoo shrani neposreden URL predmeta S3. Povezava deluje le, če sta povezani S3 bucket, predpona, objekt, CDN ali združljiva končna točka javno berljiva. Sicer Amazon S3 prikaže AccessDenied, tudi če je uporabnik prijavljen v konzolo AWS.

Za javne povezave nastavite dovoljenja vedra v Amazon S3 in dovolite javno branje za predpono Odoo. Primer pravilnika vedra:

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

Zamenjajte YOUR_BUCKET_NAME z resničnim imenom bucket in Odoo/ z izbrano predpono korenske mape. Prepričajte se tudi, da nastavitve Amazon S3 Block public access ne blokirajo te politike bucket.

Če je Use Public URLs onemogočeno, Odoo shrani povezave AWS Console na povezani objekt ali predpono bucket. Takšne povezave so uporabne za uporabnike Amazon: oseba, ki odpre povezavo, mora biti prijavljena v AWS in imeti IAM dostop do tega objekta. Če uporabnik nima AWS dostopa, Amazon datoteke ne odpre.

1. Pripravite delujoč strežnik MinIO
2. Odprite konzolo MinIO
3. Ustvarite nov bucket ali izberite obstoječega. Kopirajte točno ime bucketa: vnesti ga je treba v Odoo v polje »Bucket«
4. Ustvarite poverilnice za dostop do Odoo. V MinIO uporabite par access key / secret key ali račun storitve s pravicami za seznam, branje, ustvarjanje, pisanje, kopiranje in brisanje objektov v izbranem bucketu
5. Kopirajte MinIO Access Key v polje Odoo »Access Key«
6. Kopirajte MinIO Secret Key v polje Odoo »Secret Key«. Pomembno: shranite skrivnost pred zaprtjem strani MinIO, če jo MinIO pokaže samo enkrat
7. Kopirajte URL končne točke MinIO S3 API v Odoo v polje »Amazon S3 endpoint URL«. Lokalni strežnik na primer običajno uporablja http://localhost:9000, produkcijski pa lahko https://minio.example.com
8. Pojdite na Odoo Cloud Storage > Configuration > Cloud Clients in pritisnite 'Create'
9. Kot sklic vnesite ime, razumljivo vsem uporabnikom
10. Kot Cloud odjemalec izberite «MinIO»
11. Kot ime Root folder vnesite naslov, ki bo uporabljen kot nadrejeni MinIO object prefix za vse sinhronizirane mape. Na primer 'Odoo' ali 'OdooERP'
12. Izpolnite polja 'Bucket', 'Access Key', 'Secret Key' in 'Amazon S3 endpoint URL'. Polje 'Region' je za MinIO izbirno; če je prazno, Odoo za S3-združljivo podpisovanje uporabi us-east-1
13. Ohranite slog naslavljanja Path-style. To je priporočena možnost za končne točke MinIO, zlasti če gostitelj MinIO ne zagotavlja DNS imen za posamezne buckete
14. Izberite, ali naj Odoo uporablja neposredne javne MinIO URL. »Use Public URLs« omogočite le, ko so bucket, predpona, vzvratni posrednik ali CDN javno berljivi. Za zasebne MinIO bucket pustite onemogočeno
15. Pritisnite 'Confirm'. Odoo preveri dostop do bucket in ustvari ali potrdi predpono korenske mape. Sinhronizacija MinIO - Odoo je pripravljena
16. Novi cloud client uporabite na pravilih map in/ali ročnih mapah, ki naj se sinhronizirajo s tistim vedrom MinIO
17. Počakajte, da se zažene načrtovano opravilo sinhronizacije. Samo za testiranje: sprožite integracijo ročno iz Cloud Storage > Nastavitve > Nastavitve > gumb »Launch sync«.

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