Como usar rótulos

Saiba como criar e usar rótulos nos serviços e revisões de exibição do Knative.

Rótulos são pares de chave-valor aplicados ao serviço e às revisões. Quando você define um rótulo em um serviço de exibição do Knative, uma nova revisão com esse rótulo é criada para esse serviço. O rótulo não é aplicado a revisões mais antigas.

Os rótulos para disponibilização do Knative são rótulos de recursos do Kubernetes (em inglês) e não são propagados para o Google Cloud. Para saber mais sobre como usar rótulos para analisar o uso de recursos do cluster, consulte Noções básicas sobre o uso de recursos do cluster.

Regras de uso de rótulos

Somente rótulos válidos do Kubernetes podem ser usados no Knative.

Como definir ou modificar rótulos

Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem automaticamente essa configuração, a menos que você faça atualizações explícitas para alterá-la.

É possível definir ou modificar rótulos usando o console do Cloud, a Google Cloud CLI ou um arquivo YAML ao implantar um novo serviço ou atualizar um serviço atual e implantar uma revisão:

Console

1. Acesse a veiculação do Knative no console do Google Cloud:

Acessar a veiculação do Knative

1. Marque a caixa de seleção à esquerda do serviço em que você está definindo o rótulo.

2. Verifique se o Painel de informações no canto direito está ativado (Mostrar painel de informações).

3. Clique em Rótulos para exibir o painel de rótulos.

   

4. Para editar um valor-chave de rótulo atual, localize o rótulo e mude o Valor como quiser.

5. Para definir um novo rótulo no serviço, clique em Adicionar rótulo e forneça a chave e o valor.

6. Clique em Salvar.

Linha de comando

Use a Google Cloud CLI para definir rótulos de novos serviços ou atualizar os atuais:

• Para os serviços atuais, atualize os rótulos executando o comando gcloud run services update com um dos seguintes parâmetros:

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

  Exemplo:

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

  Substitua:

  • SERVICE pelo nome do serviço;
  • KEY1=VALUE1,KEY2=VALUE2 com uma lista separada por vírgula de pares de nome e valor para cada rótulo. Especifique o nome do rótulo para cada KEY e o valor para VALUE. Como especificar vários parâmetros:

  Opções de parâmetros de comando

  Para especificar vários conjuntos de pares de chave-valor, é possível especificar vários parâmetros de legibilidade. Exemplo:

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

  OK

• Para novos serviços, defina rótulos executando o comando gcloud run deploy com o parâmetro --set-labels:

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

  Substitua:

  • IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, gcr.io/cloudrun/hello;
  • SERVICE pelo nome do serviço;
  • KEY1=VALUE1,KEY2=VALUE2 com uma lista separada por vírgula de pares de nome e valor para cada rótulo. Especifique o nome do rótulo para cada KEY e o valor para VALUE. Como especificar vários parâmetros:

  Opções de parâmetros de comando

  Para especificar vários conjuntos de pares de chave-valor, é possível especificar vários parâmetros de legibilidade. Exemplo:

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

  OK

YAML

Cuidado: a implantação de alterações de configuração com arquivos YAML substitui a configuração dos serviços existentes. Como um arquivo YAML substitui completamente todas as configurações, evite usar vários métodos para modificar seus serviços. Por exemplo, não use arquivos YAML com o console do Google Cloud ou comandos da gcloud.

Faça o download da configuração de um serviço existente para um arquivo YAML com o comando gcloud run services describe usando a sinalização --format=export. Em seguida, modifique o arquivo YAML e implante essas alterações com o comando gcloud run services replace. Modifique apenas os atributos especificados.

1. Faça o download da configuração do serviço em um arquivo chamado service.yaml no espaço de trabalho local:

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

   Substitua SERVICE pelo nome do serviço de veiculação do Knative.

2. No seu arquivo local, atualize o atributo labels:

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

   Substituir

   • SERVICE pelo nome do serviço de veiculação do Knative
   • LABEL pelo nome do rótulo;
   • VALUE pelo valor desejado.

3. Substitua o serviço pela nova configuração usando o seguinte comando:

   gcloud run services replace service.yaml

Como listar serviços por rótulo

É possível listar serviços por rótulo usando um filtro da Google Cloud CLI:

  gcloud run services list --filter metadata.labels.LABEL=VALUE
  

Substitua:

• LABEL pelo nome do rótulo;
• VALUE pelo valor a ser incluído na lista filtrada

Exclusão de um rótulo

Use o console ou os rótulos de exclusão de linha de comando.

Console

1. Acesse a veiculação do Knative no console do Google Cloud:

Acessar a veiculação do Knative

1. Marque a caixa de seleção à esquerda do serviço do qual você está excluindo o rótulo.

2. Verifique se o Painel de informações no canto direito está ativado (Mostrar painel de informações).

3. Clique em Rótulos para exibir o painel de rótulos.

4. Localize o rótulo que você quer excluir.

5. Passe o cursor à direita da caixa de texto Valor do rótulo para exibir o ícone de lixeira e clique nele.

6. Clique em Salvar.

Linha de comando

Para limpar todos os rótulos de um serviço:

gcloud run services update SERVICE --clear-labels

Para excluir rótulos específicos de um serviço, forneça uma lista de chaves delimitada por vírgulas:

gcloud run services update SERVICE --remove-labels LABEL

Substituir

• SERVICE pelo nome do serviço de veiculação do Knative
• LABEL pelo nome do rótulo