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. 新しいバケットを作成するか、既存のものを選びます。正確なバケット名をコピーし、Odoo の項目「Bucket」に入れてください
4. バケットの詳細を開き、AWS Region をコピーします。Odoo の項目 'Region' に入れます（例: eu-west-1 または us-east-1）
5. AWS IAMコンソールを開きます: https://console.aws.amazon.com/iam/
6. 新しい IAM ユーザーを作成するか、既存の技術ユーザーを選びます。このユーザーは選択したバケット内のオブジェクトを一覧、読取、作成、書込、コピー、削除する全権限を持つ必要があります。全権限の管理者を選ぶか、新しいポリシーを作成できます（下記参照）
7. IAM ユーザーフォームでタブ 'Security credentials' を開き、'Create access key' を押します
8. ページ 'Access key best practices & alternatives' で Application running outside AWS を選びます。Odoo サーバーが AWS 外、Odoo.sh、自前サーバー、または他ホストからアクセスキーで S3 に接続する場合の正しい選択肢です。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. AWS S3 ではなく S3 互換プロバイダを使う場合、その管理画面からエンドポイント URL をコピーし、Odoo の 'Amazon S3 endpoint URL' に入れます。例: MinIO はよく 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 と公開バケット/CDN URL のどちらを使うかを選びます。非公開バケットでは presigned URL を有効のまま、有効期間を秒で設定します
19. 'Confirm' を押します。Odoo が bucket アクセスを確認し、ルートフォルダ接頭辞を作成または検証します。Amazon S3 - Odoo 同期の準備ができました
20. 新しく作成した cloud client を、その Amazon S3 バケット と同期するフォルダルールおよび/または手動フォルダに適用します
21. 同期のスケジュールジョブが開始されるのを待ちます。テスト専用: Cloud Storage > 設定 > 設定 > ボタン「Launch sync」から統合を手動で起動します。

役立つAWSドキュメント: S3バケットの作成: 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.

バケットポリシーの例

Amazon S3 には重要な特徴があります。Odoo に表示される URL は常に Amazon 側のリンクです。

Use Public URLs が有効な場合、Odoo は S3 オブジェクトへの直接 URL を保存します。関連する S3 バケット、プレフィックス、オブジェクト、CDN、または互換エンドポイントが公開読み取り可能なときだけ機能します。そうでなければ、AWS コンソールにログインしていても Amazon S3 は AccessDenied を表示します。

公開リンクでは 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 を実際のバケット名に、Odoo/ を選択したルートフォルダ接頭辞に置き換えます。Amazon S3 の Block public access がそのバケットポリシーを妨げないことも確認してください。

Use Public URLs が無効の場合、Odoo は関連バケットオブジェクトまたはプレフィックスへの AWS Console リンクを保存します。Amazon ユーザー向けで、開く人は AWS にログインし、そのオブジェクトへの IAM アクセスが必要です。AWS アクセスがなければ Amazon はファイルを開きません。

1. 稼働中の MinIO サーバーを準備します
2. MinIOコンソールを開く
3. 新しいバケットを作成するか、既存のものを選びます。正確なバケット名をコピーし、Odoo の項目「Bucket」に入れてください
4. Odoo 用のアクセス資格情報を作成します。MinIO では、選択したバケット内のオブジェクトを一覧・読み取り・作成・書き込み・コピー・削除できる access key / secret key の組、またはサービスアカウントを使います
5. MinIO の Access Key を Odoo の項目「Access Key」にコピーします
6. MinIO の Secret Key を Odoo の項目「Secret Key」にコピーします。重要: MinIO が一度しか表示しない場合は、MinIO ページを閉じる前にシークレットを保存してください
7. MinIO S3 API エンドポイント URL を 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 名を提供しない場合に推奨されます
14. Odoo が直接の公開 MinIO URL を使うかを選びます。バケット、プレフィックス、リバースプロキシ、CDN が公開読取可能なときだけ「Use Public URLs」を有効にしてください。非公開の MinIO バケットでは無効のままにします
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.