Migrer depuis Hierarchy Controller vers Hierarchical Namespace Controller (HNC)
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment migrer depuis Hierarchy Controller (non disponible à partir de décembre 2024) vers Hierarchical Namespace Controller (HNC) Kubernetes Open Source.
Pour déterminer comment migrer vers HNC, inspectez l'objet ConfigManagementkubectl ou le fichier apply specgcloud 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 :
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 :
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 :
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 :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/05/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/05/01 (UTC)."],[],[],null,["# Disable Hierarchy Controller\n\nThis page explains how to disable Hierarchy Controller so that you can\nupgrade Config Sync.\n\nHierarchy Controller is no longer available. Starting in version 1.20.0,\nConfig Sync blocks upgrades if Hierarchy Controller is installed.\n\nTo determine how to disable Hierarchy Controller, inspect the\n[`kubectl` `ConfigManagement` object](/kubernetes-engine/enterprise/config-sync/docs/configmanagement-fields)\nor [`gcloud` `apply spec` file](/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields#hierarchy_controller)\nand take an action that corresponds to the value in the following fields:\n\n- `hierarchyController.enablePodTreeLabels`: if `true`, and you use [hierarchical observability](/kubernetes-engine/enterprise/config-sync/docs/how-to/observing-hierarchical-workloads#enable_hierarchical_observability), don't proceed with the steps on this page. Instead, reach out to [Cloud Customer Care](/support/docs) for help removing Hierarchy Controller.\n- `hierarchyController.enabled:` if `true`, follow the instructions on this page to disable Hierarchy Controller.\n\nWhen you disable Hierarchy Controller, it deletes the Hierarchy Controller\ncomponents in your cluster. It does not\ndelete the Hierarchy Controller Custom Resource Definitions (CRD). You\nneed to manually remove those CRDs using `kubectl`:\n\n- `HierarchyConfiguration`\n- `HNCConfiguration`\n- `SubnamespaceAnchor`\n- `HierarchicalResourceQuota`\n\nTo remove the Hierarchy Controller fields, review the instructions\nfor the method that you used to install Hierarchy Controller: \n\n### gcloud\n\nRemove the `hierarchyController` block from your\n[Google Cloud CLI `apply spec` file](/kubernetes-engine/enterprise/config-sync/docs/reference/gcloud-apply-fields#hierarchy_controller).\n\n### Terraform\n\nRemove the `hierarchyController` block from your\n[Terraform resource](https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/gke_hub_feature_membership#argument-reference).\n\n### Config Connector\n\nSet Hierarchy Controller fields to `false` in the\n[`GKEHubFeatureMembership`](/config-connector/docs/reference/resource-docs/gkehub/gkehubfeaturemembership)\nresource.\n| **Important:** Don't remove the Hierarchy Controller fields from the `GKEHubFeatureMembership` resource. Removing the fields doesn't disable Hierarchy Controller and causes the fields to become [externally-managed](/config-connector/docs/concepts/managing-fields-externally) instead of managed by Config Connector.\n\n### kubectl\n\nRemove the `hierarchyController` block from the\n[`ConfigManagement` object](/kubernetes-engine/enterprise/config-sync/docs/configmanagement-fields)."]]
