Amazon S3 / MinIO Odoo Integration v.19

Værktøjet afhænger af det eksterne bibliotek 'boto3'. Installer det på Odoo-serveren med kommandoen:

1. Slå indstillingen 'Amazon S3 Sync' til (Cloud Storage > Konfiguration > Konfiguration). Tillægsmodulet Amazon S3 Odoo Integration er påkrævet
2. Åbn Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Opret en ny bucket, eller vælg en eksisterende. Kopiér det nøjagtige bucketnavn: det skal indsættes i Odoo i feltet 'Bucket'
4. Åbn bucketoplysningerne, og kopiér AWS-regionen. Indsæt den i Odoo i feltet 'Region' (f.eks. eu-west-1 eller us-east-1)
5. Åbn AWS IAM Console: https://console.aws.amazon.com/iam/
6. Opret en ny IAM-bruger, eller vælg en eksisterende teknisk bruger. Brugeren skal have fulde rettigheder til at liste, læse, oprette, skrive, kopiere og slette objekter i den valgte bucket. Du kan vælge fuld adminret, eller oprette en ny politik (se nedenfor)
7. I IAM-brugerformularen skal du åbne fanen 'Security credentials' og trykke 'Create access key'
8. På siden 'Access key best practices & alternatives' skal du vælge Application running outside AWS. Det er korrekt, når Odoo-serveren forbinder til S3 med adgangsnøgle uden for AWS, fra Odoo.sh, fra din egen server eller en anden vært. Hvis Odoo kører på en AWS EC2-instans, kan du i stedet vælge Application running on an AWS compute service, men felterne der kopieres til Odoo er de samme
9. Tryk 'Next'. I næste trin kan du valgfrit angive et beskrivelsesmærke som Odoo S3 Sync og derefter trykke 'Create access key'
10. På den sidste AWS-side skal du kopiere Access key eller Access key ID til Odoo-feltet 'Access Key'
11. Kopiér Secret access key til Odoo-feltet 'Secret Key'. Vigtigt: AWS viser den hemmelige nøgle kun én gang, så gem den, før du lukker vinduet
12. Hvis du bruger en S3-kompatibel udbyder i stedet for AWS S3, skal du kopiere endpoint-URL'en fra udbyderens adminpanel og indsætte den i Odoo i feltet 'Amazon S3 endpoint URL'. MinIO bruger ofte en URL som https://minio.example.com eller http://localhost:9000; LocalStack bruger typisk http://localhost:4566
13. Gå til Odoo Cloud Storage > Konfiguration > Cloud Clients, og tryk 'Create'
14. Som reference skal du angive et navn, der er tydeligt for alle brugere
15. Som cloud-klient skal du vælge 'Amazon S3'
16. Som rodmappenavn skal du angive en titel, der bruges som overordnet S3-præfiks for alle synkroniserede mapper. F.eks. 'Odoo' eller 'OdooERP'
17. Udfyld felterne 'Bucket', 'Region', 'Access Key', 'Secret Key' og om nødvendigt 'Amazon S3 endpoint URL' og addressing style
18. Vælg, om Odoo skal bruge midlertidige presigned URL'er eller offentlige bucket-/CDN-URL'er. For private buckets skal du holde presigned URL'er slået til og indstille levetiden i sekunder
19. Tryk 'Confirm'. Odoo tjekker bucketadgang og opretter eller bekræfter rodmappens præfiks. Amazon S3 - Odoo-synkronisering er klar
20. Anvend den nye cloud-klient på mapperegler og/eller manuelle mapper, der skal synkroniseres til den Amazon S3-bucket
21. Vent på, at det planlagte synkjob starter. Kun til test: udløs integrationen manuelt fra Cloud Storage > Konfiguration > Konfiguration > knappen 'Launch sync'.

Nyttig AWS-dokumentation: opret en S3-bucket: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, administration af IAM-adgangsnøgler: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Eksempel på bucketpolitik

Amazon S3 har en vigtig særhed: URL'en vist i Odoo er altid et Amazon-sidelink.

Hvis Use Public URLs er slået til, gemmer Odoo en direkte S3-objekt-URL. Linket virker kun, hvis den relaterede S3-bucket, præfiks, objekt, CDN eller kompatible endpoint er offentligt læsbart. Ellers viser Amazon S3 AccessDenied, også hvis brugeren er logget ind i AWS-konsollen.

Til offentlige links skal du konfigurere bucket-tilladelserne i Amazon S3 og tillade offentlig læsning for Odoo-præfikset. Eksempel på bucketpolitik:

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

Erstat YOUR_BUCKET_NAME med det rigtige bucketnavn og Odoo/ med det valgte rodmappepræfiks. Sørg også for, at Amazon S3 Block public access-indstillingerne ikke blokerer den bucketpolitik.

Hvis Use Public URLs er slået fra, gemmer Odoo AWS Console-links til det relaterede bucketobjekt eller præfiks. Sådanne links er nyttige for Amazon-brugere: den, der åbner linket, skal være logget ind i AWS og have IAM-adgang til bucketobjektet. Uden AWS-adgang åbner Amazon ikke filen.

1. Klargør en kørende MinIO-server
2. Åbn MinIO Console
3. Opret en ny bucket, eller vælg en eksisterende. Kopiér det nøjagtige bucketnavn: det skal indsættes i Odoo i feltet 'Bucket'
4. Opret adgangslegitimationsoplysninger til Odoo. I MinIO skal du bruge et access key / secret key-par eller en tjenestekonto med rettigheder til at liste, læse, oprette, skrive, kopiere og slette objekter i den valgte bucket
5. Kopiér MinIO Access Key til Odoo-feltet 'Access Key'
6. Kopiér MinIO Secret Key til Odoo-feltet 'Secret Key'. Vigtigt: gem hemmeligheden, før du lukker MinIO-siden, hvis MinIO kun viser den én gang
7. Kopiér MinIO S3 API-endpoint-URL'en til Odoo i feltet 'Amazon S3 endpoint URL'. En lokal server bruger typisk http://localhost:9000, mens en produktionsserver kan bruge https://minio.example.com
8. Gå til Odoo Cloud Storage > Konfiguration > Cloud Clients, og tryk 'Create'
9. Som reference skal du angive et navn, der er tydeligt for alle brugere
10. Som cloud-klient skal du vælge 'MinIO'
11. Som rodmappenavn skal du angive en titel, der bruges som overordnet MinIO-objektpræfiks for alle synkroniserede mapper. F.eks. 'Odoo' eller 'OdooERP'
12. Udfyld felterne 'Bucket', 'Access Key', 'Secret Key' og 'Amazon S3 endpoint URL'. Feltet 'Region' er valgfrit for MinIO; hvis det er tomt, bruger Odoo us-east-1 til S3-kompatibel signering
13. Behold addressing style som Path-style. Det anbefales til MinIO-endpoints, især når MinIO-værten ikke stiller bucket-specifikke DNS-navne til rådighed
14. Vælg, om Odoo skal bruge direkte offentlige MinIO-URL'er. Aktivér 'Use Public URLs' kun, når bucket, præfiks, reverse proxy eller CDN er offentligt læsbart. For private MinIO-buckets skal du lade det være slået fra
15. Tryk 'Confirm'. Odoo tjekker bucketadgang og opretter eller bekræfter rodmappens præfiks. MinIO - Odoo-synkronisering er klar
16. Anvend den nye cloud-klient på mapperegler og/eller manuelle mapper, der skal synkroniseres til den MinIO-bucket
17. Vent på, at det planlagte synkjob starter. Kun til test: udløs integrationen manuelt fra Cloud Storage > Konfiguration > Konfiguration > knappen 'Launch sync'.

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