Actualiza Kf en Google Cloud

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.9.0.
Actualiza a Kf v2.9.0.
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.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

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

Si el valor del servidor de Kf es anterior a v2.7.x, primero debes actualizar a Kf v2.7.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.9.0/operator.yaml"
```

Actualiza las dependencias de Kf

Actualiza Tekton:

kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.32.1/release.yaml"

Actualiza a Cloud Service Mesh v1.12:
1. Sigue los pasos de la guía de actualización de Cloud Service Mesh.

Actualiza o instala Config Connector:

Para actualizar desde Kf v2.8: sigue los pasos de “Instala Config Connector” en Kf Install

Para actualizar desde Kf v2.7:
1. Descarga el archivo tar de Config Connector más reciente.
  
  Nota: Conserva una copia del paquete de instalación, ya que lo necesitarás para desinstalar Config Connector.
2. Extrae el archivo tar.
```
tar zxvf release-bundle.tar.gz
```
3. Instala el operador de Config Connector en tu clúster.
```
kubectl apply -f operator-system/configconnector-operator.yaml
```

Actualiza a la CLI de Kf v2.9.0

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.9.0/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.9.0/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.9.0/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.9.0/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.9.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.9.0
...
```

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.