As etiquetas são uma forma simples de organizar implementações relacionadas ou associadas entre si. Por exemplo, uma prática comum é etiquetar as implementações destinadas à produção, à preparação ou ao desenvolvimento separadamente, para que possa pesquisar facilmente as implementações que pertencem a cada fase quando necessário.
O que são etiquetas?
Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud implementações. 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 encargos 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 implementações 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 criar 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.
Criar uma implementação com etiquetas
Quando cria uma implementação, pode adicionar etiquetas fornecendo um ou mais pares de chave-valor como etiquetas quando cria a implementação. Se tiver uma implementação existente, pode atualizá-la para adicionar novas etiquetas ou alterar as etiquetas existentes.
Tem de usar a CLI gcloud ou a API para criar uma implementação com etiquetas.
gcloud
Em gcloud, adicione etiquetas à sua implementação fornecendo a flag --labels, seguida de uma lista separada por vírgulas de pares de chave-valor. Por exemplo, o comando seguinte adiciona duas etiquetas à implementação, environment=production e storage=media:
gcloud deployment-manager deployments create example-deployment --config example-config.yaml \
--labels environment=production,storage=media
Para ver as etiquetas aplicadas à implementação, obtenha uma descrição da implementação:
gcloud deployment-manager deployments describe example-deployment
---
fingerprint: 0p03t0z31PQLOrGH8KdhWQ==
id: '2204841443843636456'
insertTime: '2017-04-18T09:42:47.323-07:00'
labels:
- key: environment
value: production
- key: storage
value: media
manifest: manifest-1492533767362
name: example-deployment
operation:
endTime: '2017-04-18T09:43:04.581-07:00'
name: operation-1492533767010-54d7398ff76d1-7930b926-f64e72ae
operationType: insert
progress: 100
startTime: '2017-04-18T09:42:48.034-07:00'
status: DONE
user:user@example.com
API
Na API, siga as instruções para
criar a sua implementação
e inclua a nova propriedade labels no corpo do pedido. Por exemplo:
{
"name": "example-deployment",
"target": {
"config": {
"content": "..."
},
}
"labels": [
{
"key": "environment",
"value": "production"
},
{
"key": "storage",
"value": "media"
}
]
}
A remover Marcadores
Consola
Aceda à página Implementações na Google Cloud consola.
Se lhe for solicitado, selecione o seu projeto e clique em Continuar.
Selecione a caixa junto à implementação cujas etiquetas quer remover. É apresentado um painel lateral.
Clique em X junto a cada etiqueta que quer remover.
Guarde as alterações.
gcloud
Em gcloud, remova etiquetas com o comando deployments update e
fornecendo a flag --remove-labels, seguida de uma lista separada por vírgulas de
chaves de etiquetas a remover.
Por exemplo, o seguinte remove uma etiqueta com a chave environment:
gcloud deployment-manager deployments update example-deployment --remove-labels environment
API
Na API, siga as instruções para
atualizar a sua implementação
e inclua uma atualização à sua implementação que não contenha a propriedade labels no corpo do pedido, removendo efetivamente as etiquetas.
Adicionar ou atualizar etiquetas
Pode adicionar novas etiquetas ou atualizar etiquetas em implementações existentes.
Consola
Aceda à página Implementações na Google Cloud consola.
Se lhe for solicitado, selecione o seu projeto e clique em Continuar.
Selecione a caixa junto à implementação a partir da qual quer atualizar as etiquetas. É aberto um painel lateral.
Para alterar os valores das etiquetas, atualize as entradas de etiquetas adequadas. Se quiser alterar a chave da etiqueta, tem de eliminar a etiqueta e adicioná-la novamente com a nova chave.
Guarde as alterações.
gcloud
Em gcloud, atualize ou adicione novas etiquetas através do comando deployments update
e fornecendo a flag --update-labels, seguida de uma lista
de etiquetas atualizadas separadas por vírgulas:
Por exemplo, o seguinte atualiza a etiqueta environment:
gcloud deployment-manager deployments update example-deployment --update-labels environment=production
API
Na API, siga as instruções para atualizar a implementação e, no corpo do pedido, omita a propriedade labels, que remove as etiquetas da implementação.
Adicionar etiquetas durante as pré-visualizações da implementação
Antes de criar uma implementação, pode pré-visualizar a implementação. Como parte da pré-visualização, pode atribuir etiquetas à implementação pré-visualizada. Por exemplo:
gcloud deployment-manager deployments create example-deployment --config example-config.yaml \
--labels environment=production --preview
Para alterar as etiquetas durante a pré-visualização, tem de atualizar a pré-visualização com as novas etiquetas. Para saber mais sobre as pré-visualizações, leia a documentação Pré-visualizar uma configuração.
Filtrar pesquisas com etiquetas
Pode pesquisar os seus recursos e filtrar os resultados por etiquetas.
Consola
Aceda à página Implementações na Google Cloud consola.
Se lhe for solicitado, selecione o seu projeto e clique em Continuar.
Na barra de pesquisa, comece a escrever
labels.. A barra de pesquisa apresenta automaticamente uma lista de etiquetas que pode usar para filtrar.
gcloud
Em gcloud, faça um pedido list e use a flag --filter.
Para filtrar por etiquetas, use a sintaxe labels.[KEY]=[VALUE]. Por exemplo, se quiser filtrar por uma etiqueta com environment como chave e production como valor, pode executar este comando:
gcloud deployment-manager deployments list --filter labels.environment=production
Para aceder à documentação completa sobre a sintaxe de filtros na CLI gcloud,
consulte a documentação do gcloud topic filters.
API
Na API, faça um pedido de lista com um parâmetro de consulta filter codificado por URL.
Por exemplo, para filtrar com base numa chave de etiqueta environment igual ao valor
production, faça o seguinte pedido GET:
GET https://www.googleapis.com/deploymentmanager/v2/deployments/list?filter=labels.environment+eq+production
Para mais informações, leia a filterdocumentação
na referência da API.
O que se segue?
- Saiba como eliminar as suas implementações.
- Saiba mais acerca da atualização de implementações existentes.