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.6.1.
  • Actualiza a Kf v2.6.1.
  • 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.5.4
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.5.4
...

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

Si el valor del servidor de Kf es anterior a v2.5.x, primero debes actualizar a Kf v2.5.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.

  1. Aplica el operador yaml:

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

Actualiza las dependencias de Kf

  1. Actualiza 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 de la guía de actualización de Cloud Service Mesh.
  1. Actualiza Config Connector.

    1. Descarga el archivo tar de Config Connector más reciente.

    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.6.1

  1. 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.6.1/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.6.1/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.6.1/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.6.1/kf-windows.exe kf.exe
    
  2. 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.6.1
      Server version:                   v1.21.3-gke.2001
      kf["app.kubernetes.io/version"]:  v2.6.1
    ...
    

Verifica que Kf se haya actualizado correctamente

  1. 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.