Usar etiquetas

Saiba como criar e usar etiquetas nos seus serviços e revisões do Knative serving.

As etiquetas são pares de chave/valor aplicados ao serviço e às revisões. Quando define uma etiqueta num serviço de publicação do Knative, é criada uma nova revisão com esta etiqueta para este serviço. A etiqueta não é aplicada a revisões mais antigas.

As etiquetas para o Knative Serving são etiquetas de recursos do Kubernetes e não são propagadas para o Google Cloud. Para saber como usar etiquetas para analisar a utilização de recursos do cluster, consulte o artigo Compreender a utilização de recursos do cluster.

Regras de utilização das etiquetas

Apenas são permitidas etiquetas Kubernetes válidas no Knative serving.

Definir ou modificar etiquetas

Qualquer alteração de configuração leva à criação de uma nova revisão. As revisões subsequentes também vão receber automaticamente esta definição de configuração, a menos que faça atualizações explícitas para a alterar.

Pode definir ou modificar etiquetas através da Google Cloud consola, da CLI Google Cloud ou de um ficheiro YAML quando implementa um novo serviço ou atualiza um serviço existente e implementa uma revisão:

Consola

  1. Aceda ao Knative serving na Google Cloud consola:

Aceda ao Knative serving

  1. Selecione a caixa de verificação à esquerda do serviço no qual está a definir a etiqueta.

  2. Certifique-se de que o painel de informações no lado direito está ativado (Mostrar painel de informações).

  3. Clique em Etiquetas para apresentar o painel de etiquetas.

    Definir etiqueta

  4. Para editar o valor de uma chave de etiqueta existente, localize a etiqueta e altere o Valor conforme pretendido.

  5. Para definir uma nova etiqueta no serviço, clique em Adicionar etiqueta e indique a chave e o valor.

  6. Clique em Guardar.

Linha de comandos

Pode usar a Google Cloud CLI para definir etiquetas para novos serviços ou para atualizar serviços existentes:

  • Para serviços existentes, atualize as etiquetas executando o comando gcloud run services update com um dos seguintes parâmetros:

    Exemplo:

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

    Substituição:

    • SERVICE com o nome do seu serviço.
    • KEY1=VALUE1,KEY2=VALUE2 com uma lista separada por vírgulas de pares de nome e valor para cada etiqueta. Especifique o nome da etiqueta para cada KEY e o valor para VALUE. Como especificar vários parâmetros.

      • Opções de parâmetros de comandos

      Para especificar vários conjuntos de pares de chave-valor, pode especificar vários parâmetros para facilitar a leitura. Exemplo: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

  • Para novos serviços, defina etiquetas 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

    Substituição:

    • IMAGE_URL com uma referência à imagem do contentor, por exemplo, gcr.io/cloudrun/hello.
    • SERVICE com o nome do seu serviço.
    • KEY1=VALUE1,KEY2=VALUE2 com uma lista separada por vírgulas de pares de nome e valor para cada etiqueta. Especifique o nome da etiqueta para cada KEY e o valor para VALUE. Como especificar vários parâmetros.

      • Opções de parâmetros de comandos

      Para especificar vários conjuntos de pares de chave-valor, pode especificar vários parâmetros para facilitar a leitura. Exemplo: 
      [...]
--set-labels "KEY=VALUE1" \
--set-labels "KEY=VALUE2" \
--set-labels "KEY=VALUE3"

YAML

Pode transferir a configuração de um serviço existente para um ficheiro YAML com o comando gcloud run services describe usando a flag --format=export. Em seguida, pode modificar esse ficheiro YAML e implementar essas alterações com o comando gcloud run services replace. Tem de garantir que modifica apenas os atributos especificados.

  1. Transfira a configuração do seu serviço para um ficheiro denominado 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 de fornecimento do Knative.

  2. No ficheiro local, atualize o atributo labels:

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

    Substituir

    • SERVICE com o nome do seu serviço Knative serving
    • LABEL com o nome da etiqueta
    • VALUE com o valor desejado

  3. Substitua o serviço pela respetiva nova configuração através do seguinte comando:

    gcloud run services replace service.yaml

Indicar serviços por etiqueta

Pode listar os serviços por etiqueta através de um filtro da CLI Google Cloud:

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

Substituição:

  • LABEL com o nome da etiqueta
  • VALUE com o valor a incluir na sua lista filtrada

Eliminar uma etiqueta

Pode usar a consola ou a linha de comandos para eliminar etiquetas.

Consola

  1. Aceda ao Knative serving na Google Cloud consola:

Aceda ao Knative serving

  1. Selecione a caixa de verificação à esquerda do serviço do qual está a eliminar a etiqueta.

  2. Certifique-se de que o painel de informações no lado direito está ativado (Mostrar painel de informações).

  3. Clique em Etiquetas para apresentar o painel de etiquetas.

  4. Localize a etiqueta que quer eliminar.

  5. Passe o cursor do rato à direita da caixa de texto Valor para que a etiqueta apresente o ícone de lixo e clique no ícone de lixo.

  6. Clique em Guardar.

Linha de comandos

Para limpar todas as etiquetas de um serviço:

gcloud run services update SERVICE --clear-labels

Para eliminar etiquetas específicas de um serviço, forneça uma lista de chaves separadas por vírgulas:

gcloud run services update SERVICE --remove-labels LABEL

Substituir

  • SERVICE com o nome do seu serviço Knative serving
  • LABEL com o nome da sua etiqueta