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 > Configuration > Configuration). 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 admin 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 när Odoo-servern ansluter till S3 med accessnyckel utanför AWS, från Odoo.sh, egen server eller annan host. Om Odoo körs på AWS EC2 kan du välja Application running on an AWS compute service; fälten som kopieras till Odoo är desamma
9. Tryck 'Next'. Nästa steg kan du ange en beskrivningstagg som Odoo S3 Sync och sedan '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, spara den innan fönstret stängs
12. Om du använder en S3-kompatibel leverantör istället för AWS S3, kopiera endpoint-URL från adminpanelen och ange den i Odoo-fältet 'Amazon S3 endpoint URL'. MinIO använder ofta https://minio.example.com eller http://localhost:9000; LocalStack brukar http://localhost:4566
13. Gå till Odoo Cloud Storage > Configuration > 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' och addressing style
18. Välj om Odoo ska använda tillfälliga presigned URL:er eller publika bucket/CDN-URL:er. För privata buckets, behåll presigned URL:er på och sätt livslängd i sekunder
19. Tryck 'Confirm'. Odoo kontrollerar bucketåtkomst och skapar eller verifierar rotmappens prefix. Amazon S3 - Odoo-synkronisering är redo
20. Tillämpa den nya cloud client på 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 > Configuration > Configuration > 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 på sparar Odoo en direkt S3-objekt-URL. Länken fungerar bara om bucket, prefix, objekt, CDN eller kompatibel endpoint ä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 valt rotmappprefix. Se också till att Amazon S3 Block public access inte blockerar den bucketpolicyn.

Om Use Public URLs är av sparar Odoo AWS Console-länkar till relaterat bucketobjekt eller prefix. Länkarna är användbara för Amazon-användare: den som öppnar måste vara inloggad i AWS och ha IAM-åtkomst till objektet. 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änd access key / secret key eller ett tjänstkonto med rätt att lista, läsa, skapa, skriva, kopiera och radera 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 den visas bara en gång
7. Kopiera MinIO S3 API-endpoint-URL till Odoo-fältet 'Amazon S3 endpoint URL'. En lokal server använder oftast http://localhost:9000, produktion kan använda https://minio.example.com
8. Gå till Odoo Cloud Storage > Configuration > Cloud Clients och tryck 'Create'
9. Som referens anger du ett namn som är tydligt för alla användare
10. Som Cloud client väljer du 'MinIO'
11. Som Root folder name anger du en titel som blir ö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'. 'Region' är valfritt för MinIO; om det är tomt använder Odoo us-east-1 för S3-kompatibel signering
13. Behåll addressing style som Path-style. Det rekommenderas för MinIO-endpoints, särskilt när MinIO-värden inte ger 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ämna det av
15. Tryck 'Confirm'. Odoo kontrollerar bucketåtkomst och skapar eller verifierar rotmappens prefix. MinIO - Odoo-synkronisering är redo
16. Tillämpa den nya cloud client 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 > Configuration > Configuration > 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.