Actualiza la ejecución de Anthos en modo desconectado

En esta página, se explica cómo actualizar la ejecución de Anthos en modo desconectado.

Actualiza el clúster de administrador y el centro de administración de Anthos

Los operadores de infraestructura pueden actualizar el clúster de administrador y el centro de administración y sus componentes.

Compatibilidad de la versión

La ejecución de Anthos en modo desconectado sigue una política de baja para las versiones de Anthos Config Management y Anthos Service Mesh. Cada versión se clasifica en uno de los cuatro estados siguientes:

Compatible: Esta versión se reconoce en Anthos que se ejecuta en modo desconectado y se puede instalar. Funciona en la versión actual del clúster de Anthos que se ejecuta en modo desconectado. Las versiones compatibles probablemente quedarán obsoletas en la próxima versión secundaria de Anthos que se ejecuta en modo desconectado.
Obsoleta: Esta versión se reconoce en Anthos que se ejecuta en modo desconectado y se puede instalar. Funciona en la versión actual del clúster de Anthos que se ejecuta en modo desconectado. Las versiones obsoletas no serán compatibles en la próxima versión secundaria de Anthos que se ejecuta en modo desconectado.
No compatible: Esta versión sigue siendo reconocida por Anthos que se ejecuta en la instalación en modo desconectado, pero ya no se puede instalar. Es posible que no funcione en la versión actual de Anthos que se ejecuta en la versión del clúster de modo desconectado. Aún es posible quitar una versión no compatible o actualizarla a una versión más reciente. Se quitarán las versiones no compatibles en la próxima versión secundaria de Anthos que se ejecute en modo de desconexión.
Quitada: Esta versión no es reconocida por Anthos que se ejecuta en la instalación en modo desconectado. No se puede actualizar a una versión más reciente y no se puede desinstalar automáticamente.

El ciclo de vida de cada versión de Anthos Config Management y Anthos Service Mesh sigue el patrón de pasar de Compatible a Obsoleta a No compatible a Eliminada.

En la siguiente tabla, se muestra la política de baja de las versiones de Anthos Config Management y Anthos Service Mesh.

La ejecución de Anthos en modo desconectado 1.12	Admitido	Funciones obsoletas	No compatible	Eliminado
Anthos Config Management	1.12.0	1.11.1	1.10.*	1.8.,1.9.
Anthos Service Mesh	1.12.7-asm.2	1.11.*	1.10.*	1.9.*

Prepare el entorno

Ejecuta los siguientes comandos para descargar la versión nueva y configurar los permisos de ejecución:

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

Reemplaza UPGRADE_VERSION por la versión nueva a la que deseas actualizar.

Sube las imágenes nuevas a tu registro privado con el siguiente comando. Asegúrate de usar el actl de la versión UPGRADE_VERSION.
```
actl images push --private-registry=${PRIVATE_REGISTRY} \
  --images ~/anthos-baremetal-private-mode
```
El proceso de carga omite de forma automática las imágenes que ya existen en el registro.
Sube gráficos de Helm a Container Registry

Actualiza el clúster de administrador

Para actualizar el clúster de administrador, actualiza el archivo de configuración del clúster de administrador solo con los siguientes cambios y, luego, ejecuta el comando actl clusters baremetal upgrade a fin de completar la actualización.

En el archivo YAML del administrador de configuración del clúster, actualiza la string de versión y agrega la anotación 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
```
Reemplaza VERSION por el número de la nueva versión de Anthos en equipos físicos.
Ejecuta el siguiente comando para actualizar el clúster de administrador. Asegúrate de usar el actl de la versión UPGRADE_VERSION.
```
actl clusters baremetal upgrade admin --kubeconfig=ADMIN_KUBECONFIG
```

La actualización puede tardar entre 15 y 20 minutos en completarse, pero puede tomar más tiempo según el tamaño del clúster.

Centro de administración de actualizaciones

Los operadores de infraestructura pueden actualizar el Centro de administración en su totalidad o actualizar los subcomponentes individuales.

Opción 1: Actualiza todo el Centro de administración

Los operadores de infraestructura pueden actualizar todos los componentes del centro de administración, incluido el propio centro de administración.

Verifica la versión del centro de administración para confirmar que sea una versión anterior:
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
Reemplaza ADMIN_KUBECONFIG por la ruta de acceso del archivo kubeconfig del clúster de administrador.

Opcional: Ejecuta la verificación de la solicitud preliminar para la actualización:

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

Inicia la actualización (por lo general, tarda entre 10 y 15 min en completarse):
```
actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG
```
Verifica la versión del centro de administración para confirmar que esté actualizada:
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```

Opción 2: Actualiza los componentes individuales

Los operadores de infraestructura pueden administrar las actualizaciones de un componente específico que se ejecuta en el centro de administración. A partir de la versión 1.9, se pueden actualizar tres componentes individuales: el operador de Anthos Config Management, el operador de Anthos Service Mesh y Anthos en equipos físicos.

Después de subir las imágenes al registro de contenedores, debes publicar las especificaciones del paquete enviadas en la versión nueva. Por ejemplo, la especificación de paquetes del operador de Anthos Config Management y el de Anthos Service Mesh están disponibles en services/.

Aplica la especificación del paquete para el nuevo operador de Anthos Config Management.

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

Verifica el estado actual del componente del operador de Anthos Config Management.

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

Supón que el comando otorga la versión actual de 1.9.X y la restricción de la versión actual de <=1.9.X.

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

Para habilitar la versión nueva, edita las restricciones de la versión en el objeto administrador de operadores.
```
kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
En el editor, ubica las políticas de actualización en spec.updateConfigOverride.policies y aumenta las versiones de los componentes según corresponda. Si se omite spec.updateConfigOverride o tiene un valor de struct vacío ({}), debes agregar la política de la siguiente manera.
```
spec:
  updateConfigOverride:
    policies:
    - name: anthos-config-management
      versionConstraint: <=1.9.Y
```

Después de agregar la anulación, el centro de administración lanza el cambio para recoger la versión más reciente del operador de Anthos Config Management.

Ejecuta el siguiente comando para supervisar el lanzamiento de la versión nueva, que se espera que cambie de 1.9.X anterior a 1.9.Y.

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

Cuando se completa el lanzamiento, los administradores de plataforma pueden usar el nuevo operador de Anthos Config Management a través del centro de administración.

Cambiar a una versión superior de clústeres de usuario

Los administradores de plataforma pueden actualizar los clústeres de usuario mediante la herramienta de línea de comandos de actl, el centro de administración o la API.

actl

Ejecuta el siguiente comando para actualizar un clúster de usuario:

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Console

En la consola del centro de administración, ve al menú Panel.
Haz clic en la pestaña Actualizaciones para ver todas las actualizaciones disponibles.
Haz clic en Ver actualizaciones para el clúster que deseas actualizar.
Haz clic en Actualizar para ver los detalles, como la versión, la descripción y un vínculo a las notas de la versión.
Haz clic en Continuar para confirmar.
Haz clic en Actualizar para comenzar a actualizar el clúster.

La entrada de la lista de actualización mostrará Upgrade in progress hasta que finalice la actualización.

API

Puedes actualizar un clúster de usuario si modificas la string de versión en el recurso Cluster.

Ejecuta el siguiente comando a fin de editar el recurso Cluster para un clúster de usuario.

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

Actualiza la string de versión en spec.anthosBareMetalVersion y los controladores funcionarán en las actualizaciones.

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

Reemplaza VERSION por el número de la nueva versión de Anthos en equipos físicos.

¿Qué sigue?

Obtén más información sobre cómo instalar Anthos Management Center.