Amazon S3 / MinIO Odoo Integration v.19

Rīks ir atkarīgs no ārējās bibliotēkas 'boto3'. Instalējiet to Odoo serverī ar komandu:

1. Ieslēdziet opciju 'Amazon S3 Sync' (Cloud Storage > Konfigurācija > Konfigurācija). Nepieciešams izvēles papildinājums Amazon S3 Odoo Integration
2. Atveriet Amazon S3 konzoli: https://console.aws.amazon.com/s3/
3. Izveidojiet jaunu bucket vai izvēlieties esošu. Kopējiet precīzo bucket nosaukumu: tas jāievieto Odoo laukā „Bucket“
4. Atveriet bucket informāciju un kopējiet AWS Region. Ievietojiet to Odoo laukā 'Region' (piemēram, eu-west-1 vai us-east-1)
5. Atveriet AWS IAM konzoli: https://console.aws.amazon.com/iam/
6. Izveidojiet jaunu IAM lietotāju vai izvēlieties esošu tehnisko lietotāju. Šim lietotājam jābūt pilnām tiesībām uzskaitīt, lasīt, izveidot, rakstīt, kopēt un dzēst objektus izvēlētajā bucket. Varat izvēlēties pilntiesīgu administratoru vai izveidot jaunu politiku (skatiet zemāk)
7. IAM lietotāja formā atveriet cilni 'Security credentials' un nospiediet 'Create access key'
8. Lapā 'Access key best practices & alternatives' atlasiet Application running outside AWS. Tā ir pareizā opcija, ja Odoo serveris savienojas ar S3 ar piekļuves atslēgu ārpus AWS, no Odoo.sh, no jūsu servera vai cita hostinga. Ja Odoo ir AWS EC2 instancē, varat izvēlēties Application running on an AWS compute service, bet uz Odoo kopētie lauki ir tie paši
9. Nospiediet 'Next'. Nākamajā solī pēc izvēles ievadiet apraksta birku, piemēram Odoo S3 Sync, tad nospiediet 'Create access key'
10. Pēdējā AWS lapā kopējiet Access key vai Access key ID Odoo laukā 'Access Key'
11. Kopējiet Secret access key Odoo laukā „Secret Key“. Svarīgi: AWS slepeno atslēgu rāda tikai vienreiz, tāpēc saglabājiet to pirms loga aizvēršanas
12. Ja izmantojat ar S3 saderīgu pakalpojumu sniedzēju, nevis AWS S3, kopējiet galapunkta URL no šī sniedzēja administratora paneļa un ievietojiet Odoo laukā 'Amazon S3 endpoint URL'. Piemēram, MinIO bieži izmanto URL kā https://minio.example.com vai http://localhost:9000; LocalStack parasti http://localhost:4566
13. Dodieties uz Odoo Cloud Storage > Configuration > Cloud Clients un nospiediet 'Create'
14. Kā atsauci ievadiet nosaukumu, kas skaidrs visiem lietotājiem
15. Kā Cloud klientu izvēlieties «Amazon S3»
16. Kā Root folder nosaukumu ievadiet virsrakstu, ko izmantos kā vecāku S3 prefix visām sinhronizētajām mapēm. Piemēram, 'Odoo' vai 'OdooERP'
17. Aizpildiet laukus 'Bucket', 'Region', 'Access Key', 'Secret Key' un vajadzības gadījumā 'Amazon S3 endpoint URL' un adresēšanas stilu
18. Izvēlieties, vai Odoo jāizmanto īslaicīgi presigned URL vai publiski bucket/CDN URL. Privātiem bucket turiet presigned URL ieslēgtus un iestatiet to darbības laiku sekundēs
19. Nospiediet 'Confirm'. Odoo pārbauda piekļuvi bucket un izveido vai verificē saknes mapes prefiksu. Amazon S3 - Odoo sinhronizācija ir gatava izpildei
20. Lietojiet tikko izveidoto cloud client mapju noteikumiem un/vai manuālajām mapēm, kas jāsinhronizē ar to Amazon S3 bucketu
21. Gaidiet, līdz tiks palaists sinhronizācijas ieplānotais darbs. Tikai testēšanai: palaidiet integrāciju manuāli no Cloud Storage > Uzstādījumi > Uzstādījumi > poga „Launch sync“.

Noderīga AWS dokumentācija: S3 bucket izveide: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, IAM piekļuves atslēgu pārvaldība: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Bucket politikas piemērs

Amazon S3 ir svarīga īpatnība: Odoo rādītais URL vienmēr ir Amazon puses saite.

Ja Use Public URLs ir ieslēgts, Odoo saglabā tiešu S3 objekta URL. Saite darbojas tikai tad, ja saistītais S3 bucket, prefikss, objekts, CDN vai saderīgais galapunkts ir publiski lasāms. Citādi Amazon S3 rāda AccessDenied, pat ja lietotājs ir pieteicies AWS konsolē.

Publiskām saitēm konfigurējiet spaiņa atļaujas Amazon S3 un atļaujiet publisku lasīšanu Odoo prefiksam. Spaiņa politikas piemērs:

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

Aizstājiet YOUR_BUCKET_NAME ar īsto bucket nosaukumu un Odoo/ ar izvēlēto saknes mapes prefiksu. Pārliecinieties arī, ka Amazon S3 Block public access iestatījumi nebloķē šo bucket politiku.

Ja Use Public URLs ir izslēgts, Odoo saglabā AWS Console saites uz saistīto bucket objektu vai prefiksu. Šādas saites noder Amazon lietotājiem: atvērējam jābūt pieteikušamies AWS un jābūt IAM piekļuvei šim objektam. Ja lietotājam nav AWS piekļuves, Amazon failu neatvērs.

1. Sagatavojiet darbojošos MinIO serveri
2. Atveriet MinIO konzoli
3. Izveidojiet jaunu bucket vai izvēlieties esošu. Kopējiet precīzo bucket nosaukumu: tas jāievieto Odoo laukā „Bucket“
4. Izveidojiet Odoo piekļuves akreditācijas datus. MinIO izmantojiet access key / secret key pāri vai pakalpojuma kontu ar tiesībām atlasītajā bucket uzskaitīt, lasīt, izveidot, rakstīt, kopēt un dzēst objektus
5. Kopējiet MinIO Access Key Odoo laukā „Access Key“
6. Kopējiet MinIO Secret Key Odoo laukā „Secret Key“. Svarīgi: saglabājiet noslēpumu pirms MinIO lapas aizvēršanas, ja MinIO to rāda tikai vienreiz
7. Kopējiet MinIO S3 API galapunkta URL Odoo laukā „Amazon S3 endpoint URL“. Piemēram, vietējais serveris parasti izmanto http://localhost:9000, bet ražošanas serveris var izmantot https://minio.example.com
8. Dodieties uz Odoo Cloud Storage > Configuration > Cloud Clients un nospiediet 'Create'
9. Kā atsauci ievadiet nosaukumu, kas skaidrs visiem lietotājiem
10. Kā Cloud klientu izvēlieties «MinIO»
11. Kā Root folder nosaukumu ievadiet virsrakstu, ko izmantos kā vecāku MinIO object prefix visām sinhronizētajām mapēm. Piemēram, 'Odoo' vai 'OdooERP'
12. Aizpildiet laukus 'Bucket', 'Access Key', 'Secret Key' un 'Amazon S3 endpoint URL'. Lauks 'Region' MinIO ir neobligāts; ja tas ir tukšs, Odoo S3 saderīgai parakstīšanai izmanto us-east-1
13. Paturiet adresēšanas stilu Path-style. Tas ir ieteicamais variants MinIO galapunktiem, īpaši ja MinIO resursdators nesniedz bucketam specifiskus DNS nosaukumus
14. Izvēlieties, vai Odoo jāizmanto tieši publiski MinIO URL. Iespējojiet „Use Public URLs“ tikai tad, ja bucket, prefix, reversais starpnieks vai CDN ir publiski lasāmi. Privātiem MinIO bucket atstājiet izslēgtu
15. Nospiediet 'Confirm'. Odoo pārbauda piekļuvi bucket un izveido vai verificē saknes mapes prefiksu. MinIO - Odoo sinhronizācija ir gatava izpildei
16. Lietojiet tikko izveidoto cloud client mapju noteikumiem un/vai manuālajām mapēm, kas jāsinhronizē ar to MinIO bucketu
17. Gaidiet, līdz tiks palaists sinhronizācijas ieplānotais darbs. Tikai testēšanai: palaidiet integrāciju manuāli no Cloud Storage > Uzstādījumi > Uzstādījumi > poga „Launch sync“.

Noderīga MinIO dokumentācija: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.