Fazer upgrade de um cluster de administrador ou de usuário usando clientes da API Anthos On-Prem

Nesta página, explicamos como usar o console do Google Cloud ou a Google Cloud CLI para fazer upgrade de um cluster de administrador ou de usuário gerenciado pela API Anthos On-Prem. Para conferir requisitos de upgrade, práticas recomendadas e outras informações sobre o processo, consulte Práticas recomendadas para upgrade antes de continuar.

O que é a API Anthos On-Prem?

A API Anthos On-Prem é uma API hospedada no Google Cloud que permite gerenciar o ciclo de vida dos clusters de usuário locais usando aplicativos padrão do Google Cloud. A API Anthos On-Prem é executada na infraestrutura do Google Cloud. O console do Google Cloud e a CLI gcloud são clientes da API e usam a API para criar, atualizar, atualizar e excluir clusters no data center. Se você criou o cluster usando bmctl, é possível configurar o cluster para ser gerenciado pela API Anthos On-Prem, que permite usar os clientes padrão.

Antes de começar

Instalar ferramentas de linha de comando

Se você quiser usar a CLI gcloud para fazer upgrade do cluster ou se quiser usar o gateway do Connect para executar comandos kubectl no seu computador local (em vez da estação de trabalho do administrador), instale as seguintes ferramentas de linha de comando:

  • A versão mais recente da CLI gcloud.
  • kubectl para executar comandos em clusters do Kubernetes. Se precisar instalar kubectl, siga estas instruções

Requisitos do IAM

Se você não for um proprietário do projeto, precisará receber o papel de gerenciamento de identidade e acesso roles/gkeonprem.admin no projeto do Google Cloud em que o cluster de usuário foi criado. Para ver detalhes sobre as permissões incluídas nesse papel, consulte Papéis do GKE On-Prem na documentação do IAM.

Para usar o console para fazer upgrade do cluster, você precisa, no mínimo, do seguinte:

  • roles/container.viewer Com esse papel, os usuários podem ver a página de clusters do GKE e outros recursos do contêiner no console. Para ver detalhes sobre as permissões incluídas nesse papel ou conceder um papel com permissões de leitura/gravação, consulte Papéis do Kubernetes Engine na documentação do IAM.

  • roles/gkehub.viewer Esse papel permite que os usuários vejam clusters no console. Para ver detalhes sobre as permissões incluídas nesse papel ou conceder um papel com permissões de leitura/gravação, consulte Papéis do GKE Hub na documentação do IAM.

Requisitos de versão

É possível fazer upgrade diretamente para qualquer versão que esteja na mesma versão secundária ou na próxima versão secundária. Por exemplo, é possível fazer upgrade da versão 1.13.1 para 1.13.2 ou de 1.12.1 para 1.13.1. Não é permitido fazer upgrade para uma versão mais recente do que a versão secundária mais recente.

Um cluster de administrador pode gerenciar clusters de usuário que estão em uma versão secundária igual ou anterior. Os clusters de usuário gerenciados não podem ser mais de uma versão secundária inferior ao cluster de administrador.

Observe as seguintes limitações:

  • Somente os clusters de usuário 1.13.1 ou posterior podem ser atualizados usando o console ou a CLI gcloud. Se o cluster de usuário estiver na versão 1.13.0 ou anterior, faça upgrade do cluster usando bmctl.

  • É preciso fazer upgrade de um cluster de administrador antes de fazer upgrade de clusters de usuário associados. No entanto, antes de fazer upgrade do cluster de administrador para a versão 1.13.7, verifique se os clusters de usuário associados estão na versão 1.12.0 ou mais recente.

Fazer upgrade de um cluster de administrador

Verifique se o cluster de administrador está inscrito na API Anthos On-Prem. Para mais informações, consulte Configurar um cluster a ser gerenciado pela API Anthos On-Prem.

Console

  1. No console, acesse a página de clusters do Anthos.

    Acesse a página de clusters do Anthos

  2. Selecione o projeto do Cloud e, em seguida, o cluster que você quer atualizar.

  3. No painel Detalhes, clique em Mais detalhes.

  4. Na seção Princípios básicos do cluster, clique em Fazer upgrade.

  5. Na lista Escolher versão de destino, selecione para qual versão quer fazer upgrade. Recomendamos que você faça upgrade para a versão mais recente do patch.

  6. Clique em Fazer upgrade.

Antes do upgrade do cluster, as verificações de simulação são executadas para validar o status do cluster e a integridade do nó. Se as verificações de simulação forem aprovadas, o cluster de administradores será atualizado. O upgrade leva 30 minutos ou mais para ser concluído, dependendo do tamanho do cluster.

Para ver o status do upgrade, clique em Mostrar detalhes na guia Detalhes do cluster.

CLI da gcloud

  1. Execute este comando para fazer login com sua Conta do Google:

    gcloud auth login

  2. Atualize os componentes da CLI do Google Cloud:

    gcloud components update

  3. Veja uma lista das versões disponíveis para upgrade:

    gcloud beta container bare-metal admin-clusters query-version-config \
--cluster=ADMIN_CLUSTER_NAME \
--project=FLEET_HOST_PROJECT_ID \
--location=REGION

    Substitua:

    • ADMIN_CLUSTER_NAME: o nome do cluster de administrador.

    • FLEET_HOST_PROJECT_ID: o ID do projeto da frota em que o cluster de administrador é membro. Esse é o ID do projeto que você especificou no campo gkeConnect.projectID no arquivo de configuração do cluster quando criou o cluster.

    • REGION: a região do Google Cloud em que a API Anthos On-Prem é executada e armazena os metadados. Essa é a região selecionada quando você registrou o cluster para gerenciamento com a API Anthos On-Prem.

  4. Fazer upgrade de um cluster

    gcloud beta container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --version=VERSION

    Substitua:

    • ADMIN_CLUSTER_NAME: o nome do cluster de administrador que será atualizado.

    • FLEET_HOST_PROJECT_ID: o ID do projeto da frota em que o cluster de administrador é membro. Esse é o ID do projeto que você especificou no campo gkeConnect.projectID no arquivo de configuração do cluster quando criou o cluster.

    • REGION: a região do Google Cloud em que a API Anthos On-Prem é executada e armazena os metadados. Essa é a região selecionada quando você registrou o cluster para gerenciamento com a API Anthos On-Prem.

    • VERSION: a versão dos clusters do Anthos em bare metal para a qual você quer fazer upgrade. Especifique uma versão na saída do comando anterior. Recomendamos que você faça upgrade para a versão mais recente do patch.

    O upgrade leva 30 minutos ou mais para ser concluído, dependendo do tamanho do cluster.

  5. Durante o upgrade do cluster, execute o seguinte comando em outra janela de terminal para verificar o status dele:

    gcloud beta container bare-metal admin-clusters describe ADMIN_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION

Para mais informações sobre os campos e flags, consulte a referência do gcloud beta container bare-metal admin-clusters.

Fazer upgrade de um cluster de usuários

Console

  1. No console, acesse a página de clusters do Anthos.

    Acesse a página de clusters do Anthos

  2. Selecione o projeto do Cloud e, em seguida, o cluster que você quer atualizar.

  3. No painel Detalhes, clique em Mais detalhes.

  4. Na seção Princípios básicos do cluster, clique em Fazer upgrade.

  5. Na lista Escolher versão de destino, selecione para qual versão quer fazer upgrade. Recomendamos que você faça upgrade para a versão mais recente do patch.

  6. Clique em Fazer upgrade.

Antes do upgrade do cluster, as verificações de simulação são executadas para validar o status do cluster e a integridade do nó. Se as verificações de simulação forem aprovadas, o cluster de usuário será atualizado. O upgrade leva 30 minutos ou mais para ser concluído, dependendo do tamanho do cluster.

Para ver o status do upgrade, clique em Mostrar detalhes na guia Detalhes do cluster.

CLI da gcloud

  1. Execute este comando para fazer login com sua Conta do Google:

    gcloud auth login

  2. Atualize os componentes da CLI do Google Cloud:

    gcloud components update

  3. Veja uma lista das versões disponíveis para upgrade:

    gcloud beta container bare-metal clusters query-version-config \
--cluster=USER_CLUSTER_NAME \
--project=FLEET_HOST_PROJECT_ID \
--location=REGION

    Substitua:

    • USER_CLUSTER_NAME: o nome do cluster de usuário que será atualizado.

    • FLEET_HOST_PROJECT_ID: o ID do projeto da frota em que o cluster de usuário é membro. Esse é o projeto especificado quando o cluster foi criado. Se você criou o cluster usando bmctl, esse é o ID do projeto no campo gkeConnect.projectID no arquivo de configuração do cluster.

    • REGION: a região do Google Cloud em que a API Anthos On-Prem é executada e armazena os metadados. Se você criou o cluster usando um cliente da API Anthos On-Prem, essa é a região especificada ao criar o cluster. Se você criou o cluster usando bmctl, essa é a região especificada quando você registrou o cluster para gerenciamento com a API Anthos On-Prem.

  4. Fazer upgrade de um cluster

    gcloud beta container bare-metal clusters update USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --version=VERSION

    Substitua:

    • USER_CLUSTER_NAME: o nome do cluster de usuário que será atualizado.

    • FLEET_HOST_PROJECT_ID: o ID do projeto da frota em que o cluster de usuário é membro. Esse é o projeto especificado quando o cluster foi criado. Se você criou o cluster usando bmctl, esse é o ID do projeto no campo gkeConnect.projectID no arquivo de configuração do cluster.

    • REGION: a região do Google Cloud em que a API Anthos On-Prem é executada e armazena os metadados. Se você criou o cluster usando um cliente da API Anthos On-Prem, essa é a região especificada ao criar o cluster. Se você criou o cluster usando bmctl, essa é a região especificada quando você registrou o cluster para gerenciamento com a API Anthos On-Prem.

    • VERSION: a versão dos clusters do Anthos em bare metal para a qual você quer fazer upgrade. Especifique uma versão na saída do comando anterior. Recomendamos que você faça upgrade para a versão mais recente do patch.

    O upgrade leva 30 minutos ou mais para ser concluído, dependendo do tamanho do cluster.

  5. Durante o upgrade do cluster, execute o seguinte comando em outra janela de terminal para verificar o status dele:

    gcloud beta container bare-metal clusters describe USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION

Para mais informações sobre os campos e sinalizações, consulte a referência do gcloud beta container bare-metal clusters.