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.

Migración de VMware vSphere de integrado a externo

Kubernetes está dejando de mantener proveedores de nube integrados. VMware vSphere tiene un proveedor de nube externo que se puede utilizar instalando el proveedor de nube de vSphere y los complementos de almacenamiento en la nube.

Esta página explica cómo migrar del proveedor de nube integrado de vSphere al externo, y gestionar las VMs existentes tras la migración.

Sigue los pasos proporcionados en la documentación oficial de migración de vSphere y proporciona los pasos a realizar en Rancher.

Limitación del formato cloud-config

Los volúmenes existentes que fueron aprovisionados utilizando el siguiente formato cloud-config no se migrarán debido a un error existente en la Interfaz de Almacenamiento en la Nube de vSphere (CSI).

Si el cloud-config tiene este formato para la ruta del almacén de datos y del grupo de recursos, el controlador CSI de vSphere no puede reconocerlo:

default-datastore: </datacenter>/datastore/<default-datastore-name>
resourcepool-path: "</datacenter>/host/<cluster-name>/Resources/<resource-pool-name>"

Los volúmenes aprovisionados con el proveedor integrado utilizando el siguiente formato se migrarán correctamente:

default-datastore: <default-datastore-name>
resourcepool-path: "<cluster-name>/Resources/<resource-pool-name>"

Error en sentido ascendente: https://github.com/kubernetes-sigs/vsphere-csi-driver/issues/628

Incidencia de Rancher que sigue este error: https://github.com/rancher/rancher/issues/31105

Requisitos previos

  • La migración de vSphere CSI requiere vSphere 7.0u1. Para poder gestionar los volúmenes integrados de vSphere existentes, actualiza la versión de vSphere a 7.0u1.

  • La versión de Kubernetes debe ser 1.19 o superior.

Migración

1. Instalar el complemento CPI

Antes de instalar CPI, necesitamos aplicar una taint a todos los nodos con node.cloudprovider.kubernetes.io/uninitialized=true:NoSchedule.

Esto se puede hacer ejecutando los siguientes comandos:

curl -O https://raw.githubusercontent.com/rancher/helm3-charts/56b622f519728378abeddfe95074f1b87ab73b1e/charts/vsphere-cpi/taints.sh

O bien:

wget https://raw.githubusercontent.com/rancher/helm3-charts/56b622f519728378abeddfe95074f1b87ab73b1e/charts/vsphere-cpi/taints.sh
chmod +x taints.sh
./taints.sh <path to kubeconfig if running the command outside the cluster>

Una vez que el script haya aplicado la taint a todos los nodos, lanza el chart de Helm vSphere CPI.

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster donde se instalará el gráfico vSphere CPI y haz clic en Explorar.

  3. Haz clic en Aplicaciones  Gráficos.

  4. Click vSphere CPI.

  5. Haz clic en Instalar.

  6. Completa los detalles requeridos de vCenter y haz clic en Instalar.

vSphere CPI inicializa todos los nodos con ProviderID, que es necesario para el controlador vSphere CSI.

Verifica si todos los nodos están inicializados con el ProviderID con el siguiente comando:

kubectl describe nodes | grep "ProviderID"

2. Instala el controlador CSI

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster donde se instalará el gráfico vSphere CSI y haz clic en Explorar.

  3. Haz clic en Aplicaciones  Gráficos.

  4. Click vSphere CSI.

  5. Haz clic en Instalar.

  6. Completa los detalles requeridos de vCenter y haz clic en Instalar.

  7. Marca Personalizar opciones de Helm antes de instalar y haz clic en Siguiente.

  8. En la pestaña Características, marca Habilitar migración CSI.

  9. Opcionalmente, ve a la pestaña Almacenamiento y configura un datastore. Este gráfico crea una StorageClass con el csi.vsphere.vmware.com como aprovisionador. Puedes proporcionar la URL del almacén de datos que se utilizará para el aprovisionamiento de volúmenes CSI al crear esta StorageClass. La URL del almacén de datos se puede encontrar en el cliente de vSphere seleccionando el almacén de datos y yendo a la pestaña Resumen. Completa los detalles para la StorageClass.

  10. Haz clic en Instalar.

3. Edita el clúster para habilitar las banderas de características de migración CSI.

  1. Mientras editas el clúster, si la versión de Kubernetes es inferior a 1.19, selecciona la versión de Kubernetes 1.19 o superior del menú desplegable Versión de Kubernetes.

  2. Para habilitar las banderas de características, haz clic en "Editar como YAML" y añade lo siguiente bajo kube-controller y kubelet:

       extra_args:
     feature-gates: "CSIMigration=true,CSIMigrationvSphere=true"

4. Drenar nodos de trabajo.

Los nodos de trabajo deben ser drenados durante la actualización antes de cambiar los argumentos de kubelet y kube-controller-manager.

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. Ve al clúster donde drenarás los nodos de trabajo y haz clic en ⋮ > Editar Config.

  3. En la sección Opciones Avanzadas, establece el campo Máximo número de nodos de trabajo no disponibles en 1.

  4. Para drenar los nodos durante la actualización, selecciona Drenar Nodos  Sí.

  5. Establece Forzar y Eliminar Datos Locales a true.

  6. Haz clic en Guardar para actualizar el clúster.