Tags são pares de chave-valor que podem ser aplicadas aos serviços para controle de acesso detalhado. Os administradores de tags criam tags para recursos no Google Cloud no nível da organização ou do projeto e as gerenciam no Resource Manager. As tags fornecem uma maneira de permitir ou negar políticas condicionalmente, se um recurso tiver uma tag específica.
As tags anexadas aos serviços do Cloud Run não podem ser confundidas com as tags de tráfego do Cloud Run, que permitem rotear o tráfego para revisões específicas do Cloud Run.
Funções exigidas
Para ter as permissões necessárias para anexar ou remover tags, peça ao administrador para conceder a você os seguintes papéis do IAM no serviço do Cloud Run:
-
Administrador do Cloud Run (
roles/run.admin
) -
Usuário de tags (
roles/resourcemanager.tagUser
)
Para gerenciar o acesso ao recurso de valor da tag no Resource Manager, sua conta também precisa ter o papel Usuário da tag (roles/resourcemanager.tagUser
) concedido a o valor da tag.
O valor da tag é o recurso anexado ao serviço do Cloud Run.
Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o serviço do Cloud Run interage com as APIs do Google Cloud, como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.
Como anexar tags
Anexar uma tag ao serviço não resulta na criação de uma nova revisão.
É possível anexar ou desanexar tags usando o console do Google Cloud ou a linha de comando gcloud.
Console
Marque a caixa de seleção à esquerda do serviço em que você vai definir a tag.
Clique em Tags acima da lista de serviços para exibir o painel de tags.
Se a organização não aparecer no painel Tags, clique em Selecionar escopo. Selecione sua organização e clique em Abrir.
Para anexar uma nova tag ao serviço, clique em Adicionar tag e selecione uma das chaves de tag do menu suspenso de chaves. Em seguida, selecione um valor do menu suspenso de valor.
Clique em Salvar e confirme as alterações, se solicitado.
Linha de comando
Atualize as tags de um serviço usando o comando:
gcloud resource-manager tags bindings create \ --tag-value=TAG_VALUE \ --parent=//run.googleapis.com/projects/PROJECT_ID/locations/REGION/services/SERVICE \ --location=REGION
Para atualizar mais de uma tag, forneça uma lista delimitada por vírgulas de pares de chave-valor.
Substituir
- TAG_VALUE pelo valor da chave: é possível usar estes
diferentes tipos de identificadores: um ID permanente como
tagValues/12345678901
, um valor de namespace como123456789012/env/prod
ou um nome curto, comoprod
- PROJECT_ID pelo ID do seu projeto do Google Cloud.
- REGION pela região em que o serviço do Cloud Run foi implantado.
- SERVICE pelo nome do serviço do Cloud Run;
Remover uma tag
É possível usar o console ou a linha de comando para separar as tags do seu serviço.
Console
Marque a caixa de seleção à esquerda do serviço do qual a tag está sendo removida.
Clique em Tags acima da lista de serviços para exibir o painel de tags.
Localize a tag que você quer remover.
Passe o cursor à direita do menu suspenso Valor da tag para exibir o ícone de lixeira e clique nela.
Clique em Salvar e confirme as alterações, se solicitado.
Linha de comando
Para remover uma tag de um serviço:
gcloud resource-manager tags bindings delete \ --tag-value=TAG_VALUE \ --parent=//run.googleapis.com/projects/PROJECT_ID/locations/REGION/services/SERVICE \ --location=REGION
Para remover mais de uma tag, forneça uma lista delimitada por vírgulas de pares de chave-valor.
Substituir
- TAG_VALUE pelo valor da chave: é possível usar estes
diferentes tipos de identificadores: um ID permanente como
tagValues/12345678901
, um valor de namespace como123456789012/env/prod
ou um nome curto, comoprod
- PROJECT_ID pelo ID do seu projeto do Google Cloud.
- REGION pela região em que o serviço do Cloud Run foi implantado.
- SERVICE pelo nome do serviço do Cloud Run;