Etiquete repositórios

Use etiquetas para identificar e agrupar repositórios relacionados. Pode especificar várias etiquetas para um repositório.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Cloud de Confiance by S3NS repositórios. Ajudam a organizar estes recursos e a gerir os custos em grande escala, com a granularidade de que precisa. Pode anexar uma etiqueta a cada recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas.

Requisitos para etiquetas

As etiquetas aplicadas a um recurso têm de cumprir os seguintes requisitos:

  • Cada recurso pode ter até 64 etiquetas.
  • Cada etiqueta tem de ser um par chave-valor.
  • As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
  • As chaves e os valores só podem conter letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais. As chaves têm de começar com uma letra minúscula ou um caráter internacional.
  • A parte da chave de uma etiqueta tem de ser exclusiva num único recurso. No entanto, pode usar a mesma chave com vários recursos.

Estes limites aplicam-se à chave e ao valor de cada etiqueta, bem como aos recursos Cloud de Confiance individuais que têm etiquetas. Não existe um limite para o número de etiquetas que pode aplicar a todos os recursos num projeto.

Utilizações comuns das etiquetas

Seguem-se alguns exemplos de utilização comuns das etiquetas:

  • Etiquetas de equipa ou centro de custos: adicione etiquetas com base na equipa ou no centro de custos para distinguir repositórios pertencentes a diferentes equipas (por exemplo, team:research e team:analytics). Pode usar este tipo de etiqueta para contabilidade de custos ou orçamentação.

  • Etiquetas de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etiquetas de ambiente ou fase: por exemplo, environment:production e environment:test.

  • Etiquetas de estado: por exemplo, state:active,state:readytodelete e state:archive.

  • Etiquetas de propriedade: usadas para identificar as equipas responsáveis pelas operações, por exemplo: team:shopping-cart.

Não recomendamos a criação de um grande número de etiquetas únicas, como para carimbos de data/hora ou valores individuais para cada chamada da API. O problema desta abordagem é que, quando os valores mudam frequentemente ou com chaves que desorganizam o catálogo, torna-se difícil filtrar e gerar relatórios sobre os recursos de forma eficaz.

Adicionar e atualizar etiquetas

Pode adicionar uma ou mais etiquetas a um repositório. Também pode editar o valor de uma etiqueta existente.

Para etiquetar um repositório:

Consola

  1. Abra a página Repositórios na Cloud de Confiance consola.

    Abra a página Repositórios

  2. Selecione um repositório.

  3. Se o painel de informações junto à lista de repositórios não estiver aberto, clique em Mostrar painel de informações.

  4. No painel de informações, clique no separador Etiquetas.

  5. Adicione ou edite etiquetas:

    1. Para adicionar uma etiqueta, clique em Adicionar etiqueta. Especifique o par chave-valor para a etiqueta e, de seguida, clique em Guardar.
    2. Para editar uma etiqueta existente, altere o valor da etiqueta e, de seguida, clique em Guardar.

gcloud

Pode especificar uma ou mais etiquetas para adicionar ou editar.

  • Se existir uma etiqueta, o valor correspondente é atualizado.
  • Se uma etiqueta não existir, é criada.
  • Se o comando também incluir a flag --clear-labels, todas as etiquetas existentes são removidas antes de adicionar novas etiquetas.

Execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

Substitua o seguinte:

  • REPOSITORY é o nome do repositório. Se tiver configurado um repositório predefinido, pode omitir esta flag para usar a predefinição.
  • PROJECT é o Cloud de Confiance by S3NS ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
  • LOCATION é a localização regional do repositório. Pode omitir a sinalização `--location` para usar a predefinição.
  • KEY=VALUE,... é uma lista de etiquetas separadas por vírgulas especificadas como pares de chave-valor. Por exemplo: team=team-1,product=example_product,stage=development.

Para mais informações sobre o comando, execute o seguinte comando:

gcloud artifacts repositories update --help

Filtrar repositórios por etiqueta

Pode filtrar listas de repositórios por etiqueta na Cloud de Confiance consola ou através da CLI Google Cloud.

Consola

  1. Abra a página Repositórios na Cloud de Confiance consola.

    Abra a página Repositórios

  2. No campo Filtro, selecione Etiquetas como os critérios de filtro e, de seguida, introduza a chave, o valor ou o par chave-valor.

    Por exemplo, para mostrar apenas repositórios com a etiqueta env:dev, pode introduzir qualquer um dos seguintes comandos:

    • Introduza a chave: env
    • Introduza o valor: dev
    • Introduza o par de chave-valor: env:dev

gcloud

Para filtrar com base em etiquetas, use a flag --filter com o comando gcloud artifacts repositories list.

O valor da flag --filter tem de estar no formato labels.KEY=VALUE Por exemplo, se quiser filtrar repositórios no projeto ativo numa etiqueta com env como chave e dev como valor, pode executar este comando:

gcloud artifacts repositories list --filter labels.env=dev

Para mais informações sobre a sintaxe de filtros na CLI gcloud, consulte a gcloud topic filters documentação.

A eliminar etiquetas

Para eliminar etiquetas:

Consola

  1. Abra a página Repositórios na Cloud de Confiance consola.

    Abra a página Repositórios

  2. Clique em Selecionar um repositório.

  3. Se o painel de informações junto à lista de repositórios não estiver aberto, clique em Mostrar painel de informações.

  4. No painel de informações, clique no separador Etiquetas.

  5. Clique em Eliminar item junto à etiqueta que quer remover.

gcloud

Pode eliminar etiquetas específicas ou remover todas as etiquetas de um repositório.

Para remover etiquetas específicas, execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

Para remover todas as etiquetas, execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

Substitua o seguinte:

  • REPOSITORY é o nome do repositório. Se tiver configurado um repositório predefinido, pode omitir esta flag para usar o predefinido.
  • PROJECT é o Cloud de Confiance by S3NS ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
  • LOCATION é a localização regional do repositório. Use esta flag para ver repositórios numa localização específica. Se tiver configurado uma localização predefinida, pode omitir esta flag para usar a predefinição.
  • LABEL,... é uma lista de etiquetas separadas por vírgulas, as chaves de cada par KEY=VALUE. Por exemplo: team,product.

Para mais informações sobre o comando, execute o seguinte comando:

   gcloud artifacts repositories update --help