Como usar rótulos

Saiba como criar e usar rótulos nos serviços e revisões do Cloud Run para Anthos no Google Cloud.

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 Cloud Run for Anthos, 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 Cloud Run for Anthos 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 Cloud Run for Anthos.

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 ferramenta de linha de comando gcloud ou um arquivo YAML ao implantar um novo serviço ou atualizar um serviço atual e implante uma revisão:

Console

  1. Acessar o Cloud Run for Anthos no Google Cloud

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

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

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

    Definir rótulo

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

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

  7. Clique em Salvar.

Linha de comando

É possível usar um dos seguintes comandos gcloud kuberun para definir rótulos de novos serviços ou atualizar um serviço atual:

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

    Exemplo:

    gcloud kuberun core 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"
      
  • Para novos serviços, defina rótulos executando o comando gcloud kuberun core services create com o parâmetro --set-labels:

    gcloud kuberun core services create 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/myproject/my-image:latest;
    • 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"
      

YAML

Para usar um arquivo YAML para modificar a configuração do serviço atual, consiga uma cópia da configuração atual, modifique e salve as alterações em um arquivo local e, em seguida, implante essas alterações no serviço.

  1. Exiba como YAML e copie a configuração do serviço em um arquivo local, por exemplo, service.yaml:

    gcloud kuberun core services describe SERVICE --format yaml

    Substitua SERVICE pelo nome do serviço do Cloud Run for Anthos.

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

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

    Replace

    • SERVICE pelo nome do serviço do Cloud Run for Anthos;
    • LABEL pelo nome do rótulo;
    • VALUE pelo valor desejado.
  3. Substitua o serviço pela nova configuração usando o seguinte comando:

    gcloud beta run services replace service.yaml

Como listar serviços por rótulo

É possível listar serviços por rótulo usando um filtro do SDK do Cloud:

  gcloud kuberun core 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. Acessar o Cloud Run for Anthos no Google Cloud

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

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

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

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

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

  7. Clique em Salvar.

Linha de comando

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

gcloud kuberun core 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 kuberun core services update SERVICE --remove-labels LABEL

Substitua:

  • SERVICE pelo nome do serviço do Cloud Run for Anthos;
  • LABEL pelo nome do rótulo.