Especifique uma imagem do nó

Padrão

Esta página mostra-lhe como especificar uma imagem de nó para nós em clusters do modo Standard do Google Kubernetes Engine (GKE). Para saber como funcionam as imagens de nós e os tipos de imagens de nós disponíveis, consulte o artigo Imagens de nós.

Os nós nos clusters do GKE Autopilot usam sempre a imagem do nó do SO otimizado para contentores com o containerd (cos_containerd). Não pode especificar uma imagem de nó diferente no modo Autopilot.

Antes de começar

Antes de começar, certifique-se de que realizou as seguintes tarefas:

• Ative a API Google Kubernetes Engine.
Ative a API Google Kubernetes Engine
• Se quiser usar a CLI gcloud para esta tarefa, instale-a e, em seguida, inicialize-a. Se instalou anteriormente a CLI gcloud, execute gcloud components update para obter a versão mais recente.
  Nota: para instalações existentes da CLI gcloud, certifique-se de que define a compute/region propriedade. Se usar principalmente clusters zonais, defina o compute/zone. Ao definir uma localização predefinida, pode evitar erros na CLI gcloud, como os seguintes: One of [--zone, --region] must be supplied: Please specify location. Pode ter de especificar a localização em determinados comandos se a localização do seu cluster for diferente da predefinição que definiu.

Especificar uma imagem do nó

Pode selecionar a imagem do nó que quer usar quando cria um novo cluster ou pode alterar a imagem do nó para um cluster existente.

Nota: a partir da versão 1.19 do nó do GKE, a imagem do nó predefinida para nós Linux é a variante do SO otimizado para contentores com o Containerd (cos_containerd) em vez da variante do SO otimizado para contentores com o Docker (cos).

Aviso: na versão 1.24 e posteriores do GKE, os tipos de imagens de nós baseados no Docker não são suportados. Na versão 1.23 do GKE, também não pode criar novos pools de nós com tipos de imagens de nós do Docker. Tem de migrar para um tipo de imagem de nó do containerd. Para saber mais sobre esta alteração, consulte o artigo Acerca da descontinuação da imagem do nó do Docker.

Criar um novo cluster

gcloud

Para criar um novo cluster com uma imagem de nó específica, execute o seguinte comando:

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Substitua o seguinte:

• CLUSTER_NAME: o nome que escolher para o cluster.
• IMAGE_TYPE: o nome do seu tipo de imagem de nó.

Consola

1. Na Google Cloud consola, aceda à página Criar um cluster do Kubernetes.

   Aceda a Crie um cluster do Kubernetes

2. Configure o cluster conforme pretendido.

3. No painel de navegação, em Node Pools, clique em Nodes.

4. Na lista pendente Tipo de imagem, selecione a imagem do nó pretendida.

5. Clique em Criar.

Terraform

Para criar um novo cluster com uma imagem de nó específica através do Terraform, consulte o seguinte exemplo:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-node-image"
  initial_node_count = 2

  node_config {
    image_type = "cos_containerd"
  }
}

Para saber mais sobre a utilização do Terraform, consulte o artigo Compatibilidade do Terraform com o GKE.

Atualizar um cluster existente

Aviso: na versão 1.24 e posteriores do GKE, os tipos de imagens de nós baseados no Docker não são suportados. Na versão 1.23 do GKE, também não pode criar novos pools de nós com tipos de imagens de nós do Docker. Tem de migrar para um tipo de imagem de nó do containerd. Para saber mais sobre esta alteração, consulte o artigo Acerca da descontinuação da imagem do nó do Docker.

Esta alteração requer a recriação dos nós, o que pode causar interrupções nas cargas de trabalho em execução. Para ver detalhes sobre esta alteração específica, procure a linha correspondente na tabela alterações manuais que recriam os nós através de uma estratégia de atualização de nós sem respeitar as políticas de manutenção. Para saber mais sobre as atualizações de nós, consulte o artigo Planeamento de interrupções de atualizações de nós.

Atenção: o GKE começa imediatamente a recriar os nós para esta alteração através da estratégia de atualização de nós, independentemente das políticas de manutenção ativas. O GKE depende da disponibilidade de recursos para a alteração. A desativação das atualizações automáticas de nós não impede esta alteração. Certifique-se de que as cargas de trabalho em execução nos nós estão preparadas para a interrupção antes de iniciar esta alteração.

gcloud

Pode atualizar um cluster existente para usar uma imagem de nó específica com o comando gcloud container clusters upgrade. Pode atualizar todos os node pools no cluster ou especificar um node pool específico através de --node-pool.

Para atualizar um cluster existente para usar uma imagem de nó específica, execute o seguinte comando:

gcloud container clusters upgrade CLUSTER_NAME --image-type IMAGE_TYPE \
    [--node-pool POOL_NAME]

Substitua o seguinte:

• CLUSTER_NAME: o nome do cluster existente.
• POOL_NAME: o nome do node pool que quer atualizar.
• IMAGE_TYPE: o nome do seu tipo de imagem de nó.

Consola

1. Aceda à página do Google Kubernetes Engine na Google Cloud consola.

   Aceda ao Google Kubernetes Engine

2. Na lista de clusters, clique no nome do cluster que quer modificar.

3. Clique no separador Nós.

4. Em Conjuntos de nós, clique no nome do conjunto de nós que quer atualizar.

5. Na página Detalhes do conjunto de nós, clique em Editar.

6. Em Versão do nó, clique em Alterar.

7. Selecione a versão do nó pretendida e clique em Alterar para iniciar a atualização.

O que se segue?

• Saiba mais sobre as imagens de nós.
• Saiba mais sobre os conjuntos de nós.