Actualizar Kf fuera de Google Cloud

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

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

  • Confirma que tu versión actual de Kf se puede actualizar a Kf 2.6.1.
  • Actualiza a Kf v2.6.1.
  • Actualiza las dependencias (si es necesario).

Antes de empezar

Necesitarás lo siguiente:

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

Prepararse para la actualización

Conéctate al clúster de destino.

gcloud container hub memberships get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Confirma que las versiones actuales de la CLI de Kf y del servidor coinciden

Ejecuta kf debug y comprueba que las versiones de la CLI de Kf y del servidor de Kf coincidan.

  • La versión de la CLI aparece en Kf Client.
  • La versión del servidor Kf se indica en kf["app.kubernetes.io/version"].
$ kf debug
...
Version:
  Kf Client:                        v2.5.4
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.5.4
...

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

Si el valor del servidor Kf es anterior a la versión 2.5.x, primero debes actualizarlo de forma incremental a la versión 2.5.x para continuar.

Confirma que Kf está en buen estado antes de actualizar

Ejecuta kf doctor para comprobar el estado de tu clúster. Asegúrate de que todas las pruebas se superen 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 kf doctor o consulta la guía de solución de problemas para resolver el problema y vuelve a intentar ejecutar el comando hasta que se complete correctamente.

Actualizar el operador

El operador de Kf realiza las actualizaciones por ti.

  1. Aplica el archivo yaml del operador:

    kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"

Actualizar las dependencias de Kf

  1. Actualizar Tekton:

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

  2. Actualiza a la versión más reciente de Cloud Service Mesh:

    1. Sigue los pasos que se indican en la guía de actualización de Cloud Service Mesh.

Actualizar a la CLI de Kf 2.6.1

  1. Instala la CLI:

    Linux

    Este comando instala la CLI de Kf para todos los usuarios del sistema. Sigue las instrucciones de la pestaña Cloud Shell para instalarlo solo para ti.

    gcloud storage cp gs://kf-releases/v2.6.1/kf-linux /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Mac

    Este comando instala kf para todos los usuarios del sistema.

    gcloud storage cp gs://kf-releases/v2.6.1/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Este comando instala kf en tu instancia de Cloud Shell si usas bash. Si usas otro shell, es posible que tengas que modificar las instrucciones.

    mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.6.1/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    De esta forma, se descarga kf en el directorio actual. Añádela a la ruta si quieres llamarla desde cualquier otro directorio que no sea el actual.

    gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe

  2. Valida que las versiones de la CLI de Kf y del servidor de Kf coincidan:

    • La versión de la CLI aparece en Kf Client.
    • La versión del servidor Kf se indica en kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...

Verificar que Kf se ha actualizado correctamente

  1. Ejecuta doctor para asegurarte de que la versión recién instalada funciona correctamente:

    kf doctor --retries=20

    El comando ejecuta comprobaciones de clúster varias veces. Es normal que algunos intentos fallen mientras se inician los nuevos controladores.

    Si el comando falla y aparece el mensaje Error: environment failed checks, sigue las instrucciones del resultado doctor para solucionar el problema y vuelve a ejecutar el comando hasta que se complete correctamente.

Si se superan los pasos de verificación, significa que el clúster se ha actualizado correctamente. Si tienes algún problema, consulta la página de asistencia para obtener ayuda.