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 bucket
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 конзолата.

За публични връзки конфигурирайте правата на контейнера в Amazon S3 и разрешете публично четене за префикса Odoo. Примерен регламент за контейнера:

{
  "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 използва us-east-1 за S3-съвместимо подписване
13. Оставете стила на адресиране Path-style. Това е препоръчаната опция за MinIO крайни точки, особено когато хостът на MinIO не предоставя DNS имена по bucket
14. Изберете дали Odoo да използва директни публични MinIO URL. Включете „Use Public URLs“ само когато bucket-ът, префиксът, обратният прокси или CDN са публично четими. За частни MinIO bucket-и го оставете изключено
15. Натиснете 'Confirm'. Odoo проверява достъпа до bucket и създава или потвърждава префикса на корневата папка. Синхронизацията MinIO - Odoo е готова да бъде извършена
16. Приложете новосъздадения cloud client към правила за папки и/или ръчни папки, които трябва да се синхронизират с онзи MinIO bucket
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.