Using labels

Console

1. Go to Knative serving in the Google Cloud console:

Go to Knative serving

1. Check the checkbox at the left of the service you are setting the label on.

2. Make sure the Info Panel at the far right is toggled on ( Show Info Panel).

3. Click Labelsto display the labels pane.

   

4. To edit an existing label key value, locate the label and change the Value as desired.

5. To set a new label on the service, click Add Labeland supply the key and the value.

6. Click Save

Command line

You can use the Google Cloud CLI to set labels for new services or to update existing services:

• For existing services, update labels by running the gcloud run services update command with one of the following parameters:

  • --set-labels
  • --update-labels
  • --remove-labels
  • --clear-labels

  Example:

  gcloud  
  run  
  services  
  update  
   SERVICE 
    
  --update-labels  
    KEY1 
   = 
  VALUE1,KEY2 = 
  VALUE2 
  

  Replace:

  • SERVICE with the name of your service.
  • KEY1=VALUE1,KEY2=VALUE2 with a comma separated list of name and value pairs for each label. Specify the label name for each KEY and the value for VALUE . How to specify multiple parameters .

  Command parameter options

  To specify several sets of key-value pairs, you can specify multiple parameters for readability. Example:

   [ 
  ... ] 
  --set-labels  
   "KEY=VALUE1" 
    
   \ 
  --set-labels  
   "KEY=VALUE2" 
    
   \ 
  --set-labels  
   "KEY=VALUE3" 
  

  OK

• For new services, set labels by running the gcloud run deploy command with the --set-labels parameter:

  gcloud  
  run  
  deploy  
   SERVICE 
    
  --image = 
   IMAGE_URL 
    
  --set-labels  
    KEY1 
   = 
  VALUE1,KEY2 = 
  VALUE2 
  

  Replace:

  • IMAGE_URL with a reference to the container image, for example, gcr.io/cloudrun/hello .
  • SERVICE with the name of your service.
  • KEY1=VALUE1,KEY2=VALUE2 with a comma separated list of name and value pairs for each label. Specify the label name for each KEY and the value for VALUE . How to specify multiple parameters .

  Command parameter options

  To specify several sets of key-value pairs, you can specify multiple parameters for readability. Example:

   [ 
  ... ] 
  --set-labels  
   "KEY=VALUE1" 
    
   \ 
  --set-labels  
   "KEY=VALUE2" 
    
   \ 
  --set-labels  
   "KEY=VALUE3" 
  

  OK

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 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. In your local file, update the labels attribute:

    apiVersion 
    : 
     
    serving.knative.dev/v1 
    kind 
    : 
     
    Service 
    metadata 
    : 
     
    name 
    : 
     
     SERVICE 
    
     
    labels 
    : 
     
     LABEL 
    
    : 
     
    ' VALUE 
   ' 
   

   Replace

   • SERVICE with the name of your Knative serving service
   • LABEL with the name of the label
   • VALUE with the desired value

3. Replace the service with its new configuration using the following command:

   gcloud  
   run  
   services  
   replace  
   service.yaml

Console

1. Go to Knative serving in the Google Cloud console:

Go to Knative serving

1. Check the checkbox at the left of the service you are deleting the label from.

2. Make sure the Info Panel at the far right is toggled on ( Show Info Panel).

3. Click Labelsto display the labels pane.

4. Locate the label you want to delete.

5. Hover your cursor to the right of the Value textbox for the label to display the trash icon, and click the trash icon.

6. Click Save

Command line

To clear all labels from a service:

gcloud  
run  
services  
update  
 SERVICE 
  
--clear-labels

To delete specific labels from a service, supply a comma delimited list of keys:

gcloud  
run  
services  
update  
 SERVICE 
  
--remove-labels  
 LABEL 

Replace

• SERVICE with name of your Knative serving service
• LABEL with the name of your label