実行可能な処理設定
連携を構築
この Template は Tigris から画像を読み込み、WebP に変換し、非公開の処理結果を processed/ 配下に保存します。
- Tigris バケットと S3 互換のアクセス認証情報を作成します。
- バケット、エンドポイント、リージョン、キー、シークレットを my_tigris_credentials として保存します。
- 処理設定を Template に貼り付け、その Template から Assembly を開始してください。
Template の処理設定
{
"steps": {
"imported": {
"robot": "/tigris/import",
"credentials": "my_tigris_credentials",
"path": "incoming/photo.jpg"
},
"converted": {
"robot": "/image/resize",
"use": "imported",
"format": "webp",
"width": 1600,
"resize_strategy": "fit"
},
"exported": {
"robot": "/tigris/store",
"use": "converted",
"credentials": "my_tigris_credentials",
"acl": "private",
"path": "processed/${file.basename}.webp"
}
}
}認証
- 対象の Tigris バケット用に S3 互換の認証情報を作成し、アクセスキーとシークレットを Transloadit の Template 認証情報に保存してください。
- 新しい連携では、正規のエンドポイント https://t3.storage.dev を使用してください。リージョンには、Tigris の設定で別の値が指定されていない限り、auto を使用してください。
- アプリケーション全体のキーを使い回すのではなく、バケットとワークフロー専用の認証情報を使用してください。
制限事項と運用上の注意点
- Tigris には S3 互換 API 経由でアクセスするため、ワークフローで実行できる操作は Transloadit のインポート用と保存用の Robot が提供するものに限られます。
- 保存用 Robot のデフォルトは public-read です。出力を公開してはいけない場合は、acl を明示的に private に設定してください。
- 大規模な再帰インポートでは、ページネーションの計画が必要です。また、インポート対象のプレフィックス配下で同時に変更が発生すると、ページの内容がずれることがあります。
その他の連携
技術スタックの構築を続ける
Amazon S3
専用の Robot で Amazon S3 からのインポートと Amazon S3 へのエクスポートを行います。
Cloudflare R2
インポートと保存専用の Robot で R2 オブジェクトを処理します。
Supabase
S3 互換エンドポイント経由で Supabase Storage に接続します。
Azure Blob Storage
Azure Blob Storage のコンテナーを Assembly のパイプラインに接続します。