Amazon S3 / MinIO Odoo Integration v.19

Alat ovisi o vanjskoj biblioteci 'boto3'. Instalirajte je na Odoo poslužitelj naredbom:

1. Uključite opciju 'Amazon S3 Sync' (Cloud Storage > Konfiguracija > Konfiguracija). Potreban je opcionalni dodatak Amazon S3 Odoo Integration
2. Otvorite Amazon S3 konzolu: https://console.aws.amazon.com/s3/
3. Stvorite novi bucket ili odaberite postojeći. Kopirajte točan naziv bucketa: treba ga unijeti u Odoo u polje 'Bucket'
4. Otvorite pojedinosti bucket-a i kopirajte AWS Region. Umetnite je u Odoo u polje 'Region' (npr. eu-west-1 ili us-east-1)
5. Otvorite AWS IAM konzolu: https://console.aws.amazon.com/iam/
6. Stvorite novog IAM korisnika ili odaberite postojećeg tehničkog korisnika. Taj korisnik treba imati puna prava za popisivanje, čitanje, stvaranje, pisanje, kopiranje i brisanje objekata u odabranom bucketu. Možete odabrati admina s punim pravima ili stvoriti novu politiku (vidi dolje)
7. U obrascu IAM korisnika otvorite karticu 'Security credentials' i pritisnite 'Create access key'
8. Na stranici 'Access key best practices & alternatives' odaberite Application running outside AWS. To je ispravna opcija kada se Odoo poslužitelj povezuje na S3 pristupnim ključem izvan AWS-a, s Odoo.sh, s vlastitog poslužitelja ili drugog hosting pružatelja. Ako je Odoo instaliran na AWS EC2 instanci, možete odabrati Application running on an AWS compute service, ali polja kopirana u Odoo ostaju ista
9. Pritisnite 'Next'. Na sljedećem koraku po želji unesite oznaku opisa kao Odoo S3 Sync, zatim pritisnite 'Create access key'
10. Na posljednjoj AWS stranici kopirajte Access key ili Access key ID u Odoo polje 'Access Key'
11. Kopirajte Secret access key u Odoo polje „Secret Key“. Važno: AWS tajni ključ pokazuje samo jednom, pa ga spremite prije zatvaranja prozora
12. Ako koristite S3-kompatibilnog pružatelja umjesto AWS S3, kopirajte URL krajnje točke iz administratorske ploče tog pružatelja i umetnite ga u Odoo u polje 'Amazon S3 endpoint URL'. Npr. MinIO često koristi URL poput https://minio.example.com ili http://localhost:9000; LocalStack obično http://localhost:4566
13. Idite na Odoo Cloud Storage > Configuration > Cloud Clients i pritisnite 'Create'
14. Kao referencu unesite naziv jasan svim korisnicima
15. Kao Cloud klijent odaberite «Amazon S3»
16. Kao naziv Root folder unesite naslov koji će se koristiti kao nadređeni S3 prefix za sve sinkronizirane mape. Na primjer, 'Odoo' ili 'OdooERP'
17. Ispunite polja 'Bucket', 'Region', 'Access Key', 'Secret Key' i, ako treba, 'Amazon S3 endpoint URL' te stil adresiranja
18. Odaberite treba li Odoo koristiti privremene presigned URL-ove ili javne bucket/CDN URL-ove. Za privatne buckete ostavite presigned URL-ove uključene i postavite im životni vijek u sekundama
19. Pritisnite 'Confirm'. Odoo provjerava pristup bucketu i stvara ili potvrđuje prefiks korijenske mape. Sinkronizacija Amazon S3 - Odoo spremna je za izvođenje
20. Primijenite novo stvoreni cloud client na pravila mapa i/ili ručne mape koje treba sinkronizirati s tim Amazon S3 bucketom
21. Pričekajte da se pokrene zakazani posao sinkronizacije. Samo u svrhu testiranja: pokrenite integraciju ručno iz Cloud Storage > Konfiguracija > Konfiguracija > gumb „Launch sync“.

Korisna AWS dokumentacija: stvaranje S3 bucketa: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, upravljanje IAM ključevima pristupa: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Primjer bucket politike

Amazon S3 ima važnu osobitost: URL prikazan u Odoo uvijek je poveznica na strani Amazona.

Ako je Use Public URLs uključeno, Odoo sprema izravni URL S3 objekta. Poveznica radi samo ako su povezani S3 bucket, prefiks, objekt, CDN ili kompatibilna krajnja točka javno čitljivi. Inače Amazon S3 prikazuje AccessDenied, čak i ako je korisnik prijavljen u AWS konzolu.

Za javne poveznice konfigurirajte dopuštenja bucketa u Amazon S3 i dopustite javno čitanje za prefiks Odoo. Primjer pravila bucketa:

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

Zamijenite YOUR_BUCKET_NAME stvarnim imenom bucket-a i Odoo/ odabranim prefiksom korijenske mape. Također provjerite da postavke Amazon S3 Block public access ne blokiraju tu bucket politiku.

Ako je Use Public URLs isključeno, Odoo sprema AWS Console poveznice na povezani bucket objekt ili prefiks. Takve su poveznice korisne Amazon korisnicima: onaj tko otvara mora biti prijavljen na AWS i imati IAM pristup tom objektu. Ako korisnik nema AWS pristup, Amazon neće otvoriti datoteku.

1. Pripremite pokrenuti MinIO poslužitelj
2. Otvorite MinIO konzolu
3. Stvorite novi bucket ili odaberite postojeći. Kopirajte točan naziv bucketa: treba ga unijeti u Odoo u polje 'Bucket'
4. Stvorite vjerodajnice pristupa za Odoo. U MinIO-u koristite par access key / secret key ili servisni račun s pravima nabrajanja, čitanja, stvaranja, pisanja, kopiranja i brisanja objekata u odabranom bucketu
5. Kopirajte MinIO Access Key u Odoo polje „Access Key“
6. Kopirajte MinIO Secret Key u Odoo polje „Secret Key“. Važno: spremite tajnu prije zatvaranja MinIO stranice ako je MinIO pokazuje samo jednom
7. Kopirajte URL MinIO S3 API krajnje točke u Odoo u polje „Amazon S3 endpoint URL“. Na primjer, lokalni poslužitelj obično koristi http://localhost:9000, a produkcijski može koristiti https://minio.example.com
8. Idite na Odoo Cloud Storage > Configuration > Cloud Clients i pritisnite 'Create'
9. Kao referencu unesite naziv jasan svim korisnicima
10. Kao Cloud klijent odaberite «MinIO»
11. Kao naziv Root folder unesite naslov koji će se koristiti kao nadređeni MinIO object prefix za sve sinkronizirane mape. Na primjer, 'Odoo' ili 'OdooERP'
12. Ispunite polja 'Bucket', 'Access Key', 'Secret Key' i 'Amazon S3 endpoint URL'. Polje 'Region' je za MinIO neobavezno; ako je prazno, Odoo za S3-kompatibilno potpisivanje koristi us-east-1
13. Zadržite stil adresiranja Path-style. To je preporučena opcija za MinIO krajnje točke, osobito kad MinIO host ne daje DNS imena po bucketu
14. Odaberite treba li Odoo koristiti izravne javne MinIO URL-ove. Uključite „Use Public URLs“ samo kada su bucket, prefix, reverzni proxy ili CDN javno čitljivi. Za privatne MinIO buckete ostavite isključeno
15. Pritisnite 'Confirm'. Odoo provjerava pristup bucketu i stvara ili potvrđuje prefiks korijenske mape. Sinkronizacija MinIO - Odoo spremna je za izvođenje
16. Primijenite novo stvoreni cloud client na pravila mapa i/ili ručne mape koje treba sinkronizirati s tim MinIO bucketom
17. Pričekajte da se pokrene zakazani posao sinkronizacije. Samo u svrhu testiranja: pokrenite integraciju ručno iz Cloud Storage > Konfiguracija > Konfiguracija > gumb „Launch sync“.

Korisna 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.