Amazon S3 / MinIO Odoo Integration v.19

Työkalu riippuu ulkoisesta kirjastosta 'boto3'. Asenna se Odoo-palvelimelle komennolla:

1. Ota käyttöön 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). Lisäosa Amazon S3 Odoo Integration vaaditaan
2. Avaa Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Luo uusi bucket tai valitse olemassa oleva. Kopioi tarkka bucket-nimi: se syötetään Odoon kenttään 'Bucket'
4. Avaa bucketin tiedot ja kopioi AWS Region. Syötä se Odoon kenttään 'Region' (esim. eu-west-1 tai us-east-1)
5. Avaa AWS IAM Console: https://console.aws.amazon.com/iam/
6. Luo uusi IAM-käyttäjä tai valitse olemassa oleva tekninen käyttäjä. Käyttäjällä pitää olla täydet oikeudet listata, lukea, luoda, kirjoittaa, kopioida ja poistaa objekteja valitussa bucketissa. Voit valita täyden adminin tai luoda uuden käytännön (katso alla)
7. IAM-käyttäjälomakkeessa avaa välilehti 'Security credentials' ja paina 'Create access key'
8. Sivulla 'Access key best practices & alternatives' valitse Application running outside AWS. Tämä on oikea, kun Odoo-palvelin yhdistää S3:een avaimella AWS:n ulkopuolelta, Odoo.sh:sta, omalta palvelimelta tai toiselta hostilta. Jos Odoo on AWS EC2:ssa, voit valita Application running on an AWS compute service; Odooseen kopioitavat kentät ovat samat
9. Paina 'Next'. Seuraavassa vaiheessa voit antaa kuvauksen kuten Odoo S3 Sync ja painaa 'Create access key'
10. Viimeisellä AWS-sivulla kopioi Access key tai Access key ID Odoon kenttään 'Access Key'
11. Kopioi Secret access key Odoon kenttään 'Secret Key'. Tärkeää: AWS näyttää salaisen avaimen vain kerran, tallenna se ennen ikkunan sulkemista
12. Jos käytät S3-yhteensopivaa palvelua AWS S3:n sijaan, kopioi endpoint-URL hallintapaneelista Odoon kenttään 'Amazon S3 endpoint URL'. MinIO käyttää usein https://minio.example.com tai http://localhost:9000; LocalStack yleensä http://localhost:4566
13. Siirry Odoo Cloud Storage > Configuration > Cloud Clients ja paina 'Create'
14. Viitteeksi anna nimi, joka on selvä kaikille käyttäjille
15. Cloud clientiksi valitse 'Amazon S3'
16. Root folder nameksi anna otsikko, jota käytetään kaikkien synkronoitujen kansioiden S3-etuliitteenä. Esim. 'Odoo' tai 'OdooERP'
17. Täytä kentät 'Bucket', 'Region', 'Access Key', 'Secret Key' ja tarvittaessa 'Amazon S3 endpoint URL' sekä addressing style
18. Valitse, käyttääkö Odoo tilapäisiä presigned-URL:ia vai julkisia bucket/CDN-URL:ia. Yksityisissä bucketeissa pidä presigned-URL:t päällä ja aseta elinikä sekunteina
19. Paina 'Confirm'. Odoo tarkistaa bucket-käytön ja luo tai varmistaa juurikansion etuliitteen. Amazon S3 - Odoo -synkronointi on valmis
20. Käytä uutta cloud clientia kansiosääntöihin ja/tai manuaalisiin kansioihin, jotka synkronoidaan kyseiseen Amazon S3 -bucketiin
21. Odota ajastetun synkronointityön käynnistymistä. Vain testausta varten: käynnistä integraatio manuaalisesti Cloud Storage > Configuration > Configuration > painikkeesta 'Launch sync'.

Hyödyllinen AWS-dokumentaatio: S3-bucketin luonti: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM-käyttöavainten hallinta: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Esimerkki bucket-käytännöstä

Amazon S3:lla on tärkeä erityispiirre: Odoossa näkyvä URL on aina Amazonin puolen linkki.

Jos Use Public URLs on päällä, Odoo tallentaa suoran S3-objektin URL:n. Linkki toimii vain, jos bucket, etuliite, objekti, CDN tai yhteensopiva endpoint on julkisesti luettavissa. Muuten Amazon S3 näyttää AccessDenied, vaikka käyttäjä olisi kirjautunut AWS-konsoliin.

Julkisille linkeille määritä bucket-oikeudet Amazon S3:ssa ja salli julkinen luku Odoo-etuliitteelle. Esimerkki bucket-käytännöstä:

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

Korvaa YOUR_BUCKET_NAME todellisella bucket-nimellä ja Odoo/ valitulla juurikansion etuliitteellä. Varmista myös, etteivät Amazon S3 Block public access -asetukset estä tätä bucket-käytäntöä.

Jos Use Public URLs on pois, Odoo tallentaa AWS Console -linkit liittyvään bucket-objektiin tai etuliitteeseen. Linkit sopivat Amazon-käyttäjille: avaajan pitää olla kirjautunut AWS:ään ja olla IAM-oikeus objektiin. Ilman AWS-pääsyä Amazon ei avaa tiedostoa.

1. Valmistele käynnissä oleva MinIO-palvelin
2. Avaa MinIO Console
3. Luo uusi bucket tai valitse olemassa oleva. Kopioi tarkka bucket-nimi: se syötetään Odoon kenttään 'Bucket'
4. Luo Odoolle käyttöoikeustiedot. MinIO:ssa käytä access key / secret key -paria tai palvelutiliä, jolla on oikeus listata, lukea, luoda, kirjoittaa, kopioida ja poistaa objekteja valitussa bucketissa
5. Kopioi MinIO Access Key Odoon kenttään 'Access Key'
6. Kopioi MinIO Secret Key Odoon kenttään 'Secret Key'. Tärkeää: tallenna salaisuus ennen MinIO-sivun sulkemista, jos se näytetään vain kerran
7. Kopioi MinIO S3 API -endpoint-URL Odoon kenttään 'Amazon S3 endpoint URL'. Paikallinen palvelin käyttää yleensä http://localhost:9000, tuotanto voi käyttää https://minio.example.com
8. Siirry Odoo Cloud Storage > Configuration > Cloud Clients ja paina 'Create'
9. Viitteeksi anna nimi, joka on selvä kaikille käyttäjille
10. Cloud clientiksi valitse 'MinIO'
11. Root folder nameksi anna otsikko, jota käytetään kaikkien synkronoitujen kansioiden MinIO-etuliitteenä. Esim. 'Odoo' tai 'OdooERP'
12. Täytä kentät 'Bucket', 'Access Key', 'Secret Key' ja 'Amazon S3 endpoint URL'. 'Region' on valinnainen MinIO:lle; tyhjänä Odoo käyttää us-east-1 S3-yhteensopivaan allekirjoitukseen
13. Pidä addressing style Path-style. Se on suositus MinIO-endpointeille, etenkin jos MinIO-isäntä ei tarjoa bucket-kohtaisia DNS-nimiä
14. Valitse, käyttääkö Odoo suoria julkisia MinIO-URL:ia. Ota 'Use Public URLs' käyttöön vain, jos bucket, etuliite, reverse proxy tai CDN on julkisesti luettavissa. Yksityisissä MinIO-bucketeissa jätä pois
15. Paina 'Confirm'. Odoo tarkistaa bucket-käytön ja luo tai varmistaa juurikansion etuliitteen. MinIO - Odoo -synkronointi on valmis
16. Käytä uutta cloud clientia kansiosääntöihin ja/tai manuaalisiin kansioihin, jotka synkronoidaan kyseiseen MinIO-bucketiin
17. Odota ajastetun synkronointityön käynnistymistä. Vain testausta varten: käynnistä integraatio manuaalisesti Cloud Storage > Configuration > Configuration > painikkeesta 'Launch sync'.

Hyödyllinen MinIO-dokumentaatio: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.