Amazon S3 / MinIO Odoo Integration v.19

Narzędzie zależy od zewnętrznej biblioteki 'boto3'. Zainstaluj ją na serwerze Odoo poleceniem:

1. Włącz opcję 'Amazon S3 Sync' (Cloud Storage > Configuration > Configuration). Wymagany jest dodatek Amazon S3 Odoo Integration
2. Otwórz Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Utwórz nowy kubełek lub wybierz istniejący. Skopiuj dokładną nazwę: wstaw ją w Odoo w polu 'Bucket'
4. Otwórz szczegóły kubełka i skopiuj AWS Region. Wstaw w Odoo w polu 'Region' (np. eu-west-1 lub us-east-1)
5. Otwórz AWS IAM Console: https://console.aws.amazon.com/iam/
6. Utwórz nowego użytkownika IAM albo wybierz istniejącego technicznego. Ten użytkownik powinien mieć pełne prawa do listowania, odczytu, tworzenia, zapisu, kopiowania i usuwania obiektów w wybranym kubełku. Możesz wybrać pełnego admina albo utworzyć nową politykę (patrz poniżej)
7. W formularzu użytkownika IAM otwórz kartę 'Security credentials' i naciśnij 'Create access key'
8. Na stronie 'Access key best practices & alternatives' wybierz Application running outside AWS. To właściwa opcja, gdy serwer Odoo łączy się z S3 kluczem spoza AWS, z Odoo.sh, z własnego serwera lub innego hostingu. Jeśli Odoo jest na AWS EC2, możesz wybrać Application running on an AWS compute service; pola kopiowane do Odoo są te same
9. Naciśnij 'Next'. W następnym kroku opcjonalnie wpisz tag opisu, np. Odoo S3 Sync, potem 'Create access key'
10. Na ostatniej stronie AWS skopiuj Access key lub Access key ID do pola Odoo 'Access Key'
11. Skopiuj Secret access key do pola Odoo 'Secret Key'. Ważne: AWS pokazuje klucz tajny tylko raz - zapisz go przed zamknięciem okna
12. Jeśli używasz dostawcy zgodnego z S3 zamiast AWS S3, skopiuj URL endpointu z panelu i wstaw w Odoo w polu 'Amazon S3 endpoint URL'. MinIO często używa https://minio.example.com lub http://localhost:9000; LocalStack zwykle http://localhost:4566
13. Przejdź do Odoo Cloud Storage > Configuration > Cloud Clients i naciśnij 'Create'
14. Jako odniesienie podaj nazwę zrozumiałą dla wszystkich użytkowników
15. Jako Cloud client wybierz 'Amazon S3'
16. Jako Root folder name wpisz tytuł, który będzie nadrzędnym prefiksem S3 dla wszystkich synchronizowanych folderów. Np. 'Odoo' lub 'OdooERP'
17. Wypełnij pola 'Bucket', 'Region', 'Access Key', 'Secret Key' oraz w razie potrzeby 'Amazon S3 endpoint URL' i addressing style
18. Wybierz, czy Odoo ma używać tymczasowych URL-i presigned, czy publicznych URL-i kubełka/CDN. Dla prywatnych kubełków zostaw presigned włączone i ustaw czas życia w sekundach
19. Naciśnij 'Confirm'. Odoo sprawdza dostęp do kubełka i tworzy lub weryfikuje prefiks folderu głównego. Synchronizacja Amazon S3 - Odoo jest gotowa
20. Zastosuj nowo utworzony cloud client do reguł folderów i/lub ręcznych folderów, które mają być synchronizowane z tym kubełkiem Amazon S3
21. Poczekaj na start zaplanowanego zadania synchronizacji. Tylko do testów: uruchom integrację ręcznie z Cloud Storage > Configuration > Configuration > przycisk 'Launch sync'.

Przydatna dokumentacja AWS: tworzenie kubełka S3: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, zarządzanie kluczami dostępu IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Przykład polityki kubełka

Amazon S3 ma ważną cechę: URL pokazywany w Odoo jest zawsze linkiem po stronie Amazon.

Jeśli Use Public URLs jest włączone, Odoo zapisuje bezpośredni URL obiektu S3. Link działa tylko gdy kubełek, prefiks, obiekt, CDN lub zgodny endpoint jest publicznie czytelny. W przeciwnym razie Amazon S3 pokaże AccessDenied, nawet gdy użytkownik jest zalogowany w konsoli AWS.

Dla linków publicznych skonfiguruj uprawnienia kubełka w Amazon S3 i zezwól na publiczny odczyt prefiksu Odoo. Przykładowa polityka kubełka:

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

Zastąp YOUR_BUCKET_NAME prawdziwą nazwą kubełka, a Odoo/ wybranym prefiksem folderu głównego. Upewnij się też, że ustawienia Amazon S3 Block public access nie blokują tej polityki.

Jeśli Use Public URLs jest wyłączone, Odoo zapisuje linki AWS Console do obiektu lub prefiksu kubełka. Takie linki są przydatne dla użytkowników Amazon: osoba otwierająca musi być zalogowana w AWS i mieć dostęp IAM do obiektu. Bez dostępu AWS Amazon nie otworzy pliku.

1. Przygotuj działający serwer MinIO
2. Otwórz MinIO Console
3. Utwórz nowy kubełek lub wybierz istniejący. Skopiuj dokładną nazwę: wstaw ją w Odoo w polu 'Bucket'
4. Utwórz poświadczenia dostępu dla Odoo. W MinIO użyj pary access key / secret key albo konta usługi z prawami listowania, odczytu, tworzenia, zapisu, kopiowania i usuwania obiektów w wybranym kubełku
5. Skopiuj MinIO Access Key do pola Odoo 'Access Key'
6. Skopiuj MinIO Secret Key do pola Odoo 'Secret Key'. Ważne: zapisz sekret przed zamknięciem strony MinIO, jeśli pokazuje go tylko raz
7. Skopiuj URL endpointu MinIO S3 API do pola Odoo 'Amazon S3 endpoint URL'. Lokalny serwer zwykle używa http://localhost:9000, produkcja może używać https://minio.example.com
8. Przejdź do Odoo Cloud Storage > Configuration > Cloud Clients i naciśnij 'Create'
9. Jako odniesienie podaj nazwę zrozumiałą dla wszystkich użytkowników
10. Jako Cloud client wybierz 'MinIO'
11. Jako Root folder name wpisz tytuł, który będzie nadrzędnym prefiksem obiektów MinIO dla wszystkich synchronizowanych folderów. Np. 'Odoo' lub 'OdooERP'
12. Wypełnij pola 'Bucket', 'Access Key', 'Secret Key' i 'Amazon S3 endpoint URL'. Pole 'Region' jest opcjonalne dla MinIO; jeśli puste, Odoo używa us-east-1 do podpisu zgodnego z S3
13. Zostaw addressing style jako Path-style. To zalecana opcja dla endpointów MinIO, zwłaszcza gdy host MinIO nie daje nazw DNS per kubełek
14. Wybierz, czy Odoo ma używać bezpośrednich publicznych URL-i MinIO. Włącz 'Use Public URLs' tylko gdy kubełek, prefiks, reverse proxy lub CDN jest publicznie czytelny. Dla prywatnych kubełków MinIO zostaw wyłączone
15. Naciśnij 'Confirm'. Odoo sprawdza dostęp do kubełka i tworzy lub weryfikuje prefiks folderu głównego. Synchronizacja MinIO - Odoo jest gotowa
16. Zastosuj nowy cloud client do reguł folderów i/lub ręcznych folderów synchronizowanych z tym kubełkiem MinIO
17. Poczekaj na start zaplanowanego zadania synchronizacji. Tylko do testów: uruchom integrację ręcznie z Cloud Storage > Configuration > Configuration > przycisk 'Launch sync'.

Przydatna dokumentacja MinIO: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.