Actualizar Kf

En este documento, se describe cómo actualizar una instalación de Kf existente y sus dependencias.

Como parte del procedimiento de actualización, asegúrate de que la instalación de Kf use la versión más reciente de su operador:

Confirma que tu versión actual de Kf pueda actualizarse a Kf v2.5.4.
Actualiza a Kf v2.5.4.
Actualiza las dependencias (si es necesario).

Antes de comenzar

Necesitarás:

Un clúster existente con Kf instalado.
Acceso a una máquina que tiene gcloud, kf y kubectl instalados.

Prepárate para la actualización

Conéctate a tu clúster de destino

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Confirma que la CLI de Kf actual y las versiones del servidor coincidan

Ejecuta kf debug y valida la CLI de Kf y la coincidencia de las versiones del servidor de Kf.

La versión de la CLI se muestra en Kf Client.
La versión del servidor Kf aparecerá en kf["app.kubernetes.io/version"].

$ kf debug
...
Version:
  Kf Client:                        v2.4.1
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.4.1
...

Si los valores de cliente y de servidor de Kf no coinciden, pero la versión del servidor es v2.4.x, instala la CLI de Kf v2.5.4 antes de continuar.

Si el valor del servidor de Kf es anterior a v2.4.x, primero debes actualizar a Kf v2.4.x de forma incremental para continuar.

Confirma que Kf esté en buen estado antes de realizar la actualización

Ejecuta kf doctor para verificar el estado de tu clúster. Asegúrate de que todas las pruebas se aprueben antes de continuar.

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

Si ves algún mensaje FAIL o Error: environment failed checks, sigue las instrucciones de la salida de kf doctor o ve la guía de solución de problemas para resolver el problema y volver a ejecutar el comando hasta que tenga éxito.

Actualiza el operador

El operador Kf realiza actualizaciones por ti.

Aplica el operador yaml:

Nota: Esta operación comienza de inmediato y no se puede revertir.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.5.4/operator.yaml"
```

Actualiza las dependencias de Kf

Actualiza Tekton:

Nota: Kf v2.5.4 usa la misma Tekton v0.23.0 que Kf v2.4.1, por lo que no es necesario actualizar.
Actualiza a la versión más reciente de Cloud Service Mesh:
1. Sigue los pasos de la guía de actualización de Cloud Service Mesh.
Actualiza Config Connector.

Nota: Kf v2.5.4 usa la misma configuración de Config Connector v1.46.0 que Kf v2.4.1, por lo que no se requiere actualizar.

Actualiza a la CLI de Kf v2.5.4

Instala la CLI:
Linux
Con este comando, se instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña de Cloud Shell para instalarlo tú mismo.
```
gcloud storage cp gs://kf-releases/v2.5.4/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Mac
Con este comando, se instala kf para todos los usuarios del sistema.
```
gcloud storage cp gs://kf-releases/v2.5.4/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf
```
Cloud Shell
Este comando instalará kf en tu instancia de Cloud Shell si usas bash. Es posible que tengas que modificar las instrucciones para otros shells.
```
mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Esta acción descarga kf al directorio actual. Agrégalo a la ruta si deseas llamar desde cualquier otro lugar que no sea el directorio actual.
```
gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe
```
Valida la CLI de Kf y la coincidencia de las versiones del servidor de Kf:
- La versión de la CLI se muestra en Kf Client.
- La versión del servidor Kf aparecerá en kf["app.kubernetes.io/version"].
```
$ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.5.4
...
```

Verifica que Kf se haya actualizado correctamente

Ejecuta doctor para asegurarte de que la versión recién instalada esté en buen estado:
```
kf doctor --retries=20
```
El comando ejecuta verificaciones de clúster varias veces. Es normal que algunos de ellos fallen mientras se inician los controladores nuevos.

Si el comando falla con el mensaje Error: environment failed checks, sigue las instrucciones del resultado de doctor para resolver el problema y vuelve a ejecutar el comando hasta que tenga éxito.

Si los pasos de verificación se aprueban, tu clúster se actualizó correctamente. Si tienes algún problema, revisa la página de asistencia para obtener asesoramiento.