Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Actualizando en un entorno aislado

Estas instrucciones asumen que ya has seguido las instrucciones para una actualización de Kubernetes en esta página, incluyendo los requisitos previos, hasta el paso 3. Actualizar Rancher.

Opciones de actualización de Rancher Helm

Para actualizar Rancher con Helm, aplica las mismas opciones que utilizaste al instalarlo. Consulta la tabla de referencia a continuación para reemplazar cada marcador de posición. Rancher necesita ser configurado para utilizar el registro privado con el fin de aprovisionar cualquier clúster de Kubernetes lanzado por Rancher o herramientas de Rancher.

Según la elección que hiciste durante la instalación, completa uno de los procedimientos a continuación.

Espacio reservado Descripción

<VERSION>

El número de versión del archivo tarball de salida.

<RANCHER.YOURDOMAIN.COM>

El nombre DNS que apuntaste a tu equilibrador de carga.

<REGISTRY.YOURDOMAIN.COM:PORT>

El nombre DNS para tu registro privado.

<CERTMANAGER_VERSION>

Versión de cert-manager en el clúster de k8s.

Opción A: Certificado Autofirmado por Defecto

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Establecer un registro privado por defecto que se utilizará en Rancher
    --set useBundledSystemChart=true # Usar los gráficos del sistema de Rancher empaquetados

Resolviendo el error UPGRADE FAILED

Si encuentras el mensaje de error, Error: UPGRADE FAILED: "rancher" has no deployed releases, es posible que Rancher haya sido instalado a través del comando helm template. Para actualizar Rancher con éxito, utiliza el siguiente comando en su lugar:

helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
    --no-hooks \ # prevent files for Helm hooks from being generated
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set certmanager.version=<CERTMANAGER_VERSION> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Después de ejecutar el comando Helm, aplica la plantilla renderizada:

kubectl -n cattle-system apply -R -f ./rancher

Opción B: Certificados desde archivos utilizando secretos de Kubernetes

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Si estás utilizando un certificado firmado por una CA privada, añade --set privateCA=true después de --set ingress.tls.source=secret:

helm upgrade rancher ./rancher-<VERSION>.tgz \
    --namespace cattle-system \
    --set hostname=<RANCHER.YOURDOMAIN.COM> \
    --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
    --set ingress.tls.source=secret \
    --set privateCA=true \
    --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
    --set useBundledSystemChart=true # Use the packaged Rancher system charts

Verifica la actualización

Inicia sesión en Rancher para confirmar que la actualización se realizó con éxito.

¿Tienes problemas de red tras la actualización?

Consulta xref:[Restaurando la red del clúster].

Problemas de actualización conocidos

Una lista de problemas conocidos para cada versión de Rancher se puede encontrar en las notas de la versión en GitHub y en los foros de Rancher.