Amazon S3 / MinIO Odoo Integration v.19

Алат зависи од спољне библиотеке „boto3“. Инсталирајте је на Odoo сервер командом:

1. Укључите опцију 'Amazon S3 Sync' (Cloud Storage > Конфигурација > Конфигурација). Потребан је опциони додатак Amazon S3 Odoo Integration
2. Отворите Amazon S3 конзолу: https://console.aws.amazon.com/s3/
3. Направите нови bucket или изаберите постојећи. Копирајте тачан назив bucket-а: треба га унети у Odoo у поље „Bucket“
4. Отворите детаље bucket-а и копирајте AWS Region. Унесите је у Odoo у поље 'Region' (на пример, eu-west-1 или us-east-1)
5. Отворите AWS IAM конзолу: https://console.aws.amazon.com/iam/
6. Направите новог IAM корисника или изаберите постојећег техничког корисника. Тај корисник треба да има пуна права да наброји, чита, прави, пише, копира и брише објекте у изабраном bucket-у. Можете изабрати админа са пуним правима или направити нову политику (види испод)
7. На формулару IAM корисника отворите картицу 'Security credentials' и притисните 'Create access key'
8. На страници 'Access key best practices & alternatives' изаберите Application running outside AWS. То је исправна опција када се Odoo сервер повезује на S3 приступним кључем ван AWS-а, са Odoo.sh, са сопственог сервера или другог хостинга. Ако је Odoo на AWS EC2 инстанци, можете изабрати Application running on an AWS compute service, али поља копирана у Odoo су иста
9. Притисните 'Next'. На следећем кораку по жељи унесите ознаку описа као Odoo S3 Sync, затим притисните 'Create access key'
10. На последњој AWS страници копирајте Access key или Access key ID у Odoo поље 'Access Key'
11. Копирајте Secret access key у Odoo поље „Secret Key“. Важно: AWS приказује тајни кључ само једном, па га сачувајте пре затварања прозора
12. Ако користите S3-компатибилног пружаоца уместо AWS S3, копирајте URL крајње тачке из админ панела тог пружаоца и унесите га у Odoo у поље 'Amazon S3 endpoint URL'. На пример, MinIO често користи URL као https://minio.example.com или http://localhost:9000; LocalStack обично http://localhost:4566
13. Идите на Odoo Cloud Storage > Configuration > Cloud Clients и притисните 'Create'
14. Као референцу унесите назив јасан свим корисницима
15. Као Cloud клијент изаберите «Amazon S3»
16. Као назив Root folder унесите наслов који ће се користити као надређени S3 prefix за све синхронизоване фасцикле. На пример, 'Odoo' или 'OdooERP'
17. Попуните поља 'Bucket', 'Region', 'Access Key', 'Secret Key' и, ако треба, 'Amazon S3 endpoint URL' и стил адресирања
18. Изаберите да ли Odoo треба да користи привремене presigned URL или јавне bucket/CDN URL. За приватне bucket-е оставите presigned URL укључене и поставите им век у секундама
19. Притисните 'Confirm'. Odoo проверава приступ bucket-у и креира или верификује префикс корене фасцикле. Синхронизација Amazon S3 - Odoo спремна је за извођење
20. Примените новокреирани cloud client на правила фасцикли и/или ручне фасцикле које треба синхронизовати са тим Amazon S3 бакетом
21. Сачекајте да се покрене заказани посао синхронизације. Само у сврху тестирања: покрените интеграцију ручно из Cloud Storage > Конфигурација > Конфигурација > дугме „Launch sync“.

Корисна AWS документација: прављење S3 bucket-а: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, управљање IAM приступним кључевима: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Пример политике bucket

Amazon S3 има важну посебност: URL приказан у Odoo увек је веза на страни Amazon.

Ако је Use Public URLs укључено, Odoo чува директан URL S3 објекта. Веза ради само ако су повезани S3 bucket, префикс, објект, CDN или компатибилна крајња тачка јавно читљиви. Иначе Amazon S3 приказује AccessDenied, чак и ако је корисник пријављен на AWS конзолу.

За јавне везе конфигуришите дозволе bucket-а у Amazon S3 и дозволите јавно читање за Odoo префикс. Пример политике bucket-а:

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

Замените YOUR_BUCKET_NAME стварним именом bucket-а и Odoo/ изабраним префиксом коренског фолдера. Такође проверите да подешавања Amazon S3 Block public access не блокирају ту политику bucket-а.

Ако је Use Public URLs искључено, Odoo чува AWS Console везе ка повезаном bucket објекту или префиксу. Такве везе су корисне Amazon корисницима: онај ко отвара мора бити пријављен на AWS и имати IAM приступ том објекту. Ако корисник нема AWS приступ, Amazon неће отворити датотеку.

1. Припремите покренути MinIO сервер
2. Отворите MinIO конзолу
3. Направите нови bucket или изаберите постојећи. Копирајте тачан назив bucket-а: треба га унети у Odoo у поље „Bucket“
4. Направите акредитиве приступа за Odoo. У MinIO користите пар access key / secret key или сервисни налог са правима да набраја, чита, прави, пише, копира и брише објекте у изабраном bucket-у
5. Копирајте MinIO Access Key у Odoo поље „Access Key“
6. Копирајте MinIO Secret Key у Odoo поље „Secret Key“. Важно: сачувајте тајну пре затварања MinIO странице ако је MinIO приказује само једном
7. Копирајте URL MinIO S3 API крајње тачке у Odoo у поље „Amazon S3 endpoint URL“. На пример, локални сервер обично користи http://localhost:9000, а продукцијски може користити https://minio.example.com
8. Идите на Odoo Cloud Storage > Configuration > Cloud Clients и притисните 'Create'
9. Као референцу унесите назив јасан свим корисницима
10. Као Cloud клијент изаберите «MinIO»
11. Као назив Root folder унесите наслов који ће се користити као надређени MinIO object prefix за све синхронизоване фасцикле. На пример, 'Odoo' или 'OdooERP'
12. Попуните поља 'Bucket', 'Access Key', 'Secret Key' и 'Amazon S3 endpoint URL'. Поље 'Region' је за MinIO опционо; ако је празно, Odoo за S3-компатибилно потписивање користи us-east-1
13. Задржите стил адресирања као Path-style. То је препоручена опција за MinIO крајње тачке, посебно када MinIO хост не даје DNS имена по bucket-у
14. Изаберите да ли Odoo треба да користи директне јавне MinIO URL. Укључите „Use Public URLs“ само када су bucket, prefix, реверзни прокси или CDN јавно читљиви. За приватне MinIO bucket-е оставите искључено
15. Притисните 'Confirm'. Odoo проверава приступ bucket-у и креира или верификује префикс корене фасцикле. Синхронизација MinIO - Odoo спремна је за извођење
16. Примените новокреирани cloud client на правила фасцикли и/или ручне фасцикле које треба синхронизовати са тим MinIO бакетом
17. Сачекајте да се покрене заказани посао синхронизације. Само у сврху тестирања: покрените интеграцију ручно из Cloud Storage > Конфигурација > Конфигурација > дугме „Launch sync“.

Корисна MinIO документација: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.