Repositórios de rótulos

Use rótulos para identificar e agrupar repositórios relacionados. É possível especificar vários rótulos para um repositório.

Para agrupar repositórios e outros recursos do Google Cloud para fins de relatório, auditoria e controle de acesso na sua organização do Google Cloud, use tags. As tags e os rótulos funcionam independentemente uns dos outros, e é possível aplicar os dois ao mesmo repositório.

O que são rótulos?

Um rótulo é um par de chave-valor que ajuda a organizar seus repositórios do Google Cloud. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre marcadores são encaminhadas ao sistema de faturamento para que você possa desmembrar as cobranças faturadas por marcador.

Os rótulos podem ser usados como anotações de consulta para recursos, mas não podem ser usados para definir condições em políticas. As tags fornecem uma maneira de permitir ou negar políticas condicionalmente se um recurso tiver uma tag específica. Para mais informações, consulte a Visão geral das tags.

Rótulos e tags

As tags são uma ferramenta separada usada para fornecer controle detalhado sobre as políticas. Para mais informações, consulte a Visão geral de tags.

Usos comuns dos rótulos

Não recomendamos a criação de um grande número de rótulos exclusivos, como carimbos de data/hora ou valores individuais para todas as chamadas de API. Veja alguns casos de uso comum de rótulos:

  • Rótulos de centro de custo ou de equipe: adicione rótulos com base na equipe ou no centro de custo para distinguir repositórios pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). É possível usar esse tipo de rótulo para contabilidade de custos ou em orçamentos.

  • Rótulos de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Rótulos de ambientes ou de estágios: por exemplo, environment:production e environment:test.

  • Rótulos de estado: por exemplo, state:active, state:readytodelete e state:archive.

Requisitos para rótulos

Os rótulos aplicados a um recurso precisam atender aos seguintes requisitos:

  • Cada recurso pode ter vários rótulos, até um máximo de 64.
  • Cada rótulo precisa ser um par de chave-valor.
  • As chaves têm comprimento mínimo de 1 e máximo de 63 caracteres. Além disso, elas não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 caracteres.
  • As chaves e os valores contêm apenas letras minúsculas, caracteres numéricos, sublinhados e traços. Todos os caracteres precisam usar a codificação UTF-8, e os caracteres internacionais são permitidos.
  • A parte principal de um rótulo precisa ser exclusiva em um único recurso. No entanto, é possível usar a mesma chave com vários recursos.
  • As chaves precisam começar com uma letra minúscula ou um caractere internacional.

Esses limites se aplicam à chave e ao valor de cada rótulo e aos recursos individuais do Google Cloud que têm rótulos. Não há limite para a quantidade de rótulos que podem ser aplicados a todos os recursos em um projeto.

Como adicionar e atualizar rótulos

É possível adicionar um ou mais rótulos a um repositório. Também é possível editar o valor de um rótulo existente.

Para rotular um repositório:

Console

  1. Abra a página Repositórios no console.

    Abrir a página Repositórios

  2. Selecione um repositório.

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

  4. No painel de informações, clique na guia Rótulos.

  5. Adicione ou edite rótulos:

    1. Para adicionar um rótulo, clique em Adicionar rótulo. Especifique o par de chave e valor do rótulo e clique em Salvar.
    2. Para editar um rótulo existente, altere o valor do rótulo e clique em Salvar.

gcloud

É possível especificar um ou mais rótulos para adicionar ou editar.

  • Se houver um rótulo, o valor correspondente será atualizado.
  • Se não houver um rótulo, o rótulo será criado.
  • Se o comando também incluir a sinalização --clear-labels, todos os rótulos atuais serão removidos antes de adicionar novos rótulos.

Execute este comando:

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

em que

  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, será possível omitir essa sinalização para usar o padrão.
  • PROJECT é o ID do projeto do Google Cloud; Se essa sinalização for omitida, o projeto atual ou padrão será usado.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.
  • KEY=VALUE,... é uma lista de rótulos separados por vírgulas especificados 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

Como filtrar repositórios por rótulo

É possível filtrar listas de repositórios por rótulo no Console do Google Cloud ou usando a Google Cloud CLI.

Console

  1. Abra a página Repositórios no console.

    Abrir a página Repositórios

  2. No campo Filtro, selecione Rótulos como o critério do filtro e insira a chave, o valor ou o par de chave-valor.

    Por exemplo, para mostrar apenas repositórios com o rótulo env:dev, insira uma das seguintes opções:

    • Digite a chave: env
    • Insira o valor: dev
    • Insira o par de chave-valor: env:dev

gcloud

Para filtrar com base nos rótulos, use a sinalização --filter com o comando gcloud artifacts repositórios list.

O valor da sinalização --filter precisa estar no formato labels.KEY=VALUE. Por exemplo, se você quiser filtrar repositórios no projeto ativo em um rótulo com env como a chave e dev como o valor, é possível executar este comando:

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

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

Como excluir rótulos

Para excluir rótulos:

Console

  1. Abra a página Repositórios no console.

    Abrir a página Repositórios

  2. Clique em Selecionar um repositório.

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

  4. No painel de informações, clique na guia Rótulos.

  5. Clique em Excluir item ao lado do rótulo que você quer remover.

gcloud

É possível excluir rótulos específicos ou remover todos os rótulos de um repositório.

Para remover rótulos específicos, execute o seguinte comando:

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

Para remover todos os rótulos, execute o seguinte comando:

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

em que

  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, será possível omitir essa sinalização para usar o padrão.
  • PROJECT é o ID do projeto do Google Cloud; Se essa sinalização for omitida, o projeto atual ou padrão será usado.
  • LOCATION é um local regional ou multirregional. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.
  • LABEL,... é uma lista de rótulos separados por vírgula, 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