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
ykubectl
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.
Aplica el operador yaml:
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"
Actualiza las dependencias de Kf
Actualiza Tekton:
kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.26.0/release.yaml"
Actualiza a la versión más reciente de Cloud Service Mesh:
- Sigue los pasos de la guía de actualización de Cloud Service Mesh.
Actualiza Config Connector.
Descarga el archivo tar de Config Connector más reciente.
Extrae el archivo tar.
tar zxvf release-bundle.tar.gz
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
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 usasbash
. 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
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 ...
- La versión de la CLI se muestra en
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 dedoctor
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.