Como usar rótulos

Nesta página, mostramos como definir, modificar e excluir rótulos no serviço e nas revisões do Cloud Run. No Cloud Run, os 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, 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 possíveis usos incluem:

  • Usar para alocação de custos e detalhamentos de faturamento
  • Identificar recursos usados por equipes ou centros de custo individuais
  • Diferenciar ambientes de implantação (produção, preparo, controle de qualidade ou teste)
  • Identificar os proprietários e os rótulos de estado

Regras de uso de rótulos

A regra a seguir se aplica ao uso de rótulos definidos em um serviço do Cloud Run:

Somente rótulos válidos do Google Cloud podem ser usados no Cloud Run.

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 receberão 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 linha de comando gcloud ou um arquivo YAML ao implantar uma nova revisão.

Console

  1. Acessar o Cloud Run

  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

Atualize os rótulos de um serviço usando o comando:

gcloud run services update SERVICE --update-labels KEY=VALUE

Para atualizar mais de um rótulo, forneça uma lista delimitada por vírgulas de pares de chave-valor. O comando update-labels define um novo valor para a chave de rótulo, se ele já existir. Caso contrário, ele criará um novo rótulo.

Substitua:

  • SERVICE pelo nome do serviço do Cloud Run;
  • KEY pelo nome da chave do rótulo;
  • VALUE pelo valor da chave.

Também é possível definir rótulos durante a implantação:

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

Para criar mais de um rótulo durante a implantação, forneça uma lista de pares chave-valor delimitada por vírgulas.

YAML

É possível fazer o download e ver a configuração do serviço atual usando o comando gcloud run services describe --format export, que produz resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run services replace. Modifique os campos somente conforme documentado.

  1. Para visualizar e fazer o download da configuração:

    gcloud run services describe SERVICE --format export > service.yaml
  2. 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 Cloud Run;
    • 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 do SDK do Cloud:

  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. Acessar o Cloud Run

  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 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 Cloud Run;
  • LABEL pelo nome do rótulo