カスタム サービス アカウントを使用してジョブへのアクセスを制御する

このドキュメントでは、ジョブの VM がアクセスできるリソースとアプリケーションに影響を与える Batch ジョブのサービス アカウントを指定する方法について説明します。カスタム サービス アカウントを指定しない場合、ジョブは Compute Engine のデフォルト サービス アカウントの使用をデフォルトにします。これはデフォルトで、プロジェクト内のすべての VM に自動的にアタッチされます。そのため、カスタム サービス アカウントを使用すると、ジョブの権限をより詳細に管理でき、権限を制限する場合にベスト プラクティスとしておすすめです。

ジョブのサービス アカウントについて確認する。

準備

カスタム サービス アカウントを使用するジョブを作成する

カスタム サービス アカウントを使用するジョブを作成するには、次の方法のいずれかを選択します。

  • このセクションに示すように、ジョブの定義でカスタム サービス アカウントを指定します。
  • Compute Engine インスタンス テンプレートを使用して、インスタンス テンプレートとジョブの定義の両方でカスタム サービス アカウントを指定します。

このセクションでは、カスタム サービス アカウントを使用するジョブを作成する方法の例を示します。gcloud CLI または Batch API を使用して、カスタム サービス アカウントを使用するジョブを作成できます。

gcloud

gcloud CLI を使用してカスタム サービス アカウントを使用するジョブを作成するには、gcloud batch jobs submit コマンドを使用して、カスタム サービス アカウントをジョブの構成ファイルで指定します。

たとえば、カスタム サービス アカウントを使用するスクリプト ジョブを作成するには、次のようにします。

  1. hello-world-service-account.json という名前の現在のディレクトリに、次の内容の JSON ファイルを作成します。

    {
        "taskGroups": [
            {
                "taskSpec": {
                    "runnables": [
                        {
                            "script": {
                                "text": "echo Hello World! This is task $BATCH_TASK_INDEX."
                            }
                        }
                    ]
                }
            }
        ],
        "allocationPolicy": {
            "serviceAccount": {
                "email": "SERVICE_ACCOUNT_EMAIL"
            }
        }
    }
    

    ここで、SERVICE_ACCOUNT_EMAIL はサービス アカウントのメールアドレスです。serviceAccount フィールドが指定されていない場合、値はデフォルトの Compute Engine サービス アカウントに設定されます。

  2. 次のコマンドを実行します。

    gcloud batch jobs submit example-service-account-job \
      --location us-central1 \
      --config hello-world-service-account.json
    

API

Batch API を使用してカスタム サービス アカウントを使用するジョブを作成するには、jobs.create メソッドを使用し、allocationPolicy フィールドでカスタム サービス アカウントを指定します。

たとえば、カスタム サービス アカウントを使用するスクリプト ジョブを作成するには、次のリクエストを行います。

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/jobs?job_id=example-service-account-job

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello World! This is task $BATCH_TASK_INDEX."
                        }
                    }
                ]
            }
        }
    ],
    "allocationPolicy": {
        "serviceAccount": {
            "email": "SERVICE_ACCOUNT_EMAIL"
        }
    }
}

以下を置き換えます。

次のステップ