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 > Konfiguracja > Konfiguracja). Wymagany jest dodatek Amazon S3 Odoo Integration
2. Otwórz Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Utwórz nowy bucket albo wybierz istniejący. Skopiuj dokładną nazwę bucketu: należy ją wpisać w Odoo w polu 'Bucket'
4. Otwórz szczegóły bucketu i skopiuj AWS Region. Wstaw w Odoo w polu 'Region' (na przykład 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 użytkownika technicznego. Ten użytkownik powinien mieć pełne prawa do listowania, odczytu, tworzenia, zapisu, kopiowania i usuwania obiektów w wybranym buckecie. Możesz wybrać pełne prawa administratora 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 od innego dostawcy hostingu. Jeśli Odoo jest na instancji AWS EC2, możesz zamiast tego 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, na przykład Odoo S3 Sync, potem naciśnij '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, więc zapisz go przed zamknięciem okna
12. Jeśli używasz dostawcy zgodnego z S3 zamiast AWS S3, skopiuj URL punktu końcowego z jego panelu administracyjnego i wstaw w Odoo w polu 'Amazon S3 endpoint URL'. Na przykład MinIO często używa adresu https://minio.example.com lub http://localhost:9000; LocalStack zwykle http://localhost:4566
13. Przejdź do Odoo Cloud Storage > Konfiguracja > 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. Na przykład 'Odoo' lub 'OdooERP'
17. Wypełnij pola 'Bucket', 'Region', 'Access Key', 'Secret Key' oraz w razie potrzeby 'Amazon S3 endpoint URL' i styl adresowania
18. Wybierz, czy Odoo ma używać tymczasowych wstępnie podpisanych adresów URL, czy publicznych adresów bucketu/CDN. Przy prywatnych bucketach pozostaw wstępnie podpisane adresy URL włączone i ustaw ich żywotność w sekundach
19. Naciśnij 'Confirm'. Odoo sprawdza dostęp do bucketu i tworzy lub weryfikuje prefiks folderu głównego. Synchronizacja Amazon S3 – Odoo jest gotowa do wykonania
20. Zastosuj nowo utworzony klient chmury do reguł folderów i/lub ręcznych folderów, które mają być synchronizowane z tym bucketem Amazon S3
21. Poczekaj na start zaplanowanego zadania synchronizacji. Tylko do testów: uruchom integrację ręcznie z Cloud Storage > Konfiguracja > Konfiguracja > 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. Łącze działa tylko wtedy, gdy powiązany bucket S3, prefiks, obiekt, CDN lub zgodny punkt końcowy 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 rzeczywistą nazwą bucketa, a Odoo/ wybranym prefiksem folderu głównego. Upewnij się też, że ustawienia Amazon S3 Block public access nie blokują tej polityki bucketa.

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

1. Przygotuj działający serwer MinIO
2. Otwórz MinIO Console
3. Utwórz nowy bucket albo wybierz istniejący. Skopiuj dokładną nazwę bucketu: należy ją wpisać 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 uprawnieniami do listowania, odczytu, tworzenia, zapisu, kopiowania i usuwania obiektów w wybranym buckecie
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 MinIO pokazuje go tylko raz
7. Skopiuj URL punktu końcowego MinIO S3 API do pola Odoo 'Amazon S3 endpoint URL'. Na przykład lokalny serwer zwykle używa http://localhost:9000, a serwer produkcyjny może używać https://minio.example.com
8. Przejdź do Odoo Cloud Storage > Konfiguracja > Cloud Clients i naciśnij 'Create'
9. Jako odniesienie podaj nazwę zrozumiałą dla wszystkich użytkowników
10. Jako klienta chmury wybierz 'MinIO'
11. Jako nazwę folderu głównego wpisz tytuł, który będzie nadrzędnym prefiksem obiektów MinIO dla wszystkich synchronizowanych folderów. Na przykład '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 jest puste, Odoo używa us-east-1 do podpisu zgodnego z S3
13. Zachowaj styl adresowania Path-style. To zalecana opcja dla punktów końcowych MinIO, zwłaszcza gdy host MinIO nie udostępnia nazw DNS właściwych dla bucketa
14. Wybierz, czy Odoo ma używać bezpośrednich publicznych URL-i MinIO. Włącz 'Use Public URLs' tylko wtedy, gdy bucket, prefiks, reverse proxy lub CDN jest publicznie czytelny. Dla prywatnych bucketów MinIO pozostaw to wyłączone
15. Naciśnij 'Confirm'. Odoo sprawdzi dostęp do bucketa i utworzy lub zweryfikuje prefiks folderu głównego. Synchronizacja MinIO - Odoo jest gotowa do wykonania
16. Przypisz nowo utworzonego klienta chmury do reguł folderów i/lub folderów ręcznych, które mają być synchronizowane z tym bucketem MinIO
17. Poczekaj na start zaplanowanego zadania synchronizacji. Tylko do testów: uruchom integrację ręcznie z Cloud Storage > Konfiguracja > Konfiguracja > 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.