Amazon S3 と Transloadit
アプリケーションサーバーを経由せずに、Amazon S3 からオブジェクトをインポートし、Assembly で処理して結果を書き戻します。
実行可能な処理設定
連携を構築
この Template は JPEG を一つインポートし、1200×1200 以内に収まるようにリサイズして、結果を processed/ に保存します。
- S3 バケットと、そのバケットに対して最小限の権限を持つ IAM プリンシパルを作成してください。
- AWS の値を、my_s3_credentials という名前の Template 認証情報として Transloadit に保存します。
- 処理設定を Template に貼り付け、その Template から Assembly を開始してください。
Template の処理設定
{
"steps": {
"imported": {
"robot": "/s3/import",
"credentials": "my_s3_credentials",
"path": "incoming/photo.jpg"
},
"resized": {
"robot": "/image/resize",
"use": "imported",
"width": 1200,
"height": 1200,
"resize_strategy": "fit"
},
"exported": {
"robot": "/s3/store",
"use": "resized",
"credentials": "my_s3_credentials",
"acl": "bucket-default",
"path": "processed/${file.url_name}"
}
}
}認証
- 専用の IAM プリンシパルを作成し、そのバケット、アクセスキー ID、シークレットアクセスキー、バケットのリージョンを Transloadit の Template 認証情報として保存してください。
- インポートと保存の Step に必要なバケットおよびオブジェクトの操作権限のみを付与してください。Robot のドキュメントには、それぞれの転送方向に対応するポリシーのひな形が記載されています。
- 保存した認証情報名を参照し、AWS のシークレットを Assembly Instructions やアプリケーションコードに含めないようにします。
制限事項と運用上の注意点
- ディレクトリのインポートでは多数のファイルが返され、ページネーションが必要になる場合があります。バッチの対象を予測しやすくするため、パスのプレフィックスで対象を絞り込んでください。
- AWS KMS によるサーバー側の暗号化には、通常の S3 オブジェクトへのアクセス権限に加えて、KMS の権限が必要です。
- オブジェクト所有権とバケットポリシーによって、ACL の書き込みが拒否される場合があります。この処理設定では bucket-default を使用するため、PutObjectAcl は不要です。
その他の連携
技術スタックの構築を続ける
Cloudflare R2
インポートと保存専用の Robot で R2 オブジェクトを処理します。
Supabase
S3 互換エンドポイント経由で Supabase Storage に接続します。
Tigris
専用の Robot で Tigris オブジェクトをインポート、エクスポートできます。
Azure Blob Storage
Azure Blob Storage のコンテナーを Assembly のパイプラインに接続します。