Como usar marcadores

Aprenda a criar e usar rótulos nos serviços e revisões do Knative serving.

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 do Knative serving, 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 do Knative serving são rótulos de recursos do Kubernetes e não são propagados para o Google Cloud. Para saber 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 serving.

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 o Knative serving no console do Google Cloud:

Acessar o Knative serving

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 seu serviço do Knative serving.

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

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

   Substitua

   • SERVICE pelo nome do serviço do Knative serving
   • 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 o Knative serving no console do Google Cloud:

Acessar o Knative serving

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

Substitua

• SERVICE pelo nome do serviço do Knative serving
• LABEL pelo nome do rótulo