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

ワーカープールにデプロイするか、ワーカープールの構成を変更すると、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 の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限アクセスの管理をご覧ください。

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

コンソール

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択して、ワーカープールのリストを表示します。

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 リージョンに置き換えます。

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

コンソール

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。

  3. ワーカープールをクリックして、詳細ウィンドウを表示します。

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 コンソールまたは Google Cloud CLI を使用して、リビジョンを削除します。

コンソール

  1. Google Cloud コンソールで Cloud Run に移動します。

    Cloud Run に移動

  2. メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。

  3. ワーカープールをクリックして、詳細ウィンドウを表示します。

  4. [リビジョン] をクリックします。

  5. 削除するリビジョンを選択します。

  6. [アクション] メニューで省略記号アイコンをクリックし、[削除] をクリックしてリビジョンを削除します。

gcloud

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

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

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

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

次のステップ

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