Amazon S3 / MinIO Odoo Integration v.19

Az eszköz a külső 'boto3' könyvtártól függ. Telepítse az Odoo-szerverre ezzel a paranccsal:

1. Kapcsolja be a 'Amazon S3 Sync' opciót (Cloud Storage > Konfiguráció > Konfiguráció). Az opcionális bővítmény Amazon S3 Odoo Integration szükséges
2. Nyissa meg az Amazon S3 Console-t: https://console.aws.amazon.com/s3/
3. Hozzon létre új bucketet, vagy válasszon egy meglévőt. Másolja a pontos bucketnevet: ezt kell az Odoo 'Bucket' mezőjébe beírni
4. Nyissa meg a bucket részleteit, és másolja az AWS Region értékét. Illessze be az Odoo 'Region' mezőjébe (például eu-west-1 vagy us-east-1)
5. Nyissa meg az AWS IAM Console-t: https://console.aws.amazon.com/iam/
6. Hozzon létre új IAM-felhasználót, vagy válasszon egy meglévő technikai felhasználót. Ennek teljes joga legyen listázni, olvasni, létrehozni, írni, másolni és törölni objektumokat a kiválasztott bucketben. Választhat teljes admin jogot, vagy új szabályzatot hozhat létre (lásd alább)
7. Az IAM felhasználó űrlapon nyissa meg a 'Security credentials' lapot, és nyomja meg a 'Create access key' gombot
8. Az 'Access key best practices & alternatives' oldalon válassza a Application running outside AWS opciót. Ez a helyes, ha az Odoo szerver hozzáférési kulccsal csatlakozik az S3-hoz AWS-en kívülről, Odoo.sh-ról, saját szerverről vagy más szolgáltatótól. Ha az Odoo AWS EC2 példányon fut, választhatja a Application running on an AWS compute service opciót, de az Odoo-ba másolt mezők azonosak
9. Nyomja meg a 'Next' gombot. A következő lépésben opcionálisan adjon leírócímkét, például Odoo S3 Sync, majd nyomja meg a 'Create access key' gombot
10. Az utolsó AWS oldalon másolja a Access key vagy Access key ID értéket az Odoo 'Access Key' mezőjébe
11. Másolja a Secret access key értékét az Odoo 'Secret Key' mezőjébe. Fontos: az AWS a titkos kulcsot csak egyszer mutatja, mentse el az ablak bezárása előtt
12. Ha AWS S3 helyett S3-kompatibilis szolgáltatót használ, másolja az endpoint URL-t a szolgáltató adminfelületéről, és illessze be az Odoo 'Amazon S3 endpoint URL' mezőjébe. A MinIO például gyakran https://minio.example.com vagy http://localhost:9000 URL-t használ; a LocalStack általában http://localhost:4566
13. Lépjen az Odoo Cloud Storage > Konfiguráció > Cloud Clients menübe, és nyomja meg a 'Create' gombot
14. Referenciaként adjon egy nevet, amely minden felhasználónak egyértelmű
15. Cloud kliensként válassza az 'Amazon S3' lehetőséget
16. Gyökérmappa névként adjon meg egy címet, amely az összes szinkronizált mappa szülő S3 előtagja lesz. Például 'Odoo' vagy 'OdooERP'
17. Töltse ki a 'Bucket', 'Region', 'Access Key', 'Secret Key' mezőket, és szükség esetén az 'Amazon S3 endpoint URL' és addressing style mezőket
18. Válassza ki, hogy az Odoo ideiglenes presigned URL-eket vagy nyilvános bucket/CDN URL-eket használjon. Privát bucketeknél tartsa bekapcsolva a presigned URL-eket, és állítsa be az élettartamukat másodpercben
19. Nyomja meg a 'Confirm' gombot. Az Odoo ellenőrzi a bucket-hozzáférést, és létrehozza vagy ellenőrzi a gyökérmappa előtagot. Az Amazon S3 - Odoo szinkronizálás készen áll
20. Alkalmazza az új felhőklientet azokra a mappaszabályokra és/vagy kézi mappákra, amelyeket ehhez az Amazon S3 buckethez kell szinkronizálni
21. Várja meg a tervezett szinkronfeladat indítását. Csak teszteléshez: indítsa az integrációt kézzel a Cloud Storage > Konfiguráció > Konfiguráció > 'Launch sync' gombról.

Hasznos AWS dokumentáció: S3 bucket létrehozása: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM hozzáférési kulcsok kezelése: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Bucket szabályzat példa

Az Amazon S3 fontos sajátossága: az Odoo-ban látható URL mindig Amazon-oldali hivatkozás.

Ha a Use Public URLs be van kapcsolva, az Odoo közvetlen S3 objektum-URL-t ment. Ez a hivatkozás csak akkor működik, ha a kapcsolódó S3 bucket, előtag, objektum, CDN vagy kompatibilis végpont nyilvánosan olvasható. Egyébként az Amazon S3 AccessDenied hibát mutat, akkor is, ha a felhasználó be van jelentkezve az AWS konzolba.

Nyilvános hivatkozásokhoz állítsa be a bucket jogosultságokat az Amazon S3-ban, és engedélyezze a nyilvános olvasást az Odoo előtaghoz. Példa bucket szabályzat:

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

Cserélje a YOUR_BUCKET_NAME értéket a valós bucketnévre, a Odoo/ értéket pedig a kiválasztott gyökérmappa előtagra. Ellenőrizze azt is, hogy az Amazon S3 Block public access beállításai ne blokkolják ezt a bucket szabályzatot.

Ha a Use Public URLs ki van kapcsolva, az Odoo AWS Console hivatkozásokat ment a kapcsolódó bucket objektumra vagy előtagra. Ezek Amazon-felhasználóknak hasznosak: a hivatkozást megnyitónak be kell jelentkeznie az AWS-be, és IAM-hozzáférése kell legyen a bucket objektumhoz. AWS-hozzáférés nélkül az Amazon nem nyitja meg a fájlt.

1. Készítsen elő egy futó MinIO szervert
2. Nyissa meg a MinIO Console-t
3. Hozzon létre új bucketet, vagy válasszon egy meglévőt. Másolja a pontos bucketnevet: ezt kell az Odoo 'Bucket' mezőjébe beírni
4. Hozzon létre hozzáférési adatokat az Odoo-hoz. A MinIO-ban használjon access key / secret key párt vagy olyan szolgáltatásfiókot, amely listázhat, olvashat, létrehozhat, írhat, másolhat és törölhet objektumokat a kiválasztott bucketben
5. Másolja a MinIO Access Key értékét az Odoo 'Access Key' mezőjébe
6. Másolja a MinIO Secret Key értékét az Odoo 'Secret Key' mezőjébe. Fontos: mentse a titkot a MinIO oldal bezárása előtt, ha a MinIO csak egyszer mutatja
7. Másolja a MinIO S3 API endpoint URL-t az Odoo 'Amazon S3 endpoint URL' mezőjébe. Helyi szerver általában http://localhost:9000, éles szerver lehet https://minio.example.com
8. Lépjen az Odoo Cloud Storage > Konfiguráció > Cloud Clients menübe, és nyomja meg a 'Create' gombot
9. Referenciaként adjon egy nevet, amely minden felhasználónak egyértelmű
10. Cloud kliensként válassza a 'MinIO' lehetőséget
11. Gyökérmappa névként adjon meg egy címet, amely az összes szinkronizált mappa szülő MinIO objektumelőtagja lesz. Például 'Odoo' vagy 'OdooERP'
12. Töltse ki a 'Bucket', 'Access Key', 'Secret Key' és 'Amazon S3 endpoint URL' mezőket. A 'Region' MinIO-nál opcionális; ha üres, az Odoo us-east-1 értéket használ S3-kompatibilis aláíráshoz
13. Tartsa az addressing style értékét Path-style. Ez ajánlott MinIO végpontokhoz, különösen ha a MinIO hoszt nem ad bucket-specifikus DNS-neveket
14. Válassza ki, hogy az Odoo közvetlen nyilvános MinIO URL-eket használjon-e. A 'Use Public URLs' opciót csak akkor kapcsolja be, ha a bucket, előtag, reverse proxy vagy CDN nyilvánosan olvasható. Privát MinIO bucketeknél hagyja kikapcsolva
15. Nyomja meg a 'Confirm' gombot. Az Odoo ellenőrzi a bucket-hozzáférést, és létrehozza vagy ellenőrzi a gyökérmappa előtagot. A MinIO - Odoo szinkronizálás készen áll
16. Alkalmazza az új felhőklientet azokra a mappaszabályokra és/vagy kézi mappákra, amelyeket ehhez a MinIO buckethez kell szinkronizálni
17. Várja meg a tervezett szinkronfeladat indítását. Csak teszteléshez: indítsa az integrációt kézzel a Cloud Storage > Konfiguráció > Konfiguráció > 'Launch sync' gombról.

Hasznos MinIO dokumentáció: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.