Amazon S3 / MinIO Odoo Integration v.19

Verktyget beror på det externa biblioteket 'boto3'. Installera det för Odoo-servern med kommandot:

1. Slå på alternativet 'Amazon S3 Sync' (Cloud Storage > Konfiguration > Konfiguration). Tillägget Amazon S3 Odoo Integration krävs
2. Öppna Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Skapa en ny bucket eller välj en befintlig. Kopiera det exakta bucketnamnet: det ska anges i Odoo-fältet 'Bucket'
4. Öppna bucketdetaljerna och kopiera AWS Region. Ange den i Odoo-fältet 'Region' (t.ex. eu-west-1 eller us-east-1)
5. Öppna AWS IAM Console: https://console.aws.amazon.com/iam/
6. Skapa en ny IAM-användare eller välj en befintlig teknisk användare. Användaren ska ha fulla rättigheter att lista, läsa, skapa, skriva, kopiera och radera objekt i den valda bucketen. Du kan välja full adminrätt eller skapa en ny policy (se nedan)
7. I IAM-användarformuläret öppnar du fliken 'Security credentials' och trycker 'Create access key'
8. På sidan 'Access key best practices & alternatives' väljer du Application running outside AWS. Det är rätt val när Odoo-servern ansluter till S3 med åtkomstnyckel utanför AWS, från Odoo.sh, från en egen server eller från en annan serverleverantör. Om Odoo körs på en AWS EC2-instans kan du i stället välja Application running on an AWS compute service; fälten som kopieras till Odoo är desamma
9. Tryck 'Next'. I nästa steg kan du valfritt ange en beskrivningstagg som Odoo S3 Sync och sedan trycka 'Create access key'
10. På sista AWS-sidan kopierar du Access key eller Access key ID till Odoo-fältet 'Access Key'
11. Kopiera Secret access key till Odoo-fältet 'Secret Key'. Viktigt: AWS visar den hemliga nyckeln bara en gång, så spara den innan fönstret stängs
12. Om du använder en S3-kompatibel leverantör i stället för AWS S3, kopiera slutpunkts-URL från leverantörens adminpanel och ange den i Odoo-fältet 'Amazon S3 endpoint URL'. MinIO använder ofta en URL som https://minio.example.com eller http://localhost:9000; LocalStack vanligen http://localhost:4566
13. Gå till Odoo Cloud Storage > Konfiguration > Cloud Clients och tryck 'Create'
14. Som referens anger du ett namn som är tydligt för alla användare
15. Som Cloud client väljer du 'Amazon S3'
16. Som Root folder name anger du en titel som blir överordnat S3-prefix för alla synkade mappar. Till exempel 'Odoo' eller 'OdooERP'
17. Fyll i fälten 'Bucket', 'Region', 'Access Key', 'Secret Key' och vid behov 'Amazon S3 endpoint URL' samt adresseringsstil
18. Välj om Odoo ska använda tillfälliga förhandssignerade URL:er eller publika bucket-/CDN-URL:er. För privata buckets, behåll förhandssignerade URL:er på och sätt livslängden i sekunder
19. Tryck 'Confirm'. Odoo kontrollerar bucketåtkomst och skapar eller verifierar rotmappens prefix. Amazon S3 – Odoo-synkronisering är redo att köras
20. Koppla den nyskapade molnklienten till mappregler och/eller manuella mappar som ska synkas till den Amazon S3-bucketen
21. Vänta tills det schemalagda synkjobbet startar. Endast för test: starta integrationen manuellt från Cloud Storage > Konfiguration > Konfiguration > knappen 'Launch sync'.

Användbar AWS-dokumentation: skapa en S3-bucket: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, hantera IAM-åtkomstnycklar: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Exempel på bucketpolicy

Amazon S3 har en viktig särart: URL:en som visas i Odoo är alltid en Amazon-länk.

Om Use Public URLs är aktiverat sparar Odoo en direkt S3-objekt-URL. Länken fungerar bara om den relaterade S3-bucketen, prefixet, objektet, CDN:en eller den kompatibla slutpunkten är publikt läsbar. Annars visar Amazon S3 AccessDenied, även om användaren är inloggad i AWS-konsolen.

För publika länkar, konfigurera bucketbehörigheter i Amazon S3 och tillåt publik läsåtkomst för Odoo-prefixet. Exempel på bucketpolicy:

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

Ersätt YOUR_BUCKET_NAME med det riktiga bucketnamnet och Odoo/ med det valda rotmappprefixet. Se också till att Amazon S3-inställningen Block public access inte blockerar den bucketpolicyn.

Om Use Public URLs är avstängt sparar Odoo AWS Console-länkar till det relaterade bucketobjektet eller prefixet. Sådana länkar är användbara för Amazon-användare: den som öppnar länken måste vara inloggad i AWS och ha IAM-åtkomst till det bucketobjektet. Utan AWS-åtkomst öppnar Amazon inte filen.

1. Förbered en körande MinIO-server
2. Öppna MinIO Console
3. Skapa en ny bucket eller välj en befintlig. Kopiera det exakta bucketnamnet: det ska anges i Odoo-fältet 'Bucket'
4. Skapa åtkomstuppgifter för Odoo. I MinIO använder du ett access key / secret key-par eller ett tjänstkonto med rätt att lista, läsa, skapa, skriva, kopiera och ta bort objekt i den valda bucketen
5. Kopiera MinIO Access Key till Odoo-fältet 'Access Key'
6. Kopiera MinIO-Secret Key till Odoo-fältet 'Secret Key'. Viktigt: spara hemligheten innan du stänger MinIO-sidan om MinIO visar den bara en gång
7. Kopiera MinIO S3 API-slutpunktens URL till Odoo-fältet 'Amazon S3 endpoint URL'. En lokal server använder till exempel oftast http://localhost:9000, medan en produktionsserver kan använda https://minio.example.com
8. Gå till Odoo Cloud Storage > Konfiguration > Cloud Clients och tryck 'Create'
9. Som referens anger du ett namn som är tydligt för alla användare
10. Som molnklient väljer du 'MinIO'
11. Som namn på rotmappen anger du en titel som används som överordnat MinIO-objektprefix för alla synkade mappar. Till exempel 'Odoo' eller 'OdooERP'
12. Fyll i fälten 'Bucket', 'Access Key', 'Secret Key' och 'Amazon S3 endpoint URL'. Fältet 'Region' är valfritt för MinIO; om det är tomt använder Odoo us-east-1 för S3-kompatibel signering
13. Behåll adresseringen som Path-style. Det är det rekommenderade valet för MinIO-slutpunkter, särskilt när MinIO-värden inte tillhandahåller bucket-specifika DNS-namn
14. Välj om Odoo ska använda direkta publika MinIO-URL:er. Aktivera 'Use Public URLs' bara när bucket, prefix, reverse proxy eller CDN är publikt läsbar. För privata MinIO-buckets lämnar du det avstängt
15. Tryck på 'Confirm'. Odoo kontrollerar bucketåtkomsten och skapar eller verifierar rotmappens prefix. Synkroniseringen MinIO - Odoo är redo att köras
16. Tillämpa den nyskapade molnklienten på mappregler och/eller manuella mappar som ska synkas till den MinIO-bucketen
17. Vänta tills det schemalagda synkjobbet startar. Endast för test: starta integrationen manuellt från Cloud Storage > Konfiguration > Konfiguration > knappen 'Launch sync'.

Användbar MinIO-dokumentation: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.