Actualizar clústeres de Anthos alojados en equipos físicos

Actualizar clústeres de Anthos alojados en equipos físicos

Cuando instalas una versión nueva de bmctl, puedes actualizar los clústeres existentes que se crearon con una versión anterior. La actualización de un clúster a la versión más reciente de clústeres de Anthos en equipos físicos agrega funciones y correcciones a tu clúster. También garantiza que tu clúster siga siendo compatible. Puedes actualizar clústeres de administrador, híbridos, independientes o de usuarios con el comando bmctl upgrade cluster.

Las verificaciones preliminares se ejecutan antes de la actualización del clúster a fin de validar el estado del clúster y el estado del nodo.

En los siguientes ejemplos, se muestra el proceso de actualización de la versión inicial, 1.6.0, a clústeres de Anthos en equipos físicos 1.6.1.

Puede actualizar el tipo de versión 1.6.1 a 1.6.2 de la misma manera. También se admiten actualizaciones (omitir de 1.6.0 a 1.6.2).

Actualiza clústeres de Anthos, independientes o híbridos en equipos físicos

Cuando descargas e instalas una versión nueva de bmctl, puedes actualizar los clústeres independientes, híbridos y de administrador que se crearon con una versión anterior. Para una versión determinada de bmctl, los clústeres se pueden actualizar solo a la misma versión.

Primero, descarga el bmctl más reciente, luego modifica los archivos de configuración del clúster apropiados y, luego, emite el comando bmctl upgrade cluster para completar la actualización.

  1. Descarga la versión más reciente de bmctl del depósito Cloud Storage:
    gsutil cp gs://anthos-baremetal-release/bmctl/1.6.2/linux-amd64/bmctl bmctl
    chmod a+x bmctl
    
  2. Modifica el archivo YAML de configuración de clúster para cambiar la versión del clúster de los clústeres de Anthos en equipos físicos de 1.6.1 a 1.6.2 A continuación, se muestra un ejemplo de una configuración de clúster 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
  4. Usa el comando bmctl upgrade cluster para completar la actualización, en el que CLUSTER_NAME es el nombre de tu clúster y ADMIN_KUBECONFIG especifica la ruta al archivo kubeconfig del clúster administrador:
  5. bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG
    

Actualiza un clúster de usuario

Una vez que hayas actualizado con éxito un clúster independiente, híbrido o de administrador, puedes actualizar el clúster de usuarios que administra.

Primero, modifica el archivo de configuración de clúster de usuario adecuado y, luego, ejecuta el comando kubectl apply para aplicar el archivo de configuración revisado y completar la actualización.

  1. Modifica el archivo YAML de configuración de clúster del usuario para cambiar la versión del clúster de los clústeres de Anthos en equipos físicos de 1.6.0 a 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
  3. Ejecuta el comando kubectl para aplicar la configuración revisada del clúster de usuario y crear el clúster:
  4.   kubectl --kubeconfig ADMIN_KUBECONFIG apply -f USER_CLUSTER_CONFIG
      
    ADMIN_KUBECONFIG especifica la ruta al archivo kubeconfig del clúster de administrador y USER_CLUSTER_CONFIG especifica la ruta al archivo YAML del clúster de usuario que editaste en la sección anterior. Por ejemplo, para un clúster de administración llamado admin y una configuración de clúster de usuario llamada user1, el comando sería el siguiente:
    kubectl --kubeconfig bmctl-workspace/admin/admin-kubeconfig apply /
      -f bmctl-workspace/user1/user1.yaml
    

Verifica la actualización del clúster de usuario

Para verificar la versión del clúster de usuario después de una actualización, usa el comando kubectl get para mostrar la versión.

Por ejemplo, para verificar que la versión del clúster sea 1.6.1 después de actualizar desde 1.6.0, ejecuta el siguiente comando:

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

Donde:

  • ADMIN_KUBECONFIG especifica la ruta al archivo kubeconfig del clúster de administrador.
  • USER_CLUSTER_NAME es el nombre del clúster de usuario.

Si la actualización se realizó de forma correcta, el comando mostrará el número de versión actualizado. Ten en cuenta que una actualización puede tardar hasta 30 minutos en completarse.