Migra de controlador de jerarquía al controlador de espacio de nombres jerárquico (HNC)

En esta página, se explica cómo migrar del controlador de jerarquía (vista previa) al controlador de espacios de nombres jerárquico (HNC) de Kubernetes de código abierto.

Para determinar cómo migrar al HNC, inspecciona el objeto ConfigManagement kubectl o el archivo apply spec gcloud y realiza una acción que corresponda al valor de los siguientes campos:

• hierarchyController.enablePodTreeLabels: Si true y usas observabilidad jerárquica, no sigas los pasos de esta página. En su lugar, comunícate con Atención al cliente de Cloud para obtener ayuda con la migración a una alternativa.
• hierarchyController.enabled: si true, haz lo siguiente:
  1. Inhabilita el controlador de jerarquía.
  2. Instala el HNC.
  3. De forma opcional, migra las cuotas de recursos jerárquicos al HNC.

Inhabilita el controlador de jerarquía

Cuando inhabilitas el controlador de jerarquía, se borran los componentes del controlador de jerarquía de tu clúster. No borra las definiciones de recursos personalizados (CRD) del controlador de jerarquía:

• HierarchyConfiguration
• HNCConfiguration
• SubnamespaceAnchor
• HierarchicalResourceQuota

Si deseas quitar los campos del controlador de jerarquía, revisa las instrucciones del método que usaste para instalar el controlador de jerarquía:

gcloud

Quita el bloque hierarchyController del archivo apply spec de Google Cloud CLI.

Terraform

Quita el bloque hierarchyController de tu recurso de Terraform.

Config Connector

Configura los campos del controlador de jerarquía como false en el recurso GKEHubFeatureMembership.

Importante: No quites los campos del controlador de jerarquía del recurso GKEHubFeatureMembership. Quitar los campos no inhabilita el controlador de jerarquía y hace que los campos se administren de forma externa en lugar de ser administrados por Config Connector.

kubectl

Quita el bloque hierarchyController del objeto ConfigManagement.

Instala el HNC

Sigue las instrucciones para instalar el HNC en un clúster.

Si usas cuotas de recursos jerárquicos, debes instalar la versión 1.1.0 del HNC o una posterior.

Migra cuotas de recursos jerárquicos

Si usaste cuotas de recursos jerárquicos con el controlador de jerarquía mediante la configuración de hierarchyController.enableHierarchicalResourceQuota en true, para terminar de migrar al HNC, completa los siguientes pasos:

1. Instala las cuotas de recursos jerárquicos del HNC mediante la instalación del archivo hrq.yaml en Releases > Assets.

2. Para migrar los recursos personalizados de cuota de recursos jerárquica existentes, cambia el campo apiVersion de hierarchycontroller.configmanagement.gke.io/v1alpha1 a hnc.x-k8s.io/v1alpha2. Para encontrar los recursos personalizados en tu clúster, ejecuta el siguiente comando:

   kubectl get hierarchicalresourcequota.hierarchycontroller.configmanagement.gke.io --all-namespaces
   

3. Vuelve a aplicar los recursos de cuota de recursos jerárquicos.

4. Borra el CRD para la cuota de recursos jerárquicos del controlador de jerarquía:

   kubectl delete crd hierarchicalresourcequotas.hierarchycontroller.configmanagement.gke.io