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ó funcionam, 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

O Container-Optimized OS é a opção padrão para uma imagem de nó do cluster. É possível especificar a outra imagem de nó incluindo a opção --image-type ao usar o comando gcloud container clusters create.

Para criar um novo cluster com o Container-Optimized OS como a imagem de nó:

gcloud container clusters create cluster-name

cluster-name é o nome que você escolhe para o cluster.

Para criar um novo cluster com uma imagem de nó específica:

gcloud container clusters create cluster-name --image-type image-name

Em que:

Console

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

    Acessar 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 existente para usar as imagens de nó do SO otimizado para contêineres ou do Ubuntu usando o comando gcloud container clusters upgrade. É possível fazer upgrade de todos os pools de nós do cluster ou especificar um pool de nós específico usando --node-pool.

Para fazer upgrade de um cluster existente e usar a imagem de nó do SO otimizado para contêineres:

gcloud container clusters upgrade --image-type cos cluster-name \
    [--node-pool pool-name]

Para fazer upgrade de um cluster existente para que use a imagem de nó do Ubuntu:

gcloud container clusters upgrade --image-type ubuntu cluster-name \
    [--node-pool pool-name]

Console

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

    Acessar o menu do Google Kubernetes Engine

  2. Clique no botão Editar do cluster, que se parece com um lápis.

  3. Em Pools de nós, selecione o pool de nós que quiser. A página Detalhes dos pools de nós é aberta.

  4. Nessa página, 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