Esta página foi traduzida pela API Cloud Translation.

Repositórios de tags

Use tags para agrupar repositórios e outros recursos em Google Cloud para gerar relatórios, auditorias e controle de acesso na sua Google Cloud organização.

Para agrupar repositórios no Artifact Registry para fins de automação e faturamento, use rótulos. As tags e os rótulos funcionam independentemente uns dos outros, e você pode aplicar os dois ao mesmo repositório. Para mais informações sobre as diferenças entre tags e rótulos, consulte Tags e rótulos.

O que são tags?

Tags são pares de chave-valor que podem ser aplicadas aos recursos para controle de acesso detalhado.

Os administradores de projeto criam tags para recursos no nível da organização e as gerenciam no Resource Manager. Google Cloud Ao anexar uma tag a um repositório do Artifact Registry, é possível usar a tag com condições do IAM para conceder acesso condicional ao repositório. Não é possível anexar tags a artefatos individuais.

Lembre-se destas restrições:

As políticas da organização podem referenciar condicionalmente as tags herdadas do projeto pai e superiores, mas não são compatíveis com tags anexadas diretamente a repositórios.
Os registros de auditoria do Cloud não são gerados para anexar tags e visualizar vinculações de tag em repositórios.

Para mais informações sobre tags e controle de acesso condicional com tags, consulte Tags e controle de acesso.

Permissões necessárias

As permissões necessárias dependem da ação que você precisa realizar.

Para receber essas permissões, peça ao administrador para conceder o papel sugerido no nível apropriado da hierarquia de recursos.

Visualizar tags

Para visualizar as definições de tag e tags anexadas aos recursos, você precisa do papel Visualizador de tags (roles/resourcemanager.tagViewer) ou de outro papel que inclua as seguintes permissões:

Permissões necessárias

resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings para o tipo de recurso apropriado. Por exemplo, compute.instances.listTagBindings para visualizar as tags anexadas a instâncias do Compute Engine.
listEffectiveTags

compute.instances.listEffectiveTags

Para visualizar as tags no nível da organização, é preciso ter o papel de Visualizador da organização (roles/resourcemanager.organizationViewer) no recurso da organização.

Administrar tags

Para criar, atualizar e excluir definições de tag, você precisa do papel Administrador de tags (roles/resourcemanager.tagAdmin) ou de outro papel que inclua as seguintes permissões:

Permissões necessárias

resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy

Para administrar tags no nível da organização, você precisa do papel de Visualizador da organização (roles/resourcemanager.organizationViewer) no recurso da organização.

Gerenciar tags em recursos

Para adicionar e remover tags anexadas a recursos, você precisa do papel Usuário da tag (roles/resourcemanager.tagUser) ou de outro papel com permissões equivalentes, no valor da tag e nos recursos que você está anexando ao valor da tag. O papel Tag User inclui as seguintes permissões:

Permissões necessárias

As permissões necessárias para o recurso ao qual você está anexando o valor da tag

Permissão createTagBinding específica do recurso, como compute.instances.createTagBinding para instâncias do Compute Engine
Permissão deleteTagBinding específica do recurso, como compute.instances.deleteTagBinding para instâncias do Compute Engine

As permissões necessárias para o valor da tag:

resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete

Permissões que permitem visualizar projetos e definições de tags:

resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get

Como anexar tags aos repositórios

Depois que um administrador do projeto criar tags, você poderá anexá-las a um repositório. Cada tag tem uma chave e um valor. Você pode marcar um repositório vinculando um valor a ele.

Para anexar uma tag a um repositório:

Console

Peça ao administrador o valor da tag que você quer anexar.

É possível anexar um valor de tag a um destes tipos de identificadores:
- Um nome com namespace, como 123456789012/env/dev
- Um ID permanente, como tagValues/567890123456
Abra a página Repositórios no console do Google Cloud.

Abrir a página Repositórios
Selecione o repositório que você quer marcar.
Na seção Detalhes do repositório, clique em Mostrar mais.

As tags atuais do repositório, incluindo as herdadas, são mostradas.
Clique no ícone Editar tags.
Na seção Tags diretas, clique em Selecionar escopo.
Selecione o projeto do repositório.
No campo chave, digite para filtrar a lista de tags e selecione a chave.
No campo Valor, digite para filtrar a lista de tags e selecione o valor da tag.
Clique em Salvar.
Clique em Confirmar.

A tag é anexada ao repositório.

CLI da gcloud

Peça ao administrador o valor da tag que você quer anexar.

É possível anexar um valor de tag a um destes tipos de identificadores:
- Um nome com namespace, como 123456789012/env/dev
- Um ID permanente, como tagValues/567890123456
Anexe o valor da tag com o seguinte comando:
```
gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE \
    --parent=REPOSITORY_ID \
    --location=LOCATION
```
Substitua os seguintes valores:
- TAG_VALUE é o ID permanente ou o nome do namespace do valor da tag a ser anexado.
- REPOSITORY_ID é o ID completo do repositório, incluindo o nome de domínio da API para identificar o tipo de recurso (//artifactregistry.googleapis.com/). Por exemplo, //artifactregistry.googleapis.com/projects/my-project/locations/us-east1/repositories/my-repo
- LOCATION é o local do repositório.
Veja o exemplo a seguir.
- Valor da tag: 815471563813/env/dev
- Projeto: my-project
- Repositório: my-repo
- Local do repositório: us-east1
O comando da CLI gcloud a seguir anexa a tag ao repositório:
```
gcloud resource-manager tags bindings create \
    --tag-value=815471563813/env/dev \
    --parent=//artifactregistry.googleapis.com/projects/my-project/locations/us-east1/repositories/my-repo \
    --location=us-east1
```

Como listar tags anexadas a repositórios

É possível listar as tags anexadas a um recurso que você tem permissão para acessar.

Console

Abra a página Repositórios no console do Google Cloud.

Abrir a página Repositórios
Selecione o repositório que você quer acessar.
Na seção Detalhes do repositório, clique em Mostrar mais.

A lista Tags mostra todas as tags do repositório, incluindo tags diretas e herdadas de níveis mais altos na hierarquia de recursos.

CLI da gcloud

Para listar as tags anexadas a um repositório, execute o seguinte comando:

gcloud resource-manager tags bindings list \
        --parent=REPOSITORY_ID \
        --location=LOCATION

O comando só lista as tags anexadas diretamente ao recurso especificado. Portanto, ele não retorna tags herdadas do projeto pai ou superior. É possível listar tags herdadas do projeto pai especificando um projeto em vez de um repositório com a flag --parent.

Por exemplo, este comando lista as tags anexadas ao repositório my-repo no projeto my-project e no local us-east1:

gcloud resource-manager tags bindings list \
    --parent=//artifactregistry.googleapis.com/projects/my-project/locations/us-east1/repositories/my-repo \
    --location=us-east1

Este comando lista as tags anexadas ao número de projeto 7890123456:

gcloud resource-manager tags bindings list \
    --parent=//cloudresourcemanager.googleapis.com/projects/7890123456 \

Como remover tags de repositórios

É possível desanexar uma tag anexada diretamente a um repositório. Se você precisar remover uma tag herdada do projeto pai ou de outra parte da hierarquia de recursos, um administrador do projeto precisará desafixar a tag do recurso a que ela está anexada.

Para remover uma tag anexada a um repositório:

Console

Acesse o valor da tag que você quer remover. Se você não souber o valor da tag, listar as tags anexadas ao repositório.
Abra a página Repositórios no console do Google Cloud.

Abrir a página Repositórios
Selecione o repositório.
Na seção Detalhes do repositório, clique em Mostrar mais.

As tags atuais do repositório, incluindo as herdadas, são mostradas.
Clique no ícone Editar tags.
Na seção Tags diretas, localize a tag que você quer remover.
Clique no ícone excluir ao lado da tag que você quer remover.
Clique em Salvar.
Clique em Confirmar.

A tag é removida do repositório.

CLI da gcloud

Acesse o valor da tag que você quer remover. Se você não souber o valor da tag, listar as tags anexadas ao repositório.
Desvincule o valor da tag com o seguinte comando:
```
gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE \
    --parent=REPOSITORY_ID \
    --location=LOCATION
```
Substitua os seguintes valores:
- Valor da tag TAG_VALUE a ser removida.
- REPOSITORY_ID é o ID completo do repositório, incluindo o nome de domínio da API para identificar o tipo de recurso (//artifactregistry.googleapis.com/). Por exemplo, //artifactregistry.googleapis.com/projects/my-project/my-repo
- LOCATION é o local do repositório.
Veja o exemplo a seguir.
- Valor da tag: 815471563813/env/dev
- Projeto: my-project
- Repositório: my-repo
- Local do repositório: us-east1
O comando da CLI gcloud a seguir desanexa a tag do repositório:
```
gcloud resource-manager tags bindings delete \
    --tag-value=815471563813/env/dev \
    --parent=//artifactregistry.googleapis.com/projects/my-project/locations/us-east1/repositories/my-repo \
    --location=us-east1
```

A seguir

Saiba mais sobre rótulos de repositório.