Von Hierarchy Controller zu Hierarchical Namespace Controller (HNC) migrieren

Auf dieser Seite wird beschrieben, wie Sie von Hierarchy Controller (Vorabversion) zum Open-Source-Kubernetes-Hierarchical Namespace Controller (HNC) migrieren.

Informationen zur Migration zu HNC finden Sie in der kubectl ConfigManagement Objekt odergcloud apply spec Datei und führen Sie dann eine Aktion aus, die dem Wert in den folgenden Feldern entspricht:

• hierarchyController.enablePodTreeLabels: Wenn true und Sie die hierarchische Beobachtbarkeit verwenden, fahren Sie nicht mit den Schritten auf dieser Seite fort. Wenden Sie sich stattdessen an den Cloud Customer Care, um Unterstützung bei der Migration zu einer Alternative zu erhalten.
• hierarchyController.enabled: wenn true, führen Sie die folgenden Schritte aus:
  1. Hierarchy Controller deaktivieren.
  2. Installieren Sie HNC.
  3. Optional können Sie hierarchische Ressourcenkontingente zu HNC migrieren.

Hierarchy Controller deaktivieren

Wenn Sie Hierarchy Controller deaktivieren, werden die Hierarchy Controller-Komponenten im Cluster gelöscht. Die benutzerdefinierten Ressourcendefinitionen (CRD) des Hierarchy Controllers werden nicht gelöscht:

• HierarchyConfiguration
• HNCConfiguration
• SubnamespaceAnchor
• HierarchicalResourceQuota

Wenn Sie die Felder für den Hierarchy Controller entfernen möchten, lesen Sie die Anleitung für die Methode, mit der Sie den Hierarchy Controller installiert haben:

gcloud

Entfernen Sie den Block hierarchyController aus der apply spec-Datei der Google Cloud CLI.

Terraform

Entfernen Sie den Block hierarchyController aus Ihrer Terraform-Ressource.

Config Connector

Legen Sie die Felder „Hierarchy Controller“ in der Ressource GKEHubFeatureMembership auf false fest.

Wichtig: Entfernen Sie die Felder „Hierarchy Controller“ nicht aus der GKEHubFeatureMembership-Ressource. Durch das Entfernen der Felder wird Hierarchy Controller nicht deaktiviert. Die Felder werden dann extern verwaltet, anstatt von Config Connector.

kubectl

Entfernen Sie den hierarchyController-Block aus dem ConfigManagement-Objekt.

HNC installieren

Folgen Sie der Anleitung zum Installieren von HNC auf einem Cluster.

Wenn Sie hierarchische Ressourcenquoten verwenden, müssen Sie HNC Version 1.1.0 oder höher installieren.

Hierarchische Ressourcenkontingente migrieren

Wenn Sie hierarchische Ressourcenkontingente mit Hierarchy Controller verwendet haben, indem Sie hierarchyController.enableHierarchicalResourceQuota auf true gesetzt haben, führen Sie die folgenden Schritte aus, um die Migration zu HNC abzuschließen:

1. Installieren Sie die hierarchischen HNC-Ressourcenkontingente. Installieren Sie dazu die Datei hrq.yaml unter Releases > Assets.

2. Wenn Sie die vorhandenen benutzerdefinierten Ressourcen für hierarchische Ressourcenkontingente migrieren möchten, ändern Sie das Feld apiVersion von hierarchycontroller.configmanagement.gke.io/v1alpha1 in hnc.x-k8s.io/v1alpha2. Sie können die benutzerdefinierten Ressourcen in Ihrem Cluster mit dem folgenden Befehl ermitteln:

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

3. Wenden Sie die hierarchischen Ressourcenkontingente-Ressourcen noch einmal an.

4. Löschen Sie die CRD für das hierarchische Ressourcenkontingent aus Hierarchy Controller:

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