ジョブ実行を管理する

このページでは、ジョブ実行を表示および削除する方法について説明します。ジョブ構成を実行、キャンセル、オーバーライドする方法については、ジョブを実行するをご覧ください。

必要なロール

Cloud Run ジョブを管理するために必要な権限を取得するには、Cloud Run ジョブに対する Cloud Run デベロッパーroles/run.developer)IAM ロールを付与するよう管理者に依頼してください。

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールCloud Run IAM 権限をご覧ください。Cloud Run ジョブが Google Cloud APIs(Cloud クライアント ライブラリなど)と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限アクセスの管理をご覧ください。

プロジェクト内のジョブ実行を表示する

Google Cloud コンソールまたは Google Cloud CLI を使用して、プロジェクトのジョブ実行のリストを表示できます。

コンソール

ジョブの実行リストを表示するには:

  1. [Cloud Run] ページに移動します。

  2. リストで、実行を管理するジョブを見つけます

  3. ジョブをクリックして実行リストを表示します。

  4. 実行の詳細ページで、目的の実行を見つけます。必要に応じて、フィルタ条件を目的の条件に設定できます(たとえば、ステータス値に「完了」を設定します)。

gcloud

プロジェクト内のすべてのジョブに対するジョブ実行を一覧表示するには:

gcloud run jobs executions list

特定のジョブ実行のみを表示するには、次のコマンドを実行します。

gcloud run jobs executions list --job JOB_NAME

JOB_NAME は、フィルタするジョブの名前に置き換えます。

フィルタを使用するなどの方法で、返されたリストを絞り込む方法については、ジョブ実行リストをご覧ください。

特定のジョブの最新の実行名を取得するには、--format フラグを使用します。

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

JOB_NAME は、フィルタするジョブの名前に置き換えます。

クライアント ライブラリ

コードからすべてのジョブ実行を一覧表示するには:

REST API

ジョブ実行を一覧表示するには、Cloud Run Admin API の jobs エンドポイントGET HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

次のように置き換えます。

  • ACCESS_TOKEN は、ジョブ実行を表示する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
  • JOB-NAME: ジョブの名前。
  • REGION は、ジョブの Google Cloud リージョンに置き換えます。
  • PROJECT-ID は、Google Cloud プロジェクト ID に置き換えます。

ジョブ実行の詳細を表示する

最新の 10,000 件のジョブ実行のジョブの詳細を表示するには、実行の詳細ペインと、過去 7 日間に発生したすべての実行を確認できます。古い実行の詳細は削除され、実行の詳細ペインに表示されなくなります。ただし、古い実行のログとモニタリング データは Cloud LoggingCloud Monitoring で引き続き利用できます。これらは、保持ポリシーの対象となります。

Google Cloud コンソールまたは Google Cloud CLI を使用して、ジョブ実行の詳細を表示できます。

コンソール

特定のジョブ実行の詳細を表示するには:

  1. [Cloud Run] ページに移動します。

  2. 目的のジョブ実行を見つけます

  3. ジョブの実行をクリックして、実行の詳細ページを表示します。

  4. [タスク]、[ログ]、[構成]、[YAML] の各タブを確認します。

    • [タスク] には、ジョブ実行のタスクに関する情報が表示されます。
    • [ログ] には、実行に関連するログが表示されます。
    • [構成] には、実行に使用されたジョブ、コンテナ、セキュリティ、接続などに関する情報が表示されます。
    • [YAML] には、ジョブの構成が YAML 形式で表示されます。

gcloud

ジョブ実行の詳細を表示するには:

次のコマンドを使用します。

gcloud run jobs executions describe EXECUTION_NAME

EXECUTION_NAME は、実行名に置き換えます。

--format フラグを使用して出力をフォーマットし、追加情報を取得できます。たとえば、YAML としてフォーマットします。

gcloud run jobs executions describe EXECUTION_NAME --format yaml

クライアント ライブラリ

コードからジョブ実行の詳細を表示するには:

REST API

ジョブ実行の詳細を表示するには、Cloud Run Admin API の jobs エンドポイントGET HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

次のように置き換えます。

  • ACCESS_TOKEN は、ジョブ実行の詳細を表示する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
  • JOB-NAME: ジョブの名前。
  • EXECUTION-NAME: ジョブ実行の名前。
  • REGION は、ジョブの Google Cloud リージョンに置き換えます。
  • PROJECT-ID は、Google Cloud プロジェクト ID に置き換えます。

ジョブ実行を削除する

実行中であっても、ジョブ実行の削除は可能です。実行を削除すると、実行が続行されなくなります。

削除された実行は実行リストに表示されませんが、残りのログ保持期間の間、Cloud Logging で引き続きログを使用できます。また、モニタリング データも引き続き Cloud Monitoring を使用できます。

コンソール

ジョブ実行を削除するには:

  1. [Cloud Run] ページに移動します。

  2. 削除するジョブ実行を見つけます

  3. [削除] をクリックします。

  4. 削除を確認するメッセージが表示されたら、[確認] をクリックします。

gcloud

ジョブ実行を削除するには:

  1. 次のコマンドを使用します。

    gcloud run jobs executions delete EXECUTION_NAME

    EXECUTION_NAME は、実行名に置き換えます。

  2. 確認するメッセージが表示されたら、y と応答します。ビルドが成功すると、成功メッセージが表示されます。

クライアント ライブラリ

コードからジョブ実行を削除するには:

REST API

ジョブ実行を削除するには、Cloud Run Admin API の jobs エンドポイントDELETE HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

次のように置き換えます。

  • ACCESS_TOKEN は、ジョブ実行を削除する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
  • JOB_NAME: ジョブの名前。
  • EXECUTION-NAME: ジョブ実行の名前。
  • REGION は、ジョブの Google Cloud リージョンに置き換えます。
  • PROJECT-ID は、Google Cloud プロジェクト ID に置き換えます。