Amazon S3 / MinIO Odoo Integration v.19

Nástroj závisí na externí knihovně 'boto3'. Nainstalujte ji na server Odoo příkazem:

1. Zapněte volbu 'Amazon S3 Sync' (Cloud Storage > Konfigurace > Konfigurace). Je vyžadován volitelný doplněk Amazon S3 Odoo Integration
2. Otevřete Amazon S3 Console: https://console.aws.amazon.com/s3/
3. Vytvořte nový bucket nebo vyberte existující. Zkopírujte přesný název bucketu: vložte ho v Odoo do pole 'Bucket'
4. Otevřete podrobnosti bucketu a zkopírujte jeho AWS Region. Vložte ji v Odoo do pole 'Region' (například eu-west-1 nebo us-east-1)
5. Otevřete AWS IAM Console: https://console.aws.amazon.com/iam/
6. Vytvořte nového uživatele IAM nebo vyberte existujícího technického uživatele. Musí mít plná práva vypisovat, číst, vytvářet, zapisovat, kopírovat a mazat objekty ve vybraném bucketu. Můžete zvolit plná admin práva, nebo vytvořit novou politiku (viz níže)
7. Ve formuláři uživatele IAM otevřete kartu 'Security credentials' a stiskněte 'Create access key'
8. Na stránce 'Access key best practices & alternatives' vyberte možnost Application running outside AWS. Je to správná volba, když server Odoo připojuje S3 přístupovým klíčem mimo AWS, z Odoo.sh, z vlastního serveru nebo od jiného poskytovatele. Pokud je Odoo na instanci AWS EC2, můžete zvolit Application running on an AWS compute service, ale pole zkopírovaná do Odoo jsou stejná
9. Stiskněte 'Next'. V dalším kroku můžete volitelně zadat popisnou značku, například Odoo S3 Sync, a poté stisknout 'Create access key'
10. Na poslední stránce AWS zkopírujte Access key nebo Access key ID do pole Odoo 'Access Key'
11. Zkopírujte Secret access key do pole Odoo 'Secret Key'. Důležité: AWS zobrazí tajný klíč jen jednou, uložte ho před zavřením okna
12. Pokud používáte poskytovatele kompatibilního s S3 místo AWS S3, zkopírujte URL koncového bodu z jeho admin panelu a vložte ji v Odoo do pole 'Amazon S3 endpoint URL'. MinIO často používá URL jako https://minio.example.com nebo http://localhost:9000; LocalStack obvykle http://localhost:4566
13. Přejděte na Odoo Cloud Storage > Konfigurace > Cloud Clients a stiskněte 'Create'
14. Jako referenci zadejte název srozumitelný všem uživatelům
15. Jako cloud klienta zvolte 'Amazon S3'
16. Jako název kořenové složky zadejte titulek, který bude nadřazeným prefixem S3 pro všechny synchronizované složky. Například 'Odoo' nebo 'OdooERP'
17. Vyplňte pole 'Bucket', 'Region', 'Access Key', 'Secret Key' a v případě potřeby 'Amazon S3 endpoint URL' a addressing style
18. Zvolte, zda má Odoo používat dočasné presigned URL, nebo veřejné URL bucketu/CDN. U soukromých bucketů nechte presigned URL zapnuté a nastavte jejich životnost v sekundách
19. Stiskněte 'Confirm'. Odoo zkontroluje přístup k bucketu a vytvoří nebo ověří prefix kořenové složky. Synchronizace Amazon S3 - Odoo je připravena
20. Přiřaďte nového cloud klienta k pravidlům složek a/nebo ručním složkám, které se mají synchronizovat do tohoto bucketu Amazon S3
21. Počkejte na spuštění naplánované úlohy synchronizace. Pouze pro testování: spusťte integraci ručně z Cloud Storage > Konfigurace > Konfigurace > tlačítko 'Launch sync'.

Užitečná dokumentace AWS: vytvoření S3 bucketu: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html, správa přístupových klíčů IAM: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html.

Příklad politiky bucketu

Amazon S3 má důležitou zvláštnost: URL zobrazená v Odoo je vždy odkaz na straně Amazon.

Pokud je zapnuto Use Public URLs, Odoo uloží přímou URL objektu S3. Odkaz funguje jen tehdy, když je související bucket S3, prefix, objekt, CDN nebo kompatibilní koncový bod veřejně čitelný. Jinak Amazon S3 zobrazí AccessDenied, i když je uživatel přihlášen v konzoli AWS.

Pro veřejné odkazy nastavte oprávnění bucketu v Amazon S3 a povolte veřejné čtení pro prefix Odoo. Příklad politiky bucketu:

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

Nahraďte YOUR_BUCKET_NAME skutečným názvem bucketu a Odoo/ zvoleným prefixem kořenové složky. Také se ujistěte, že nastavení Amazon S3 Block public access tuto politiku bucketu neblokuje.

Pokud je Use Public URLs vypnuto, Odoo ukládá odkazy AWS Console na související objekt nebo prefix v bucketu. Takové odkazy jsou užitečné pro uživatele Amazon: osoba, která odkaz otevře, musí být přihlášena v AWS a mít přístup IAM k objektu. Bez přístupu AWS Amazon soubor neotevře.

1. Připravte běžící server MinIO
2. Otevřete MinIO Console
3. Vytvořte nový bucket nebo vyberte existující. Zkopírujte přesný název bucketu: vložte ho v Odoo do pole 'Bucket'
4. Vytvořte přístupové údaje pro Odoo. V MinIO použijte pár access key / secret key nebo účet služby s právy vypisovat, číst, vytvářet, zapisovat, kopírovat a mazat objekty ve vybraném bucketu
5. Zkopírujte MinIO Access Key do pole Odoo 'Access Key'
6. Zkopírujte MinIO Secret Key do pole Odoo 'Secret Key'. Důležité: uložte tajný klíč před zavřením stránky MinIO, pokud ho MinIO zobrazí jen jednou
7. Zkopírujte URL koncového bodu MinIO S3 API do Odoo do pole 'Amazon S3 endpoint URL'. Místní server obvykle používá http://localhost:9000, produkční server může použít https://minio.example.com
8. Přejděte na Odoo Cloud Storage > Konfigurace > Cloud Clients a stiskněte 'Create'
9. Jako referenci zadejte název srozumitelný všem uživatelům
10. Jako cloud klienta zvolte 'MinIO'
11. Jako název kořenové složky zadejte titulek, který bude nadřazeným prefixem objektů MinIO pro všechny synchronizované složky. Například 'Odoo' nebo 'OdooERP'
12. Vyplňte pole 'Bucket', 'Access Key', 'Secret Key' a 'Amazon S3 endpoint URL'. Pole 'Region' je u MinIO volitelné; pokud je prázdné, Odoo použije us-east-1 pro podepisování kompatibilní s S3
13. Ponechte addressing style jako Path-style. To je doporučená volba pro koncové body MinIO, zvlášť když hostitel MinIO neposkytuje DNS názvy specifické pro bucket
14. Zvolte, zda má Odoo používat přímé veřejné URL MinIO. Zapněte 'Use Public URLs' jen když je bucket, prefix, reverse proxy nebo CDN veřejně čitelný. U soukromých bucketů MinIO to nechte vypnuté
15. Stiskněte 'Confirm'. Odoo zkontroluje přístup k bucketu a vytvoří nebo ověří prefix kořenové složky. Synchronizace MinIO - Odoo je připravena
16. Přiřaďte nového cloud klienta k pravidlům složek a/nebo ručním složkám, které se mají synchronizovat do tohoto bucketu MinIO
17. Počkejte na spuštění naplánované úlohy synchronizace. Pouze pro testování: spusťte integraci ručně z Cloud Storage > Konfigurace > Konfigurace > tlačítko 'Launch sync'.

Užitečná dokumentace MinIO: https://min.io/docs/minio/linux/administration/identity-access-management.html, https://min.io/docs/minio/linux/reference/minio-server/minio-server.html.