Especificar uma imagem de nó

Nesta página, mostramos como especificar uma imagem para nós em clusters do modo padrão do Google Kubernetes Engine (GKE). Para saber como as imagens de nós funcionam e os tipos de imagens de nó disponíveis, consulte Imagens de nó.

Os nós nos clusters do GKE Autopilot sempre usam a imagem do nó Container-Optimized OS com containerd (cos_containerd).

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. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando gcloud components update.

Como especificar uma imagem de nó

É possível selecionar a imagem do nó que quer usar ao criar um novo cluster ou alterar a imagem do nó para um cluster existente.

Como criar um novo cluster

gcloud

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

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Substitua:

Console

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

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

  3. Configure o cluster como quiser.

  4. No painel de navegação, em Pools de nós, clique em Nós.

  5. Na lista suspensa Tipo de imagem, selecione a imagem de nó pretendida.

  6. Clique em Criar.

Terraform

Para criar um novo cluster com uma imagem de nó específica usando o Terraform, consulte o exemplo a seguir:

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

  node_config {
    image_type = "cos_containerd"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Para saber mais como usar o Terraform, consulte o Suporte do Terraform para GKE.

Como fazer upgrade de um cluster existente

O GKE usa a configuração e a estratégia de upgrade de nós selecionadas para fazer upgrade da imagem de um nó. Para saber mais sobre como escolher a estratégia e a configuração ideais de upgrade de nós para seu ambiente, consulte Estratégias de upgrade de nós.

gcloud

É possível fazer upgrade de um cluster atual para usar uma imagem de nó específica usando o comando gcloud container clusters upgrade. É possível fazer upgrade de todos os pools de nós do cluster ou definir um pool de nós específico usando --node-pool.

Para fazer upgrade de um cluster atual para usar uma imagem de nó específica, execute o comando a seguir:

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

Substitua:

  • CLUSTER_NAME: o nome do cluster atual.
  • POOL_NAME: o nome do pool de nós que você quer atualizar.
  • IMAGE_NAME: o nome do tipo de imagem do nó.

Console

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

    Acessar o Google Kubernetes Engine

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

  3. Clique na guia Nós.

  4. Em Pools de nós, clique no nome do pool que você quer fazer o upgrade.

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

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

  7. Selecione a versão do nó desejada e clique em Alterar para iniciar o upgrade.

A seguir