Amazon S3 / MinIO Odoo Integration v.19

Das Tool hängt von der externen Bibliothek „boto3“ ab. Installieren Sie sie auf dem Odoo-Server mit:

1. Schalten Sie die Option 'Amazon S3 Sync' ein (Cloud Storage > Configuration > Configuration). Das optionale Add-on Amazon S3 Odoo Integration ist erforderlich
2. Öffnen Sie die Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Erstellen Sie einen neuen Bucket oder wählen Sie einen vorhandenen. Kopieren Sie den exakten Bucket-Namen: er wird in Odoo ins Feld 'Bucket' eingetragen
4. Öffnen Sie die Bucket-Details und kopieren Sie die AWS Region. Tragen Sie sie in Odoo ins Feld 'Region' ein (zum Beispiel eu-west-1 oder us-east-1)
5. Öffnen Sie die AWS IAM Console: https://console.aws.amazon.com/iam/
6. Erstellen Sie einen neuen IAM-Benutzer oder wählen Sie einen vorhandenen technischen Benutzer. Dieser Benutzer braucht volle Rechte zum Listen, Lesen, Erstellen, Schreiben, Kopieren und Löschen von Objekten im gewählten Bucket. Sie können den vollen Admin wählen oder eine neue Policy anlegen (siehe unten)
7. Im IAM-Benutzerformular öffnen Sie den Tab 'Security credentials' und klicken Sie auf 'Create access key'
8. Auf der Seite 'Access key best practices & alternatives' wählen Sie die Option Application running outside AWS. Das ist die richtige Option, wenn Ihr Odoo-Server per Access Key von außerhalb AWS, von Odoo.sh, von Ihrem eigenen Server oder einem anderen Hosting-Anbieter zu S3 verbindet. Wenn Odoo auf einer AWS EC2-Instanz läuft, können Sie stattdessen Application running on an AWS compute service wählen; die nach Odoo kopierten Felder sind dieselben
9. Klicken Sie auf 'Next'. Optional geben Sie im nächsten Schritt ein Beschreibungstag wie Odoo S3 Sync ein und klicken Sie dann auf 'Create access key'
10. Auf der letzten AWS-Seite kopieren Sie Access key oder Access key ID in das Odoo-Feld 'Access Key'
11. Kopieren Sie Secret access key in das Odoo-Feld 'Secret Key'. Wichtig: AWS zeigt den Secret Key nur einmal, speichern Sie ihn daher vor dem Schließen des Fensters
12. Wenn Sie einen S3-kompatiblen Anbieter statt AWS S3 nutzen, kopieren Sie die Endpoint-URL aus dessen Admin-Panel und tragen Sie sie in Odoo ins Feld 'Amazon S3 endpoint URL' ein. MinIO nutzt oft eine URL wie https://minio.example.com oder http://localhost:9000; LocalStack nutzt üblicherweise http://localhost:4566
13. Gehen Sie zu Odoo Cloud Storage > Configuration > Cloud Clients und klicken Sie auf 'Create'
14. Als Referenz geben Sie einen Namen ein, der für alle Benutzer klar ist
15. Als Cloud-Client wählen Sie 'Amazon S3'
16. Als Root folder name geben Sie einen Titel ein, der als übergeordnetes S3-Präfix für alle synchronisierten Ordner dient. Zum Beispiel 'Odoo' oder 'OdooERP'
17. Füllen Sie die Felder 'Bucket', 'Region', 'Access Key', 'Secret Key' und bei Bedarf 'Amazon S3 endpoint URL' sowie den Addressing-Style
18. Wählen Sie, ob Odoo temporäre presigned URLs oder öffentliche Bucket-/CDN-URLs nutzen soll. Für private Buckets lassen Sie presigned URLs aktiv und setzen Sie deren Lebensdauer in Sekunden
19. Klicken Sie auf 'Confirm'. Odoo prüft den Bucket-Zugriff und erstellt oder verifiziert das Root-Ordner-Präfix. Die Amazon S3-Odoo-Synchronisierung ist bereit
20. Wenden Sie den neu erstellten Cloud-Client auf Ordnerregeln und/oder manuelle Ordner an, die mit diesem Amazon S3-Bucket synchronisiert werden sollen
21. Warten Sie, bis der geplante Sync-Job startet. Nur zu Testzwecken: starten Sie die Integration manuell unter Cloud Storage > Configuration > Configuration > der Schaltfläche 'Launch sync'.

Nützliche AWS-Dokumentation: S3-Bucket anlegen: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM Access Keys verwalten: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Beispiel einer Bucket Policy

Amazon S3 hat eine wichtige Besonderheit: die in Odoo gezeigte URL ist immer ein Amazon-seitiger Link.

Ist Use Public URLs aktiv, speichert Odoo eine direkte S3-Objekt-URL. Der Link funktioniert nur, wenn Bucket, Präfix, Objekt, CDN oder kompatibler Endpunkt öffentlich lesbar sind. Sonst zeigt Amazon S3 AccessDenied, auch wenn der Benutzer an der AWS-Konsole angemeldet ist.

Für öffentliche Links Bucket-Berechtigungen in Amazon S3 konfigurieren und öffentlichen Lesezugriff für das Odoo-Präfix erlauben. Beispiel-Bucket-Policy:

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

Ersetzen Sie YOUR_BUCKET_NAME durch den echten Bucket-Namen und Odoo/ durch das gewählte Root-Ordnerpräfix. Stellen Sie außerdem sicher, dass Amazon-S3-Block public access diese Policy nicht blockiert.

Ist Use Public URLs aus, speichert Odoo AWS-Console-Links zum Bucket-Objekt oder -Präfix. Sie helfen Amazon-Nutzern: wer den Link öffnet, muss bei AWS angemeldet sein und IAM-Zugriff auf das Objekt haben. Ohne AWS-Zugang öffnet Amazon die Datei nicht.

1. Bereiten Sie einen laufenden MinIO-Server vor
2. Öffnen Sie die MinIO Console
3. Erstellen Sie einen neuen Bucket oder wählen Sie einen vorhandenen. Kopieren Sie den exakten Bucket-Namen: er wird in Odoo ins Feld 'Bucket' eingetragen
4. Erstellen Sie Zugangsdaten für Odoo. In MinIO nutzen Sie ein Access-Key-/Secret-Key-Paar oder ein Servicekonto mit Rechten zum Listen, Lesen, Erstellen, Schreiben, Kopieren und Löschen von Objekten im gewählten Bucket
5. Kopieren Sie den MinIO-Access Key in das Odoo-Feld 'Access Key'
6. Kopieren Sie den MinIO-Secret Key in das Odoo-Feld 'Secret Key'. Wichtig: speichern Sie das Secret, bevor Sie die MinIO-Seite schließen, falls MinIO es nur einmal zeigt
7. Kopieren Sie die MinIO-S3-API-Endpoint-URL in Odoo ins Feld 'Amazon S3 endpoint URL'. Ein lokaler Server nutzt üblicherweise http://localhost:9000, ein Produktionsserver kann https://minio.example.com nutzen
8. Gehen Sie zu Odoo Cloud Storage > Configuration > Cloud Clients und klicken Sie auf 'Create'
9. Als Referenz geben Sie einen Namen ein, der für alle Benutzer klar ist
10. Als Cloud-Client wählen Sie 'MinIO'
11. Als Root folder name geben Sie einen Titel ein, der als übergeordnetes MinIO-Objektpräfix für alle synchronisierten Ordner dient. Zum Beispiel 'Odoo' oder 'OdooERP'
12. Füllen Sie die Felder 'Bucket', 'Access Key', 'Secret Key' und 'Amazon S3 endpoint URL'. Das Feld 'Region' ist für MinIO optional; wenn es leer ist, nutzt Odoo us-east-1 für S3-kompatibles Signing
13. Lassen Sie den Addressing-Style auf Path-style. Das ist die empfohlene Option für MinIO-Endpunkte, besonders wenn der MinIO-Host keine bucket-spezifischen DNS-Namen bereitstellt
14. Wählen Sie, ob Odoo direkte öffentliche MinIO-URLs nutzen soll. Aktivieren Sie 'Use Public URLs' nur, wenn Bucket, Präfix, Reverse Proxy oder CDN öffentlich lesbar sind. Für private MinIO-Buckets lassen Sie es deaktiviert
15. Klicken Sie auf 'Confirm'. Odoo prüft den Bucket-Zugriff und erstellt oder verifiziert das Root-Ordner-Präfix. Die MinIO-Odoo-Synchronisierung ist bereit
16. Wenden Sie den neu erstellten Cloud-Client auf Ordnerregeln und/oder manuelle Ordner an, die mit diesem MinIO-Bucket synchronisiert werden sollen
17. Warten Sie, bis der geplante Sync-Job startet. Nur zu Testzwecken: starten Sie die Integration manuell unter Cloud Storage > Configuration > Configuration > der Schaltfläche 'Launch sync'.

Nützliche 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.