This page describes creating a service and viewing information about a service. Services are the main resources of Cloud Run. Each service has a unique and permanent URL that will not change over time as you deploy new revisions to it.
For Cloud Run (fully managed), the service's permanent domain consists of the service name and a hash.
Creating a service
You create a new service by deploying a container image to it for the first time. Deploying a new service has more instructions.
Viewing the list of services in your project
You can view a list of the available services in your project using Cloud Console or the gcloud command line:
To view the services list:
Examine the displayed list of services for your project:
To list the services in your project:
gcloud run services list
Note that each service has an associated URL.
Viewing more details about a service
To see more details about a service,
To view a service's details:
Click on the desired service in the displayed list of services for your project to open the service details view:
Note the REVISIONS, LOGS and DETAILS tabs. The revisions tab shows the list of revisions, the logs tab shows the service logs, and the details tab shows the current authentication or connectivity settings.
To view details about a service:
gcloud run services describe SERVICEReplace SERVICE with the name of the service.
You can use the
--format flag to format
the output. For example as YAML:
gcloud run services describe SERVICE --format yaml
For more details on service revisions, see Managing Revisions.
Changing Cloud Run for Anthos service connectivity settings
A Cloud Run for Anthos service can have either of two connection options:
- external, which allows external access to your service
- internal which restricts access only to other Cloud Run for Anthos services or services in your cluster that use istio.
You can use the console or the gcloud command line to change the settings.
To change service connectivity settings:
Click on the desired service in the displayed list of services for your project to open the service details view.
Click the DETAILS tab:
In the Connectivity line, click the edit icon next to the current setting.
Select the desired setting and click Save.
To change service connectivity settings, update the service with the desired connectivity setting:
gcloud run services update [SERVICE] --connectivity=[OPTION]
[SERVICE]with the name of the service you are updating. You can omit this parameter entirely, but you will be prompted for the service name if you omit it.
Deleting existing services
Deleting a service deletes all resources related to this service, including all revisions of this service whether they are serving traffic or not.
When deleting a service, the container images used by the deleted revisions are not deleted automatically from Container Registry. To delete container images from Container Registry see Deleting images.
Note that deleting a service is permanent: there is no undo or restore. However, if after deleting a service, you deploy a new service with the same name in the same region, it will have the same endpoint URL.
To delete a service:
Locate the service you want to delete in the services list, and click its checkbox to select it.
Click DELETE. This deletes all revisions of the service.
To delete a service, use the command:
gcloud run services delete [SERVICE]
[SERVICE] with the name of your service.