Google Cloud バケットの設定方法は?
Google Cloud プロジェクト、非公開バケット、Transloadit 専用のサービスアカウントを使います。バケットの作成、バケットの IAM アクセスの管理、サービスアカウントとその JSON キーの作成に必要な権限が必要です。Google Cloud のストレージ料金と Transloadit の処理料金がかかります。
1. 非公開バケットの作成
Google のバケット作成ガイドに従ってください。均一なバケットレベルのアクセスを使用し、個々のオブジェクトの ACL ではなく IAM でアクセスを制御します。公開アクセスは許可しないでください。以降の手順で使うため、バケット名とプロジェクト ID を控えておいてください。
2. サービスアカウントへのバケットアクセス権限の付与
専用のサービスアカウントを作成し、プロジェクト全体ではなく、このバケットに対するストレージオブジェクト作成者ロールを付与します。このロールではオブジェクトを作成できますが、既存のオブジェクトの読み取り、削除、上書きはできません。以下の例では、Robot のデフォルトの一意な出力パスを使います。固定パスを選ぶ場合や、インポート用の Step を追加する場合は、広範な管理者権限を付与するのではなく、そのワークフローに必要な権限を確認してください。
この Transloadit 接続では、サービスアカウントの JSON キーファイルを使います。Google のキー作成ガイドに従い、専用サービスアカウントの JSON キーをダウンロードしてください。キーは非公開で保管してください。組織でサービスアカウントキーが禁止されている場合は、そのポリシーを回避せず、管理者に相談してください。OAuth クライアントファイルや HMAC アクセスキーは、この JSON キーの代わりにはなりません。
3. Template 認証情報の保存
Template 認証情報の作成方法に従い、サービスとして Google Cloud Storage を選択します。次の項目を入力してください。
| Console の項目 | 値 |
|---|---|
| Google プロジェクト ID | Google Cloud プロジェクトの ID。 |
| Google Cloud Storage バケット | gs:// プレフィックスを除いたバケット名。 |
| Google JSON キーファイル | ダウンロードしたサービスアカウントの JSON キーファイル。 |
認証情報には、識別しやすい名前を付けてください。以下の Template では、JSON ファイルの内容やサービスアカウントのメールアドレスではなく、その名前を使います。
4. エクスポートのテスト
次の処理設定で Template を作成し、YOUR_GOOGLE_CLOUD_CREDENTIALS を保存した認証情報の名前に置き換えてください。
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"exported": {
"robot": "/google/store",
"use": ":original",
"credentials": "YOUR_GOOGLE_CLOUD_CREDENTIALS",
"acl": null
}
}
}
"acl": null はそのまま残してください。これによりオブジェクトの ACL が省略され、バケットの IAM ポリシーでアクセスが制御されます。一方、acl を省略すると、Robot のデフォルトの公開読み取り設定が使われます。この設定は、均一なバケットレベルのアクセスとは併用できません。
小さなテストファイルをアップロードして Template を実行してください。Assembly の完了後、エクスポート結果を調べ、自分の認証済み Google Cloud Console アクセスでオブジェクトが存在することを確認してください。結果の URL だけでは、非公開オブジェクトへの匿名アクセスは許可されません。その URL をテストするためだけにバケットを公開しないでください。
自動アップロードの試行でオブジェクトが作成されても、確認応答が失われると、Assembly が失敗する場合があります。ストレージオブジェクト作成者ロールでは、自動再試行時にそのオブジェクトを置き換えられないためです。権限を変更する前に、報告された保存先と Assembly のエラーを確認してください。オブジェクトが存在するだけでは、エクスポート全体が成功したとは確認できません。手動で再試行する場合は、上書きや削除の権限を追加せず、新たにファイルをアップロードし、この例のデフォルトの一意な出力パスを使って、新しい Assembly を開始してください。
関連情報
- Template の設定とセキュリティについては、Template ドキュメントを参照してください。
- パス、権限、その他のエクスポートオプションについては、🤖/google/store ドキュメントを参照してください。