Amazon S3 / MinIO Odoo Integration v.19

Verktøyet avhenger av det eksterne biblioteket 'boto3'. Installer det på Odoo-serveren med kommandoen:

1. Slå på valget 'Amazon S3 Sync' (Cloud Storage > Konfigurasjon > Konfigurasjon). Tillegget Amazon S3 Odoo Integration kreves
2. Åpne Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Opprett en ny bucket eller velg en eksisterende. Kopier det nøyaktige bucketnavnet: det skal settes inn i Odoo i feltet 'Bucket'
4. Åpne bucketdetaljene og kopier AWS-regionen. Sett den inn i Odoo i feltet 'Region' (for eksempel eu-west-1 eller us-east-1)
5. Åpne AWS IAM Console: https://console.aws.amazon.com/iam/
6. Opprett en ny IAM-bruker eller velg en eksisterende teknisk bruker. Brukeren må ha fulle rettigheter til å liste, lese, opprette, skrive, kopiere og slette objekter i den valgte bucketen. Du kan velge full adminrettighet eller opprette en ny policy (se nedenfor)
7. I IAM-brukerskjemaet åpner du fanen 'Security credentials' og trykker 'Create access key'
8. På siden 'Access key best practices & alternatives' velger du Application running outside AWS. Dette er riktig når Odoo-serveren kobler til S3 med tilgangsnøkkel utenfor AWS, fra Odoo.sh, fra din egen server eller fra en annen vert. Hvis Odoo kjører på en AWS EC2-instans, kan du i stedet velge Application running on an AWS compute service, men feltene som kopieres til Odoo er de samme
9. Trykk 'Next'. I neste steg kan du valgfritt angi en beskrivelsestagg som Odoo S3 Sync, og deretter trykke 'Create access key'
10. På den siste AWS-siden kopierer du Access key eller Access key ID til Odoo-feltet 'Access Key'
11. Kopier Secret access key til Odoo-feltet 'Secret Key'. Viktig: AWS viser den hemmelige nøkkelen bare én gang, så lagre den før du lukker vinduet
12. Hvis du bruker en S3-kompatibel leverandør i stedet for AWS S3, kopier endepunkt-URL-en fra leverandørens adminpanel og sett den inn i Odoo i feltet 'Amazon S3 endpoint URL'. For eksempel bruker MinIO ofte en URL som https://minio.example.com eller http://localhost:9000; LocalStack bruker vanligvis http://localhost:4566
13. Gå til Odoo Cloud Storage > Konfigurasjon > Cloud Clients og trykk 'Create'
14. Som referanse, gi et navn som er tydelig for alle brukere
15. Som Cloud-klient velger du 'Amazon S3'
16. Som rotmappenavn skriver du en tittel som brukes som overordnet S3-prefiks for alle synkroniserte mapper. For eksempel 'Odoo' eller 'OdooERP'
17. Fyll ut feltene 'Bucket', 'Region', 'Access Key', 'Secret Key' og ved behov 'Amazon S3 endpoint URL' og addressing style
18. Velg om Odoo skal bruke midlertidige forhåndssignerte URL-er eller offentlige bucket-/CDN-URL-er. For private buckets, behold forhåndssignerte URL-er på og sett levetiden i sekunder
19. Trykk 'Confirm'. Odoo sjekker buckettilgang og oppretter eller bekrefter rotmappeprefikset. Amazon S3 - Odoo-synkronisering er klar
20. Knytt den nye skyklienten til mapperegler og/eller manuelle mapper som skal synkroniseres til den Amazon S3-bucketen
21. Vent til den planlagte synkjobben starter. Kun til testing: utløs integrasjonen manuelt fra Cloud Storage > Konfigurasjon > Konfigurasjon > knappen 'Launch sync'.

Nyttig AWS-dokumentasjon: opprette en S3-bucket: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, administrere IAM-tilgangsnøkler: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Eksempel på bucketpolicy

Amazon S3 har en viktig særegenhet: URL-en som vises i Odoo, er alltid en Amazon-side-lenke.

Hvis Use Public URLs er slått på, lagrer Odoo en direkte S3-objekt-URL. Lenken virker bare hvis den relaterte S3-bucketen, prefikset, objektet, CDN-en eller det kompatible endepunktet er offentlig lesbart. Ellers viser Amazon S3 AccessDenied, selv om brukeren er logget inn i AWS-konsollen.

For offentlige lenker, konfigurer bucket-tillatelsene i Amazon S3 og tillat offentlig lesing for Odoo-prefikset. Eksempel på bucketpolicy:

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

Erstatt YOUR_BUCKET_NAME med det virkelige bucketnavnet og Odoo/ med det valgte rotmappeprefikset. Sørg også for at innstillingene Amazon S3 Block public access ikke blokkerer den bucketpolicyen.

Hvis Use Public URLs er slått av, lagrer Odoo AWS Console-lenker til det relaterte bucketobjektet eller prefikset. Slike lenker er nyttige for Amazon-brukere: den som åpner lenken, må være logget inn i AWS og ha IAM-tilgang til det bucketobjektet. Uten AWS-tilgang åpner ikke Amazon filen.

1. Klargjør en kjørende MinIO-server
2. Åpne MinIO Console
3. Opprett en ny bucket eller velg en eksisterende. Kopier det nøyaktige bucketnavnet: det skal settes inn i Odoo i feltet 'Bucket'
4. Opprett tilgangslegitimasjon for Odoo. I MinIO bruker du et par med tilgangsnøkkel / hemmelig nøkkel eller en tjenestekonto med rettigheter til å liste, lese, opprette, skrive, kopiere og slette objekter i den valgte bucketen
5. Kopier MinIO Access Key til Odoo-feltet 'Access Key'
6. Kopier MinIO Secret Key til Odoo-feltet 'Secret Key'. Viktig: lagre hemmeligheten før du lukker MinIO-siden hvis MinIO viser den bare én gang
7. Kopier MinIO S3 API-endepunkt-URL-en til Odoo i feltet 'Amazon S3 endpoint URL'. En lokal server bruker vanligvis http://localhost:9000, mens en produksjonsserver kan bruke https://minio.example.com
8. Gå til Odoo Cloud Storage > Konfigurasjon > Cloud Clients og trykk 'Create'
9. Som referanse, gi et navn som er tydelig for alle brukere
10. Som Cloud-klient velger du 'MinIO'
11. Som rotmappenavn skriver du en tittel som brukes som overordnet MinIO-objektprefiks for alle synkroniserte mapper. For eksempel 'Odoo' eller 'OdooERP'
12. Fyll ut feltene 'Bucket', 'Access Key', 'Secret Key' og 'Amazon S3 endpoint URL'. Feltet 'Region' er valgfritt for MinIO; hvis det er tomt, bruker Odoo us-east-1 til S3-kompatibel signering
13. Behold addressing style som Path-style. Dette anbefales for MinIO-endepunkter, særlig når MinIO-verten ikke gir bucket-spesifikke DNS-navn
14. Velg om Odoo skal bruke direkte offentlige MinIO-URL-er. Slå på 'Use Public URLs' bare når bucket, prefiks, reversproxy eller CDN er offentlig lesbart. For private MinIO-buckets, la det stå av
15. Trykk 'Confirm'. Odoo sjekker buckettilgang og oppretter eller bekrefter rotmappeprefikset. MinIO - Odoo-synkronisering er klar
16. Knytt den nye skyklienten til mapperegler og/eller manuelle mapper som skal synkroniseres til den MinIO-bucketen
17. Vent til den planlagte synkjobben starter. Kun til testing: utløs integrasjonen manuelt fra Cloud Storage > Konfigurasjon > Konfigurasjon > knappen 'Launch sync'.

Nyttig MinIO-dokumentasjon: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.