Criar e gerenciar identificadores de clusters

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Nesta página, você encontra uma visão geral dos rótulos de cluster no Google Kubernetes Engine (GKE).

Identificadores de cluster do GKE e identificadores do Kubernetes

Os identificadores de cluster do GKE são diferentes de identificadores no Kubernetes. No cluster do GKE, os rótulos são metadados arbitrários anexados aos recursos que você usa para rastrear as informações de uso e faturamento. No Kubernetes, eles são usados internamente pelo sistema para associar componentes a recursos de cluster e para gerenciar os ciclos de vida dos recursos.

O que são rótulos de cluster?

Um rótulo de cluster é um par de chave-valor que ajuda a organizar os clusters 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 de rótulos de cluster

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

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

  • Rótulos de cluster de componente: por exemplo, component:redis, component:frontend, component:ingeste component:dashboard.

  • Rótulos de cluster de ambiente ou de cenário: por exemplo, environment:production e environment:test.

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

Requisitos para rótulos de cluster

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

  • Cada recurso pode ter vários rótulos de cluster, até um máximo de 64.
  • Cada marcador de cluster precisa ser um par de chave-valor.
  • As chaves têm comprimento mínimo de um caractere e comprimento máximo de 63 caracteres, e 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 de cluster precisa ser exclusiva a 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 de cluster e aos recursos individuais do Google Cloud que têm rótulos de cluster. Não há limite para o número de rótulos de cluster que podem ser aplicados a todos os recursos dentro de um projeto.

Rótulos aplicados automaticamente

O GKE aplica automaticamente vários identificadores aos recursos de cluster.

Por exemplo, o GKE aplica rótulos a instâncias do Compute Engine, discos permanentes e aceleradores (TPU). Os identificadores aplicados automaticamente usam o prefixo goog-gke-.

A tabela a seguir lista os identificadores goog-gke- que o GKE aplica automaticamente aos recursos:

Rótulo Recursos aplicados
goog-gke-node Nós do GKE
goog-gke-volume Discos permanentes anexados a nós do GKE
goog-gke-tpu Cloud TPU no GKE

Não edite ou exclua rótulos reservados. Todas as mudanças feitas nos rótulos goog-gke- reservados são reconciliadas automaticamente.

Propagação de rótulos

No GKE, você aplica identificadores aos clusters. Quando você rotula um cluster, o rótulo se propaga para todos os recursos individuais do cluster, como nós e discos permanentes.

Os rótulos aplicados aos clusters são propagados por meio de um processo em segundo plano executado a cada hora. Isso significa que pode levar até uma hora para que um rótulo apareça em todos os recursos associados ao cluster fornecido. Além disso, os rótulos são propagados somente para instâncias do Compute Engine e discos permanentes zonais anexados a instâncias do Compute Engine. Outros recursos, como cargas de trabalho, regras de encaminhamento, endereços IP e discos permanentes não anexados, não são rotulados.

Antes de começar

Antes de começar, verifique se você realizou as tarefas a seguir:

  • Ativar a API Google Kubernetes Engine.
  • Ativar a API Google Kubernetes Engine
  • Se você quiser usar a Google Cloud CLI para essa tarefa, instale e, em seguida, inicialize a CLI gcloud.

Conseguir uma impressão digital de rótulo para solicitações da API

É possível pular essa etapa se você usa o console do Google Cloud ou a CLI gcloud.

Ao atualizar ou adicionar rótulos de cluster com a API do GKE, é necessário fornecer a impressão digital mais recente do rótulo de cluster na solicitação. Isso evita conflitos com outras solicitações.

Para receber a impressão digital mais recente do rótulo de cluster, execute uma solicitação GET no cluster apropriado. Exemplo:

GET https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster

O resultado será assim:

200 OK

{

 "name": "mycluster",
 "description": "production-cluster",
 "initialNodeCount": 3,
 ...
 "resourceLabels": {
    "environment": "production",
    ...
  },
  "labelFingerprint": "p1ty_9HoBk0="
}

Nessa saída, a propriedade labelFingerprint é a impressão digital do rótulo do cluster.

Criar um cluster com identificadores

Crie um cluster com rótulos usando a ferramenta , o Console do Google Cloud ou a API GKE.

gcloud

Execute este comando:

gcloud container clusters create CLUSTER_NAME \
    --labels KEY=VALUE

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • KEY: a chave do par de chave-valor do rótulo.
  • VALUE: o valor do par de chave-valor do rótulo.

Console

Para adicionar identificadores ao criar o cluster, faça o seguinte:

  1. Acesse a página Google Kubernetes Engine no console do Google Cloud.

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

  3. Configure seu cluster.

  4. No painel de navegação, em Cluster, clique em Metadados.

  5. Clique em Adicionar rótulo.

  6. Adicionar rótulos.

  7. Clique em Criar.

API

Para incluir um rótulo ao criar o cluster, especifique o objeto resourceLabels no objeto cluster fornecido para projects.zones.clusters.create.

Adicionar ou atualizar identificadores de clusters

É possível adicionar ou atualizar identificadores dos clusters atuais usando a CLI gcloud, o Console do Google Cloud ou a API GKE.

gcloud

Execute este comando:

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --update-labels KEY=VALUE

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • COMPUTE_REGION: a região do Compute Engine para o novo cluster. Para clusters zonais, use --zone=COMPUTE_ZONE.
  • KEY: a chave do par de chave-valor do rótulo.
  • VALUE: o valor do par de chave-valor do rótulo.

A atualização do marcador substitui os identificadores existentes no cluster. Se o cluster tiver identificadores existentes que você quer manter, inclua esses identificadores com os novos que você quer adicionar.

Console

Para adicionar ou atualizar rótulos, faça o seguinte:

  1. Acesse a página Google Kubernetes Engine no console do Google Cloud.

    Acessar o Google Kubernetes Engine

  2. Na lista de clusters, marque as caixas de seleção de um ou mais clusters que você quer modificar.

  3. Clique em Rótulos.

  4. Adicionar ou atualizar rótulos.

  5. Clique em Save.

API

Faça umaPOST solicitação para a classe resourceLabels método com o mais recenteimpressão digital e uma lista completa de etiquetas a serem aplicadas.

Da mesma forma que os metadados e as tags, se o cluster tiver rótulos que você quer manter, inclua esses rótulos na solicitação junto com os novos a serem adicionados.

Por exemplo, o snippet a seguir faz uma solicitação para o método resourceLabels:

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": {
  "environment": "production",
  "an-existing-tag": ""
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Remover identificadores de clusters

É possível remover identificadores de clusters usando a CLI gcloud, o console do Google Cloud ou a API GKE.

gcloud

Execute o comando update com a flag --remove-labels:

gcloud container clusters update CLUSTER_NAME \
    --remove-labels=KEYS

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • KEYS: uma lista de chaves separada por vírgulas para os identificadores que você quer remover.

Console

Para remover identificadores, faça o seguinte:

  1. Acesse a página do Google Kubernetes Engine no console do Google Cloud.

    Acessar o Google Kubernetes Engine

  2. Na lista de clusters, marque as caixas de seleção de um ou mais clusters que você quer modificar.

  3. Clique em Rótulos.

  4. Clique em Excluir item ao lado do campo Valor dos rótulos que você quer excluir.

  5. Clique em Save.

API

Faça uma solicitação POST ao método resourceLabels para o cluster apropriado. Forneça o labelsFingerprint atual e uma lista vazia de identificadores para que todos sejam removidos ou forneça uma lista dos identificadores que você quer manter (omitindo aqueles a serem removidos). Exemplo:

Request

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

A seguir

Leia a visão geral do GKE.