Amazon S3 / MinIO Odoo Integration v.19

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

1. Ota käyttöön valinta 'Amazon S3 Sync' (Cloud Storage > Asetukset > Asetukset). Valinnainen lisäosa Amazon S3 Odoo Integration tarvitaan
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 Odoossa kenttään 'Bucket'
4. Avaa bucketin tiedot ja kopioi AWS Region. Syötä se Odoossa kenttään 'Region' (esimerkiksi 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ä. Tällä käyttäjällä tulee olla täydet oikeudet listata, lukea, luoda, kirjoittaa, kopioida ja poistaa objekteja valitussa bucketissa. Voit valita täydet ylläpitäjän oikeudet tai luoda uuden käytännön (ks. 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 valinta, kun Odoo-palvelin yhdistää S3:een käyttöavaimella AWS:n ulkopuolelta, Odoo.sh:sta, omalta palvelimelta tai toiselta palvelintarjoajalta. Jos Odoo on AWS EC2 -instanssissa, voit sen sijaan valita Application running on an AWS compute service; Odoohon kopioitavat kentät ovat samat
9. Paina 'Next'. Seuraavassa vaiheessa voit antaa kuvausmerkin, esimerkiksi Odoo S3 Sync, ja paina sitten '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, joten tallenna se ennen ikkunan sulkemista
12. Jos käytät S3-yhteensopivaa palvelua AWS S3:n sijaan, kopioi päätepisteen URL sen hallintapaneelista ja syötä se Odoossa kenttään 'Amazon S3 endpoint URL'. Esimerkiksi MinIO käyttää usein osoitetta https://minio.example.com tai http://localhost:9000; LocalStack yleensä http://localhost:4566
13. Siirry kohtaan Odoo Cloud Storage > Asetukset > 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 name -kenttään anna otsikko, jota käytetään kaikkien synkronoitujen kansioiden yläpuolisena S3-etuliitteenä. Esimerkiksi 'Odoo' tai 'OdooERP'
17. Täytä kentät 'Bucket', 'Region', 'Access Key', 'Secret Key' ja tarvittaessa 'Amazon S3 endpoint URL' sekä osoitustyyli
18. Valitse, käyttääkö Odoo tilapäisiä ennalta allekirjoitettuja URL-osoitteita vai julkisia bucket-/CDN-osoitteita. Yksityisissä bucketeissa pidä ennalta allekirjoitetut URL-osoitteet päällä ja aseta niiden elinikä sekunteina
19. Paina 'Confirm'. Odoo tarkistaa bucket-käytön ja luo tai vahvistaa juurikansion etuliitteen. Amazon S3 – Odoo -synkronointi on valmis tehtäväksi
20. Liitä juuri luotu pilviasiakas kansion sääntöihin ja/tai manuaalisiin kansioihin, jotka synkronoidaan kyseiseen Amazon S3 -bucketiin
21. Odota ajastetun synkronointityön käynnistymistä. Vain testausta varten: käynnistä integrointi manuaalisesti polusta Cloud Storage > Asetukset > Asetukset > painike '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 käytössä, Odoo tallentaa suoran S3-objektin URL-osoitteen. Linkki toimii vain, jos liittyvä S3-bucket, etuliite, objekti, CDN tai yhteensopiva päätepiste 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 käytöstä, Odoo tallentaa AWS Console -linkit liittyvään bucket-objektiin tai etuliitteeseen. Tällaiset linkit sopivat Amazon-käyttäjille: avaajan on oltava kirjautuneena AWS:ään ja hänellä on oltava IAM-oikeus kyseiseen bucket-objektiin. Jos käyttäjällä ei ole AWS-käyttöoikeutta, 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 Odoossa kenttään 'Bucket'
4. Luo Odoon käyttöoikeustiedot. MinIO:ssa käytä access key / secret key -paria tai palvelutiliä, jolla on oikeudet luetella, 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 MinIO näyttää sen vain kerran
7. Kopioi MinIO S3 API -päätepisteen URL Odoon kenttään 'Amazon S3 endpoint URL'. Esimerkiksi paikallinen palvelin käyttää yleensä osoitetta http://localhost:9000, tuotantopalvelin voi käyttää osoitetta https://minio.example.com
8. Siirry kohtaan Odoo Cloud Storage > Asetukset > Cloud Clients ja paina 'Create'
9. Viitteeksi anna nimi, joka on selvä kaikille käyttäjille
10. Pilviasiakkaaksi valitse 'MinIO'
11. Juurikansion nimeksi anna otsikko, jota käytetään kaikkien synkronoitujen kansioiden yläpuolisena MinIO-objektien etuliitteenä. Esimerkiksi 'Odoo' tai 'OdooERP'
12. Täytä kentät 'Bucket', 'Access Key', 'Secret Key' ja 'Amazon S3 endpoint URL'. Kenttä 'Region' on MinIO:lle valinnainen; jos se on tyhjä, Odoo käyttää arvoa us-east-1 S3-yhteensopivaan allekirjoitukseen
13. Pidä osoitustyylinä Path-style. Se on suositeltu valinta MinIO-päätepisteille, etenkin kun MinIO-isäntä ei tarjoa bucket-kohtaisia DNS-nimiä
14. Valitse, käyttääkö Odoo suoria julkisia MinIO-URL-osoitteita. Ota 'Use Public URLs' käyttöön vain, kun bucket, etuliite, reverse proxy tai CDN on julkisesti luettavissa. Yksityisissä MinIO-bucketeissa jätä valinta pois päältä
15. Paina 'Confirm'. Odoo tarkistaa bucket-käytön ja luo tai varmistaa juurikansion etuliitteen. Synkronointi MinIO - Odoo on valmis suoritettavaksi
16. Kohdista juuri luotu pilviasiakas kansiosääntöihin ja/tai manuaalisiin kansioihin, jotka synkronoidaan kyseiseen MinIO-bucketiin
17. Odota ajastetun synkronointityön käynnistymistä. Vain testausta varten: käynnistä integrointi manuaalisesti polusta Cloud Storage > Asetukset > Asetukset > painike '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.