Como especificar uma imagem de nó

Nesta página, mostramos como especificar uma imagem para seus nós no 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ó.

Antes de começar

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

Defina as configurações padrão da gcloud usando um dos métodos a seguir:

  • Use gcloud init se quiser orientações para definir os padrões.
  • Use gcloud config para definir individualmente a região, a zona e o ID do projeto.

Como usar o gcloud init

Se você receber o erro One of [--zone, --region] must be supplied: Please specify location, conclua esta seção.

  1. Execute gcloud init e siga as instruções:

    gcloud init

    Se você estiver usando SSH em um servidor remoto, utilize a sinalização --console-only para impedir que o comando inicie um navegador:

    gcloud init --console-only
  2. Siga as instruções para autorizar a gcloud a usar sua conta do Google Cloud.
  3. Crie uma nova configuração ou selecione uma atual.
  4. Escolha um projeto do Google Cloud.
  5. Escolha uma zona padrão do Compute Engine.

Como usar o gcloud config

  • Defina o ID do projeto padrão:
    gcloud config set project project-id
  • Se você estiver trabalhando com clusters zonais, defina a zona do Compute padrão:
    gcloud config set compute/zone compute-zone
  • Se você estiver trabalhando com clusters regionais, defina a região do Compute padrão:
    gcloud config set compute/region compute-region
  • Atualize gcloud para a versão mais recente:
    gcloud components update

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_NAME

Substitua:

  • CLUSTER_NAME: o nome escolhido para o cluster.
  • IMAGE_NAME: o nome do tipo de imagem do nó, que pode ser um dos seguintes valores:
    • cos_containerd: Container-Optimized OS com o Containerd
    • cos: Container-Optimized OS com o Docker
    • ubuntu_containerd: Ubuntu com o Containerd
    • ubuntu: Ubuntu com o Docker
    • windows_ltsc: Windows Server LTSC
    • windows_sac: Windows Server SAC

Console

  1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

    Acesse o menu do Google Kubernetes Engine

  2. Clique no botão Criar cluster.

  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.

Como fazer upgrade de um cluster existente

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_NAME \
    [--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ó, que pode ser um dos seguintes valores:
    • cos_containerd: Container-Optimized OS com o Containerd
    • cos: Container-Optimized OS com o Docker
    • ubuntu_containerd: Ubuntu com o Containerd
    • ubuntu: Ubuntu com o Docker
    • windows_ltsc: Windows Server LTSC
    • windows_sac: Windows Server SAC

Console

  1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

    Acesse o menu do Google Kubernetes Engine

  2. Clique em Ações e, depois, em Editar.

  3. Na seção Pool de nós, selecione o pool de nós que quiser.

  4. Na página Detalhes dos pools de nós, clique em Editar.

  5. Na seção Tipo de imagem, clique em Alterar.

  6. Selecione a imagem de nó pretendida.

  7. Clique em Alterar.

  8. Aguarde o upgrade dos nós.

A seguir