Como fazer upgrade do modo particular do Anthos

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

Como fazer upgrade do cluster de administrador e da Central de gerenciamento

Os operadores de infraestrutura podem fazer upgrade do cluster de administrador e do centro de gerenciamento do Athos e 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:

export VERSION=UPGRADE_VERSION
cd ~/
gsutil cp gs://anthos-private-mode-release/${VERSION}/get-anthos-private-mode.sh .
chmod +x get-anthos-private-mode.sh
./get-anthos-private-mode.sh

# 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.

Como fazer upgrade do cluster de administrador

Importante: o modo privado do Anthos só é compatível com o uso de containerd como o ambiente de execução do cluster. Não faça upgrade para a versão 0.9 se o cluster de administrador usar o ambiente de execução Docker. O upgrade pode interromper o 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 abaixo e execute o comando actl clusters baremetal upgrade para concluir o upgrade.

Importante: ao fazer upgrade de versões 0.8, a configuração do registro particular precisa permanecer inalterada. Não atualize privateRegistry e não adicione registryMirrors. Alterar a configuração do registro privado durante um upgrade pode interromper o cluster de administrador. Somente os novos clusters de administrador criados com a versão 0.9 são compatíveis com o espelhamento de registros.

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.

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.

Como fazer upgrade do centro de gerenciamento

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

Opção 1: como fazer upgrade de todo o centro de gerenciamento

Os operadores de infraestrutura podem fazer upgrade de todos os componentes em um centro de gerenciamento, incluindo o próprio centro.

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: como 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 0.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/.

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

{"name":"anthos-config-management","version":"0.9.X","versionConstraint":"<=0.9.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: <=0.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 0.9.X para o 0.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.

Como fazer upgrade de clusters de usuário

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