ワーカープールのリビジョンを管理する

ワーカープールにデプロイするか、ワーカープールの構成を変更すると、Cloud Run は不変のリビジョンを作成します。

リビジョンには次の考慮事項が適用されます。

  • 手動でリビジョンを削除する必要はありませんが、必要であれば削除することもできます。
  • 非アクティブなリビジョンはリソースを消費せず、料金も発生しません。
  • ワーカープールごとに最大 1, 000 個のリビジョンがあります。この上限を超えると、古いリビジョンは自動的に削除されます。
  • リビジョン サフィックスは自動的に割り当てられます。gcloud CLI の -revision-suffix パラメータを使用すると、独自のバージョン サフィックスを使用できます。

必要なロール

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

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

ワーカープールのリビジョンのリストを表示する

gcloud

特定ワーカープールのリビジョンを一覧取得するには:

  1. プロジェクトで使用可能なワーカープールのリストからワーカープールの名前を探します。

    gcloud beta run worker-pools list

  2. そのワーカープールのすべてのリビジョンを取得するには、次のコマンドを使用します。

    gcloud beta run worker-pools revisions list
   --worker-pool=WORKER_POOL
   --region=REGION

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

    • WORKER_POOL は、ワーカープールの名前に置き換えます。
    • REGION は、ワーカープールの Google Cloud リージョンに置き換えます。

リビジョンの詳細を表示する

gcloud

プロジェクトのリビジョンの詳細を表示するには:

  1. プロジェクトで使用可能なワーカープールのリストからワーカープールの名前を探します。

    gcloud beta run worker-pools list

  2. 見つかったワーカープールのすべてのリビジョンを取得するには、次のコマンドを使用します。

    gcloud beta run worker-pools revisions list
    --worker-pool=WORKER_POOL
    --region=REGION

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

    • WORKER_POOL は、ワーカープールの名前に置き換えます。
    • REGION は、ワーカープールの Google Cloud リージョンに置き換えます。

  3. 特定のリビジョンに関する詳細を表示するには、次のコマンドを使用します。

    gcloud beta run worker-pools revisions describe REVISION --region=REGION --worker-pool=WORKER_POOL

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

    • REVISION: 詳細を確認するリビジョンの名前。
    • REGION は、ワーカープールの Google Cloud リージョンに置き換えます。
    • WORKER_POOL は、ワーカープールの名前に置き換えます。

    --format フラグを使用して出力をフォーマットできます。たとえば、出力を YAML 形式でフォーマットするには:

    gcloud beta run worker-pools revisions describe REVISION
    --region=REGION
    --worker-pool=WORKER_POOL
    --format yaml

最新でないリビジョンのステータスが RETIRED になっている場合、そのリビジョンに必要なインフラストラクチャが Cloud Run ですでに廃止されています。

リビジョンを削除する

リビジョンを削除する一般的なユースケースは、特定のリビジョンが誤って使用されないようにする場合です。

次のリビジョンは削除できません。

  • ワーカープールの唯一のリビジョン。
  • ワーカープールの最新リビジョン。

リビジョンを削除しても、このリビジョンで使用されているコンテナ イメージは Artifact Registry から自動的に削除されません。コンテナ イメージを Artifact Registry から削除するには、Artifact Registry の削除手順を参照してください。

リビジョンを削除すると元に戻すことはできません。

Google Cloud CLI を使用してリビジョンを削除します。

gcloud

リビジョンを削除するには、次のコマンドを使用します。

gcloud beta run worker-pools revisions delete REVISION 
    --region=REGION
    --worker-pool=WORKER_POOL

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

  • REVISION: 削除するリビジョンの名前。
  • WORKER_POOL は、ワーカープールの名前に置き換えます。
  • REGION は、ワーカープールの Google Cloud リージョンに置き換えます。

次のステップ

リビジョンをデプロイすると、次の操作が可能になります。