Manage worker pool revisions

When you deploy to a worker pool or change the configuration of a worker pool, Cloud Run creates an immutable revision.

The following considerations apply to revisions:

You don't need to manually delete revisions , although you can if you want.
Inactive revisions don't consume any resources and are not billed.
There is a maximum of 1000 revisions per worker pool: If you exceed that limit, older revisions are automatically deleted.
The revision suffix is assigned automatically. If you want to use your own version suffix, you can do so using the gcloud CLI parameter --revision-suffix .

Required roles

To get the permissions that you need to manage Cloud Run worker pools and worker pool revisions, ask your administrator to grant you the Cloud Run Developer ( roles/run.developer ) IAM role on your Cloud Run worker pool.

For a list of IAM roles and permissions that are associated with Cloud Run, see Cloud Run IAM roles and Cloud Run IAM permissions . If your Cloud Run worker pool interfaces with Google Cloud APIs, such as Cloud Client Libraries, see the service identity configuration guide . For more information about granting roles, see deployment permissions and manage access .

View the list of revisions for a worker pool

console

In the Google Cloud console, go to Cloud Run:

Go to Cloud Run
Select Worker poolsfrom the menu to display the list of worker pools.

gcloud

To view the list of revisions for a given worker pool:

Find your worker pool name from the list of worker pools available in your project:
```
gcloud  
beta  
run  
worker-pools  
list
```
Use the following command to get all the revisions for that worker pool:
```
gcloud  
beta  
run  
worker-pools  
revisions  
list  
--worker-pool = 
 WORKER_POOL 
  
--region = 
 REGION 
```
Replace:
- WORKER_POOL with the name of your worker pool.
- REGION with the Google Cloud region of the worker pool.

View revision details

console

In the Google Cloud console, go to Cloud Run:

Go to Cloud Run
Select Worker poolsfrom the menu to display the available worker pools.
Click the worker pool to display its details pane.

gcloud

To view the details for a revision in your project:

Find your worker pool name from the list of worker pools available in your project:
```
gcloud  
beta  
run  
worker-pools  
list
```
Use the following command to get all the revisions for the worker pool you just looked up:
```
gcloud  
beta  
run  
worker-pools  
revisions  
list  
--worker-pool = 
 WORKER_POOL 
  
--region = 
 REGION 
```
Replace
- WORKER_POOL with the name of your worker pool.
- REGION with the Google Cloud region of the worker pool.

Use the following command to see more details about a specific revision:

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

Replace

REVISION with the name of the revision you want to learn more about.
REGION with the Google Cloud region of the worker pool.
WORKER_POOL with the name of the worker pool.

You can use the --format flag to format the output. For example, to format the output as YAML:

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

Note that a non-current revision may have the status of RETIRED , which means that Cloud Run has retired the infrastructure needed for that particular revision.

Delete revisions

A common use case for deleting a revision is when you want to make sure a particular revision won't be accidentally used.

You cannot delete a revision if it is:

The only revision of the worker pool.
The latest revision of the worker pool.

When you delete a revision, the container image used by this revision is not deleted automatically from Artifact Registry. To delete a container image from Artifact Registry, see the deletion instructions for Artifact Registry .

You cannot undo a revision deletion.

Use the Google Cloud console or the Google Cloud CLI to delete a revision:

console

In the Google Cloud console, go to Cloud Run:

Go to Cloud Run
Select Worker poolsfrom the menu to display the available worker pools.
Click the worker pool to display its details pane.
Click Revisions.
Select the revision to delete.
Click the ellipsis under Actions, then click Deleteto delete the revision.

gcloud

To delete a revision, use the following command:

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

Replace

REVISION with the name of the revision you are deleting.
WORKER_POOL with the name of your worker pool.
REGION with the Google Cloud region of the worker pool.

What's next

After you deploy a revision, you can do the following:

Gradual rollouts, rollback revisions, instance splits