Google Cloud Storage と Transloadit
サービスアカウントの認証情報を使用する専用のインポート用 Robot と保存用 Robot で、Google Cloud Storage バケットを Assembly に接続します。
実行可能な処理設定
連携を構築
この Template は、バケットの IAM ポリシーを使用して Google Cloud Storage のオブジェクトを読み込み、サイズを変更して、結果を processed/ 配下に書き込みます。
- 均一なバケットレベルのアクセスを有効にした非公開の Google Cloud Storage バケットを作成し、専用のサービスアカウントに必要なバケット権限を付与してください。
- その JSON キーとプロジェクトの値を、my_gcs_credentials という名前の Template 認証情報として保存してください。
- 処理設定を Template に貼り付け、その Template から Assembly を開始してください。
Template の処理設定
{
"steps": {
"imported": {
"robot": "/google/import",
"credentials": "my_gcs_credentials",
"path": "incoming/photo.jpg"
},
"resized": {
"robot": "/image/resize",
"use": "imported",
"width": 1200,
"height": 1200,
"resize_strategy": "fit"
},
"exported": {
"robot": "/google/store",
"use": "resized",
"credentials": "my_gcs_credentials",
"acl": null,
"path": "processed/${file.url_name}"
}
}
}認証
- 専用の Google Cloud サービスアカウントを作成し、ワークフローに必要なバケット権限を付与します。
- このインポートから保存までを行う処理設定では、サービスアカウントに入力オブジェクトの一覧取得・読み取りと、出力オブジェクトの作成の権限が必要です。既存のパスを上書きする場合は、削除権限も必要です。
- サービスアカウントの JSON キーを一度ダウンロードし、Transloadit の Template 認証情報にアップロードしてください。長期利用する認証情報として保護し、ローテーションしてください。
制限事項と運用上の注意点
- Transloadit の Template 認証情報では、アップロードしたサービスアカウントの JSON キーを使用します。これらの Robot 内では、ワークロード ID と Application Default Credentials は利用できません。
- 保存用 Robot のデフォルトは public-read です。この処理設定では、均一なバケットレベルのアクセスを有効にしたバケット向けに acl を null に設定します。この場合、アクセスは IAM で制御され、オブジェクト ACL のリクエストは拒否されます。IAM ポリシーでバケットを非公開に保ってください。
- 再帰なしのディレクトリインポートでは、直下の項目のみが対象になります。より深い階層や大量のデータをインポートするには、recursive を有効にしてページネーショントークンを使用してください。
その他の連携
技術スタックの構築を続ける
Amazon S3
専用の Robot で Amazon S3 からのインポートと Amazon S3 へのエクスポートを行います。
Cloudflare R2
インポートと保存専用の Robot で R2 オブジェクトを処理します。
Supabase
S3 互換エンドポイント経由で Supabase Storage に接続します。
Tigris
専用の Robot で Tigris オブジェクトをインポート、エクスポートできます。