Como fazer upgrade de clusters do Anthos em bare metal

Como fazer upgrade de clusters do Anthos em bare metal

Quando você instala uma nova versão de bmctl, é possível fazer upgrade dos clusters atuais que foram criados com uma versão anterior. O upgrade de um cluster para a versão mais recente do Clusters do Anthos em bare metal disponibiliza recursos e correções no cluster. Isso também garante que o cluster permaneça compatível. É possível fazer upgrade de clusters de administrador, híbridos, autônomos ou de usuários com o comando bmctl upgrade cluster.

As verificações de simulação são executadas antes de um upgrade de cluster para validar o status dele e a integridade do nó.

Os exemplos a seguir mostram o processo de upgrade da versão inicial, 1.6.0, para os clusters do Anthos em bare metal 1.6.1.

É possível fazer upgrade da versão 1.6.1 para 1.6.2 da mesma maneira. Os upgrades (1.6.0 para 1.6.2) também são compatíveis.

Como fazer upgrade de clusters híbridos, autônomos ou de administrador nos clusters do Anthos em bare metal

Ao fazer o download e instalar uma nova versão do bmctl, é possível fazer o upgrade dos clusters administrativos, híbridos e autônomos criados com uma versão anterior. Para uma determinada versão de bmctl, os clusters podem ser atualizados apenas para a mesma versão.

Primeiro, faça o download do bmctl mais recente, modifique os arquivos de configuração de cluster apropriados e emita o comando bmctl upgrade cluster para concluir o upgrade.

  1. Faça o download do bmctl mais recente no bucket Cloud Storage: 
    gsutil cp gs://anthos-baremetal-release/bmctl/1.6.2/linux-amd64/bmctl bmctl
chmod a+x bmctl
  2. Modifique o arquivo YAML de configuração do cluster para alterar os clusters do Anthos em Bare Metal da versão 1.6.1 para 1.6.2. Veja a seguir um exemplo de uma configuração de cluster de administrador:
    3. ---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  # Cluster type. This can be:
  #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
  #   2) user:   to create a user cluster. Requires an existing admin cluster.
  #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
  #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
  type: admin
  # Anthos cluster version.
  # Change the following line from 1.6.0 to 1.6.1, shown below
  anthosBareMetalVersion: 1.6.1
  3. Use o comando bmctl upgrade cluster para concluir o upgrade, em que CLUSTER_NAME é o nome do cluster e ADMIN_KUBECONFIG especifica o caminho para o arquivo kubeconfig do cluster de administrador: 
    4. bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Como fazer upgrade de um cluster de usuário

Após fazer upgrade de um cluster de administrador, híbrido ou autônomo, é possível fazer upgrade do cluster de usuário que gerencia.

Primeiro, modifique o arquivo de configuração do cluster de usuário apropriado e emita o comando kubectl apply para aplicar o arquivo de configuração revisado e conclua o upgrade.

  1. Modifique o arquivo YAML de configuração do cluster de usuário para alterar os clusters do Anthos em Bare Metal da versão 1.6.0 para 1.6.1.
    2. ---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
spec:
  # Cluster type. This can be:
  #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
  #   2) user:   to create a user cluster. Requires an existing admin cluster.
  #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
  #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
  type: user
  # Anthos cluster version.
  # Change the following line from 1.6.0 to 1.6.1, shown below
  anthosBareMetalVersion: 1.6.1
  2. Emita o comando kubectl para aplicar a configuração do cluster de usuário revisado e criar o cluster:
    3.   kubectl --kubeconfig ADMIN_KUBECONFIG apply -f USER_CLUSTER_CONFIG
    ADMIN_KUBECONFIG especifica o caminho para o arquivo kubeconfig do cluster de administrador e USER_CLUSTER_CONFIG especifica o caminho para o arquivo YAML do cluster de usuário que você editou na seção anterior. Por exemplo, para um cluster de administrador chamado admin e uma configuração de cluster de usuário chamada user1, o comando seria: 
    kubectl --kubeconfig bmctl-workspace/admin/admin-kubeconfig apply /
  -f bmctl-workspace/user1/user1.yaml

Como verificar o upgrade do cluster de usuário

Para verificar a versão do cluster de usuário após um upgrade, use o comando kubectl get para retornar a versão.

Por exemplo, para verificar se a versão do cluster tornou-se 1.6.1 após fazer upgrade da versão 1.6.0, emita o seguinte comando:

kubectl get cluster.baremetal.cluster.gke.io -n cluster-USER_CLUSTER_NAME \
  -o jsonpath='{.status.anthosBareMetalVersion}' --kubeconfig ADMIN_KUBECONFIG

Em que:

  • ADMIN_KUBECONFIG especifica o caminho até o arquivo kubeconfig do cluster de administrador;
  • USER_CLUSTER_NAME é nome do cluster de usuário.

Se o upgrade tiver sido bem-sucedido, o comando retornará o número da versão atualizada. Esse processo pode levar até 30 minutos para ser concluído.