Fazer upgrade do modo privado do Anthos

Nesta página, explicamos como fazer upgrade do modo particular do Anthos.

Fazer upgrade do cluster de administrador e do Anthos Management Center

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

Prepare o ambiente

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.8/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.

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.

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.

No arquivo YAML de configuração do cluster, atualize a string da versão.

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
spec:
  anthosBareMetalVersion: VERSION

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

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.

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.

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

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

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

actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG

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.8, 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/.

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

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.8.X e a restrição de versão atual de <=1.8.X.

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

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
```
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.8.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.8.X para o 1.8.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

No console do centro de gerenciamento, acesse o menu Painel.
Clique na guia Upgrades para ver todos os upgrades disponíveis.
Clique em Ver upgrades no cluster que você quer fazer upgrade.
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.
Clique em Continuar para confirmar.
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.

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

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
spec:
  type: user
  anthosBareMetalVersion: VERSION

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