Migrer depuis Hierarchy Controller vers Hierarchical Namespace Controller (HNC)

Cette page explique comment migrer depuis Hierarchy Controller (bêta) vers Hierarchical Namespace Controller (HNC) Kubernetes Open Source.

Pour déterminer comment migrer vers HNC, inspectez l'objet ConfigManagement kubectl ou le fichier apply spec gcloud et effectuez une action correspondant à la valeur des champs suivants :

• hierarchyController.enablePodTreeLabels : si la valeur est true et que vous utilisez l'observabilité hiérarchique, ne suivez pas la procédure décrite sur cette page. Contactez plutôt Cloud Customer Care pour obtenir de l'aide pour migrer vers une autre solution.
• hierarchyController.enabled: si la valeur est true, procédez comme suit :
  1. Désactivez Hierarchy Controller.
  2. Installez HNC.
  3. Vous pouvez également migrer les quotas de ressources hiérarchiques vers HNC.

Désactiver Hierarchy Controller

Lorsque vous désactivez Hierarchy Controller, les composants Hierarchy Controller de votre cluster sont supprimés. Il ne supprime pas les définitions de ressources personnalisées (CRD) de Hierarchy Controller :

• HierarchyConfiguration
• HNCConfiguration
• SubnamespaceAnchor
• HierarchicalResourceQuota

Pour supprimer les champs Hierarchy Controller, consultez les instructions de la méthode que vous avez utilisée pour installer Hierarchy Controller :

gcloud

Supprimez le bloc hierarchyController de votre fichier apply spec Google Cloud CLI.

Terraform

Supprimez le bloc hierarchyController de votre ressource Terraform.

Config Connector

Définissez les champs Hierarchy Controller sur false dans la ressource GKEHubFeatureMembership.

Important : Ne supprimez pas les champs Hierarchy Controller de la ressource GKEHubFeatureMembership. La suppression des champs ne désactive pas Hierarchy Controller et entraîne la gestion externe des champs au lieu d'être gérés par Config Connector.

kubectl

Supprimez le bloc hierarchyController de l'objet ConfigManagement.

Installer HNC

Suivez les instructions pour installer HNC sur un cluster.

Si vous utilisez des quotas de ressources hiérarchiques, vous devez installer HNC version 1.1.0 ou ultérieure.

Migrer les quotas de ressources hiérarchiques

Si vous avez utilisé des quotas de ressources hiérarchiques avec Hierarchy Controller en définissant hierarchyController.enableHierarchicalResourceQuota sur true, procédez comme suit pour terminer la migration vers HNC :

1. Installez les quotas de ressources hiérarchiques HNC en installant le fichier hrq.yaml sous Releases > Assets

2. Pour migrer les ressources personnalisées de quota de ressources hiérarchiques existantes, remplacez hierarchycontroller.configmanagement.gke.io/v1alpha1 par hnc.x-k8s.io/v1alpha2 dans le champ apiVersion. Pour trouver les ressources personnalisées de votre cluster, exécutez la commande suivante :

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

3. Réappliquez les ressources de quota de ressources hiérarchiques.

4. Supprimez le CRD du quota de ressources hiérarchiques de Hierarchy Controller :

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