Managing Revisions

Cloud Run locations

Cloud Run is regional, which means the infrastructure that runs your Cloud Run services is located in a specific region and is managed by Google to be redundantly available across all the zones within that region.

Meeting your latency, availability, or durability requirements are primary factors for selecting the region where your Cloud Run services are run. You can generally select the region nearest to your users but you should consider the location of the other GCP products that are used by your Cloud Run service. Using GCP products together across multiple locations can affect your service's latency as well as cost.

Cloud Run is available in the following regions:
  • us-central1 (Iowa)
If you already created a Cloud Run service, you can view the region in the Cloud Run dashboard in the GCP Console.

When you deploy to a service or change the configuration of a service, an immutable revision is created. Only the latest created revision is active and served by the service's URL.

Viewing the list of revisions for a service

Console

To view the list of revisions in your project:

  1. Go to Cloud Run

  2. Locate the service you want to examine in the services list, and click on it to show the list of current revisions for that service:

    revision list

Command line

To view the list of revisions for a given service:

  1. Find your service name from the list of services available in your project:

    gcloud beta run services list
    
  2. Use the following command to get all the revisions for the service you just looked up:

    gcloud beta run revisions list --service [SERVICE]
    

    Replace [SERVICE] with the name of your service.

Viewing revision details

Console

To view the details for a revision in your project:

  1. Go to Cloud Run

  2. Locate the service you want to examine in the services list, and click on it to show the list of current revisions for that service.

  3. Select the service revision you are interested in:

  4. Examine the DETAIL panel at the far right for revision-specific information such as the URL of the deployed container image, amount of memory allocated, and environment variables:

    image

Command line

To view the details for a revision in your project:

  1. Find your service name from the list of services available in your project:

    gcloud beta run services list
    
  2. Use the following command to get all the revisions for the service you just looked up:

    gcloud beta run revisions list --service [SERVICE]
    

    Replace [SERVICE] with the name of your service.

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

    gcloud beta run revisions describe [REVISION NAME]
    

    Replace [REVISION NAME] with the name of the revision you want to learn more about.

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.

Deleting revisions

Note that you can only delete revisions that are not serving requests: you cannot delete the currently active revision for a service.

When deleting a revision, the container image used by this revision is not deleted automatically from Container Registry. To delete a container image from Container Registry see Deleting images.

Once you've deleted a revision, you cannot undo this action.

Console

You cannot currently delete a revision in the console.

Command line

To delete a revision, use the following command:

gcloud beta run revisions delete [REVISION NAME]

Replace [REVISION NAME] with the name of the revision you want to delete.

Was this page helpful? Let us know how we did:

Send feedback about...