Fazer upgrade do Anthos em execução no modo desconectado

Nesta página, explicamos como fazer upgrade do Anthos em execução no modo desconectado.

Como fazer upgrade do cluster de administrador e do centro de gerenciamento do Anthos

Os operadores de infraestrutura podem fazer upgrade do cluster de administrador e do centro de gerenciamento e seus componentes.

Compatibilidade de versão

  • O Anthos em execução no modo desconectado agora segue uma política de descontinuação para versões do Anthos Config Management e Anthos Service Mesh. Cada versão é categorizada em um dos quatro estados:

    • Compatível: essa versão é reconhecida pelo Anthos em execução no modo desconectado e pode ser instalada. Ela funciona na versão atual do cluster do Anthos em execução no modo desconectado. As versões compatíveis provavelmente serão descontinuadas na próxima versão secundária do Anthos em execução no modo desconectado.
    • Descontinuada: essa versão é reconhecida pelo Anthos em execução no modo desconectado e pode ser instalada. Ela funciona na versão atual do cluster do Anthos em execução no modo desconectado. As versões descontinuadas serão incompatíveis na próxima versão secundária do Anthos em execução no modo desconectado.
    • Incompatível: essa versão ainda é reconhecida pela instalação do Anthos em execução no modo desconectado, mas não pode mais ser instalada. Talvez ela não funcione na versão atual do cluster do Anthos em execução no modo desconectado. Ainda é possível remover uma versão incompatível ou fazer upgrade para uma versão mais recente. As versões incompatíveis serão removidas na próxima versão secundária do Anthos em execução no modo desconectado.
    • Removida: essa versão não é reconhecida pela instalação do Anthos em execução no modo desconectado. Ela não pode fazer upgrade para uma versão mais recente e não pode ser desinstalada automaticamente.

    O ciclo de vida de cada versão do Anthos Config Management e do Anthos Service Mesh segue o padrão de migração de Compatível para Descontinuada para Incompatível para Removida.

    A tabela a seguir mostra a política de descontinuação das versões do Anthos Config Management e Anthos Service Mesh.

    Anthos em execução no modo desconectado 1.11 Compatível Suspenso Sem suporte Removida
    Anthos Config Management 1.11.1 N/A 1.8.*, 1.9.* 1.7.*
    Anthos Service Mesh 1.11.8-asm.1 1.10.* 1.9.* N/A

Prepare o ambiente

  1. Execute os seguintes comandos para fazer o download da nova versão e definir as permissões de execução:

    cd ~/
# Download the script which helps download all the latest components
export VERSION=UPGRADE_VERSION

# Please use official 'INSTALLER_DIGEST' value from https://cloud.google.com/anthos/private-mode/docs/1.9/installing/infrastructure#download
export INSTALLER_DIGEST=
export INSTALLER=get-anthos-private-mode-$VERSION.sh
gsutil cp gs://anthos-private-mode-release/$VERSION/$INSTALLER .
if [[ -n "$INSTALLER_DIGEST" ]]; then echo "$INSTALLER_DIGEST $INSTALLER" | sha256sum -c; fi && chmod +x $INSTALLER && ./$INSTALLER

# Note: ~/anthos-baremetal-private-mode should point to the new version.
ls -al anthos-baremetal-private-mode
cd ~/anthos-baremetal-private-mode

    Substitua UPGRADE_VERSION pela nova versão para a qual você quer fazer upgrade.

  2. Faça o upload das novas imagens no registro particular com o seguinte comando: Use o actl da versão UPGRADE_VERSION.

    actl images push --private-registry=${PRIVATE_REGISTRY} \
  --images ~/anthos-baremetal-private-mode

    O processo de upload ignora automaticamente as imagens que já existem no registro.

  3. Faça o upload de gráficos Helm para o Container Registry.

Fazer upgrade do cluster de administrador

Para fazer upgrade do cluster de administrador, atualize o arquivo de configuração do cluster de administrador com apenas as alterações a seguir e execute o comando actl clusters baremetal upgrade para concluir o upgrade.

  1. No arquivo YAML de administrador de configuração do cluster, atualize a string da versão e adicione a anotação baremetal.cluster.gke.io/private-mode: "true".

    apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  anthosBareMetalVersion: VERSION

    Substitua VERSION pelo novo número de versão do Anthos no Bare Metal.

  2. Execute o comando a seguir para criar o cluster de administrador. Use o actl da versão UPGRADE_VERSION.

    actl clusters baremetal upgrade admin --kubeconfig=ADMIN_KUBECONFIG

O upgrade pode levar de 15 a 20 minutos para ser concluído, mas pode demorar mais, dependendo do tamanho do cluster.

Centro de gerenciamento de upgrade

Os operadores de infraestrutura podem fazer upgrade do Centro de gerenciamento por completo ou fazer upgrade de subcomponentes individuais.

Opção 1: fazer upgrade de todo o Centro de gerenciamento

Os operadores de infraestrutura podem fazer upgrade de todos os componentes no Centro de gerenciamento, incluindo o próprio Centro de gerenciamento.

  1. Verifique a versão do centro de gerenciamento para confirmar se ela é uma versão mais antiga:

    kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG

    Substitua ADMIN_KUBECONFIG pelo caminho do arquivo kubeconfig do cluster de administrador.

  2. Opcional: faça a verificação de simulação para o upgrade:

    actl platform management-center upgrade --preflight-check-only --kubeconfig=ADMIN_KUBECONFIG

  3. Inicie o upgrade (geralmente leva de 10 a 15 minutos para ser concluída):

    actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG

  4. Verifique a versão do centro de gerenciamento para confirmar que a versão foi atualizada:

    kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG

Opção 2: fazer upgrade de componentes individuais

Os operadores de infraestrutura podem gerenciar os upgrades de um componente específico que é executado no centro de gerenciamento. A partir da versão 1.9, três componentes podem ser atualizados individualmente: o operador do Anthos Config Management, o operador do Anthos Service Mesh e o Anthos em Bare Metal.

Depois de fazer upload das imagens no Container Registry, publique as especificações de pacote enviadas na nova versão. Por exemplo, a especificação de pacote do operador do Anthos Config Management e do operador do Anthos Service Mesh estão disponíveis em services/.

  1. Aplique a especificação do pacote no novo operador do Anthos Config Management.

    kubectl apply -f ~/anthos-baremetal-private-mode/services/anthos-config-management/package-spec.yaml \
--kubeconfig=ADMIN_KUBECONFIG

  2. Verifique o status atual do componente do operador do Anthos Config Management.

    kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")]}'

    Suponha que o comando forneça a versão atual de 1.9.X e a restrição de versão atual de <=1.9.X.

    {"name":"anthos-config-management","version":"1.9.X","versionConstraint":"<=1.9.X"}

  3. Ative a nova versão editando as restrições de versão no objeto "Administrador do operador".

    kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG

  4. No editor, localize as políticas de atualização em spec.updateConfigOverride.policies e aumente as versões dos componentes adequadamente. Se spec.updateConfigOverride for omitido ou tiver um valor de struct vazio ({}), adicione a política da seguinte maneira.

    spec:
  updateConfigOverride:
    policies:
    - name: anthos-config-management
      versionConstraint: <=1.9.Y

Depois de adicionar a modificação, o centro de gerenciamento implementa a alteração para escolher a versão mais recente do operador do Anthos Config Management.

Execute o comando a seguir para monitorar o lançamento da nova versão, que será alterada do antigo 1.9.X para o 1.9.Y.

kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")].version}' \
  --watch

Quando a implantação for concluída, os administradores da plataforma poderão usar o novo operador do Anthos Config Management pelo centro de gerenciamento.

Fazer upgrade de clusters de usuários

Os administradores da plataforma podem atualizar os clusters de usuário usando a ferramenta de linha de comando actl, o centro de gerenciamento ou a API.

actl

Execute o seguinte comando para atualizar um cluster de usuário:

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Console

  1. No console do centro de gerenciamento, acesse o menu Painel.
  2. Clique na guia Upgrades para ver todos os upgrades disponíveis.
  3. Clique em Ver upgrades no cluster que você quer fazer upgrade.
  4. Clique em Fazer upgrade para ver os detalhes do upgrade, como a versão, a descrição e um link para as notas da versão.
  5. Clique em Continuar para confirmar.
  6. Clique em Fazer upgrade para iniciar o upgrade do cluster.

A entrada na lista de upgrades mostra Upgrade in progress até que o upgrade seja concluído.

API

É possível fazer upgrade de um cluster de usuário modificando a string de versão no recurso Cluster.

  1. Execute o comando a seguir para editar o recurso Cluster de um cluster de usuário.

    kubectl edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG

  2. Atualize a string da versão em spec.anthosBareMetalVersion, e os controladores funcionarão nos upgrades.

    apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: CLUSTER_NAME
  namespace: cluster-CLUSTER_NAME
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  type: user
  anthosBareMetalVersion: VERSION

    Substitua VERSION pelo novo número de versão do Anthos no Bare Metal.

A seguir