Managing services

Console

To view the services list:

1. Go to Knative serving

2. Examine the displayed list of services for your project:

   

Command line

To list the services in your project:

gcloud run services list

You can filter this list by properties of the service definition, such as an assigned label.

Cloud Code

To view the services list with Cloud Code, read the Cloud Run Explorer guides for IntelliJ and Visual Studio Code.

Console

To copy a service:

1. Go to Knative serving

2. Select the service to copy from the displayed list of services for your project:

   

   1. Click Copy.

   2. In the service copy page, set or change any values you want to change, such as region, etc. If you are keeping the same region, you must provide a new name for the service.

   3. Click Create to make a copy and deploy it using the new service name.

YAML

You can download the configuration of an existing service into a YAML file with the gcloud run services describe command by using the --format=export flag. You can then modify that YAML file and deploy those changes with the gcloud beta run services replace command. You must ensure that you modify only the specified attributes.

1. Download the configuration of your service into a file named service.yaml on local workspace:

   gcloud run services describe SERVICE --format export > service.yaml

   Replace SERVICE with the name of your Knative serving service.

2. Make any desired configuration changes to the service as described in the various configuration pages.

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      annotations:
        ...
      name: SERVICE
      ...
    spec:
      template:
        metadata:
          annotations:
          ...
          name: REVISION-NAME
   

   • If you are deploying the copy to the same Kubernetes cluster, replace SERVICE with the name you want to use for the copy. If you are deploying the copy to a different Kubernetes cluster, you can use the same name.

   • Make sure the value for REVISION-NAME starts with the service name (SERVICE). For example, if the new service name is mynewfoo, then the revision name must be in the format mynewfoo-whatever. Optionally delete the value altogether and a new revision name is created automatically.

3. Copy the service using the following command:

   gcloud beta run services replace service.yaml

   Use the --region flag to deploy the copy to a different region.

Console

To view a service's details:

1. Go to Knative serving

2. Click on the desired service in the displayed list of services for your project to open the service details view:

   

3. 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.

Command line

To view details about a service:

gcloud run services describe SERVICE

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

gcloud run services describe SERVICE --format yaml

You can use --format export to export as YAML without automatically generated labels or status:

gcloud run services describe SERVICE --format export

You can also use the --format flag to get the URL of the service:

gcloud run services describe SERVICE --format='value(status.url)'

Cloud Code

To view a services details with Cloud Code, read the Cloud Run Explorer guides for IntelliJ and Visual Studio Code.

Console

To change service connectivity settings:

1. Go to Knative serving

2. Click on the desired service in the displayed list of services for your project to open the service details view.

3. Click the Triggers tab.

4. Select the desired setting and click Save.

Command line

To change service connectivity settings, update the service with the desired connectivity setting:

gcloud run services update [SERVICE] --connectivity=[OPTION]

• Replace [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.

• Replace [OPTION] with internal or external.

Console

To delete a service:

1. Go to Knative serving

2. Locate the service you want to delete in the services list, and click its checkbox to select it.

3. Click DELETE. This deletes all revisions of the service.

Command line

To delete a service, use the command:

gcloud run services delete [SERVICE]

Replace [SERVICE] with the name of your service.