ワーカープールにデプロイするか、ワーカープールの構成を変更すると、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 の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。
ワーカープールのリビジョンのリストを表示する
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択して、ワーカープールのリストを表示します。
gcloud
特定のワーカープールのリビジョンのリストを表示するには:
プロジェクトで使用可能なワーカープールのリストからワーカープールの名前を探します。
gcloud beta run worker-pools list
次のコマンドを使用して、そのワーカープールのすべてのリビジョンを取得します。
gcloud beta run worker-pools revisions list --worker-pool=WORKER_POOL --region=REGION
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。
リビジョンの詳細を表示する
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。
ワーカープールをクリックして、詳細ウィンドウを表示します。
gcloud
プロジェクトのリビジョンの詳細を表示するには:
プロジェクトで使用可能なワーカープールのリストからワーカープールの名前を探します。
gcloud beta run worker-pools list
見つかったワーカープールのすべてのリビジョンを取得するには、次のコマンドを使用します。
gcloud beta run worker-pools revisions list --worker-pool=WORKER_POOL --region=REGION
次のように置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。
特定のリビジョンに関する詳細を表示するには、次のコマンドを使用します。
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 を使用して、リビジョンを削除します。
コンソール
Google Cloud コンソールで Cloud Run に移動します。
メニューから [ワーカープール] を選択して、使用可能なワーカープールを表示します。
ワーカープールをクリックして、詳細ウィンドウを表示します。
[リビジョン] をクリックします。
削除するリビジョンを選択します。
[アクション] メニューで省略記号アイコンをクリックし、[削除] をクリックしてリビジョンを削除します。
gcloud
リビジョンを削除するには、次のコマンドを使用します。
gcloud beta run worker-pools revisions delete REVISION --region=REGION --worker-pool=WORKER_POOL
次のように置き換えます。
- REVISION は、削除するリビジョンの名前に置き換えます。
- WORKER_POOL は、ワーカープールの名前に置き換えます。
- REGION は、ワーカープールの Google Cloud リージョンに置き換えます。
次のステップ
リビジョンをデプロイすると、次の操作が可能になります。