Use etiquetas para identificar e agrupar repositórios relacionados. Pode especificar várias etiquetas para um repositório.
Para agrupar repositórios e outros recursos em Google Cloud para relatórios, auditoria e controlo de acesso na sua Google Cloud organização, use marcadores. As etiquetas e os rótulos funcionam independentemente uns dos outros e pode aplicá-los ambos ao mesmo repositório.O que são etiquetas?
Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud 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. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discriminar os custos faturados por etiqueta. Com os relatórios de faturação integrados, pode filtrar e agrupar os custos por etiquetas de recursos. Também pode usar etiquetas para consultar exportações de dados de faturação.
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 Google Cloud 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:researcheteam: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:ingestecomponent:dashboard.Etiquetas de ambiente ou fase: por exemplo,
environment:productioneenvironment:test.Etiquetas de estado: por exemplo,
state:active,state:readytodeleteestate: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.
Etiquetas e marcadores
As etiquetas podem ser usadas como anotações consultáveis para recursos, mas não podem ser usadas para definir condições nas políticas. As etiquetas oferecem uma forma de permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica, oferecendo um controlo detalhado sobre as políticas. Para mais informações, consulte a Vista geral das etiquetas.
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
Abra a página Repositórios na Google Cloud consola.
Selecione um repositório.
Se o painel de informações junto à lista de repositórios não estiver aberto, clique em Mostrar painel de informações.
No painel de informações, clique no separador Etiquetas.
Adicione ou edite etiquetas:
- Para adicionar uma etiqueta, clique em Adicionar etiqueta. Especifique o par chave-valor para a etiqueta e, de seguida, clique em Guardar.
- 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 Google Cloud ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.-
LOCATIONé a localização regional ou multirregional 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 Google Cloud consola ou através da CLI Google Cloud.
Consola
Abra a página Repositórios na Google Cloud consola.
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
- Introduza a chave:
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
Abra a página Repositórios na Google Cloud consola.
Clique em Selecionar um repositório.
Se o painel de informações junto à lista de repositórios não estiver aberto, clique em Mostrar painel de informações.
No painel de informações, clique no separador Etiquetas.
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 Google Cloud ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.-
LOCATIONé a localização regional ou multirregional 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 parKEY=VALUE. Por exemplo:team,product.
Para mais informações sobre o comando, execute o seguinte comando:
gcloud artifacts repositories update --help