Amazon S3 / MinIO Odoo Integration v.19

Įrankis priklauso nuo išorinės bibliotekos „boto3“. Įdiekite ją Odoo serveryje komanda:

1. Įjunkite parinktį 'Amazon S3 Sync' (Cloud Storage > Konfigūracija > Konfigūracija). Reikalingas pasirenkamas priedas Amazon S3 Odoo Integration
2. Atidarykite Amazon S3 konsolę: https://console.aws.amazon.com/s3/
3. Sukurkite naują bucket arba pasirinkite esamą. Nukopijuokite tikslų bucket pavadinimą: jį reikia įrašyti Odoo lauke „Bucket“
4. Atidarykite bucket išsamią informaciją ir nukopijuokite AWS Region. Įterpkite ją Odoo lauke 'Region' (pavyzdžiui, eu-west-1 arba us-east-1)
5. Atidarykite AWS IAM konsolę: https://console.aws.amazon.com/iam/
6. Sukurkite naują IAM naudotoją arba pasirinkite esamą techninį naudotoją. Šis naudotojas turi turėti visas teises sąrašyti, skaityti, kurti, rašyti, kopijuoti ir trinti objektus pasirinktame bucket. Galite pasirinkti visateisį administratorių arba sukurti naują politiką (žr. žemiau)
7. IAM naudotojo formoje atidarykite skirtuką 'Security credentials' ir paspauskite 'Create access key'
8. Puslapyje 'Access key best practices & alternatives' pasirinkite Application running outside AWS. Tai teisingas pasirinkimas, kai Odoo serveris prie S3 jungiasi prieigos raktu iš už AWS ribų, iš Odoo.sh, iš jūsų serverio ar kito hostingo. Jei Odoo įdiegtas AWS EC2 egzemplioriuje, galite rinktis Application running on an AWS compute service, bet į Odoo kopijuojami laukai tie patys
9. Spauskite 'Next'. Kitame žingsnyje pasirinktinai įveskite aprašo žymą, pvz. Odoo S3 Sync, tada spauskite 'Create access key'
10. Paskutiniame AWS puslapyje nukopijuokite Access key arba Access key ID į Odoo lauką 'Access Key'
11. Nukopijuokite Secret access key į Odoo lauką „Secret Key“. Svarbu: AWS slaptąjį raktą rodo tik kartą, todėl išsaugokite jį prieš uždarydami langą
12. Jei naudojate su S3 suderinamą teikėją vietoje AWS S3, nukopijuokite galinio taško URL iš to teikėjo administratoriaus skydelio ir įklijuokite į Odoo lauką 'Amazon S3 endpoint URL'. Pvz., MinIO dažnai naudoja URL kaip https://minio.example.com arba http://localhost:9000; LocalStack paprastai http://localhost:4566
13. Eikite į Odoo Cloud Storage > Configuration > Cloud Clients ir paspauskite 'Create'
14. Nuorodoje įveskite vardą, suprantamą visiems naudotojams
15. Cloud klientu pasirinkite «Amazon S3»
16. Kaip Root folder pavadinimą įveskite pavadinimą, kuris bus naudojamas kaip visų sinchronizuojamų aplankalų tėvinis S3 prefix. Pavyzdžiui, 'Odoo' arba 'OdooERP'
17. Užpildykite laukus 'Bucket', 'Region', 'Access Key', 'Secret Key' ir, jei reikia, 'Amazon S3 endpoint URL' bei adresavimo stilių
18. Pasirinkite, ar Odoo turi naudoti laikinus presigned URL, ar viešus bucket/CDN URL. Privačiuose bucket palikite presigned URL įjungtus ir nustatykite jų galiojimą sekundėmis
19. Paspauskite 'Confirm'. Odoo patikrina prieigą prie bucket ir sukuria arba patikrina šakninio aplanko priešdėlį. Amazon S3 - Odoo sinchronizacija paruošta atlikti
20. Pritaikykite naujai sukurtą cloud client aplankalų taisyklėms ir/arba rankiniams aplankalams, kuriuos reikia sinchronizuoti su tuo Amazon S3 bucket
21. Palaukite, kol bus paleista sinchronizavimo suplanuota užduotis. Tik testavimo tikslais: paleiskite integraciją rankiniu būdu iš Cloud Storage > Konfigūracija > Konfigūracija > mygtukas „Launch sync“.

Naudinga AWS dokumentacija: S3 bucket kūrimas: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM prieigos raktų valdymas: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Bucket politikos pavyzdys

Amazon S3 turi svarbią ypatybę: Odoo rodomas URL visada yra Amazon pusės nuoroda.

Jei Use Public URLs įjungta, Odoo išsaugo tiesioginį S3 objekto URL. Nuoroda veikia tik jei susijęs S3 bucket, prefiksas, objektas, CDN ar suderinamas galinis taškas yra viešai skaitomas. Kitu atveju Amazon S3 rodo AccessDenied, net jei naudotojas prisijungęs prie AWS konsolės.

Viešoms nuorodoms sukonfigūruokite talpyklos teises Amazon S3 ir leiskite viešą skaitymą Odoo prefiksui. Pavyzdinė talpyklos politika:

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

Pakeiskite YOUR_BUCKET_NAME tikru bucket pavadinimu, o Odoo/ – pasirinktu šakninio aplanko priešdėliu. Taip pat įsitikinkite, kad Amazon S3 Block public access nustatymai neblokuoja tos bucket politikos.

Jei Use Public URLs išjungta, Odoo išsaugo AWS Console nuorodas į susijusį bucket objektą arba prefiksą. Tokios nuorodos naudingos Amazon naudotojams: atidarantysis turi būti prisijungęs prie AWS ir turėti IAM prieigą prie to objekto. Jei naudotojas neturi AWS prieigos, Amazon failo neatidarys.

1. Paruoškite veikiantį MinIO serverį
2. Atidarykite MinIO konsolę
3. Sukurkite naują bucket arba pasirinkite esamą. Nukopijuokite tikslų bucket pavadinimą: jį reikia įrašyti Odoo lauke „Bucket“
4. Sukurkite Odoo prieigos prisijungimo duomenis. MinIO naudokite access key / secret key porą arba paslaugos paskyrą, turinčią teises sąrašyti, skaityti, kurti, rašyti, kopijuoti ir trinti objektus pasirinktame bucket
5. Nukopijuokite MinIO Access Key į Odoo lauką „Access Key“
6. Nukopijuokite MinIO Secret Key į Odoo lauką „Secret Key“. Svarbu: išsaugokite paslaptį prieš uždarydami MinIO puslapį, jei MinIO ją rodo tik kartą
7. Nukopijuokite MinIO S3 API galinio taško URL į Odoo lauką „Amazon S3 endpoint URL“. Pavyzdžiui, vietinis serveris paprastai naudoja http://localhost:9000, o gamybos serveris gali naudoti https://minio.example.com
8. Eikite į Odoo Cloud Storage > Configuration > Cloud Clients ir paspauskite 'Create'
9. Nuorodoje įveskite vardą, suprantamą visiems naudotojams
10. Cloud klientu pasirinkite «MinIO»
11. Kaip Root folder pavadinimą įveskite pavadinimą, kuris bus naudojamas kaip visų sinchronizuojamų aplankalų tėvinis MinIO object prefix. Pavyzdžiui, 'Odoo' arba 'OdooERP'
12. Užpildykite laukus 'Bucket', 'Access Key', 'Secret Key' ir 'Amazon S3 endpoint URL'. Laukas 'Region' MinIO yra neprivalomas; jei tuščias, Odoo S3 suderinamam pasirašymui naudoja us-east-1
13. Palikite adresavimo stilių Path-style. Tai rekomenduojama parinktis MinIO galiniams taškams, ypač kai MinIO serveris neduoda atskirų DNS vardų kiekvienam bucket
14. Pasirinkite, ar Odoo turi naudoti tiesioginius viešus MinIO URL. Įjunkite „Use Public URLs“ tik tada, kai bucket, prefix, atvirkštinis proxy ar CDN yra viešai skaitomi. Privačiuose MinIO bucket palikite išjungtą
15. Paspauskite 'Confirm'. Odoo patikrina prieigą prie bucket ir sukuria arba patikrina šakninio aplanko priešdėlį. MinIO - Odoo sinchronizacija paruošta atlikti
16. Pritaikykite naujai sukurtą cloud client aplankalų taisyklėms ir/arba rankiniams aplankalams, kuriuos reikia sinchronizuoti su tuo MinIO bucket
17. Palaukite, kol bus paleista sinchronizavimo suplanuota užduotis. Tik testavimo tikslais: paleiskite integraciją rankiniu būdu iš Cloud Storage > Konfigūracija > Konfigūracija > mygtukas „Launch sync“.

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