Von Hierarchy Controller zu Hierarchical Namespace Controller (HNC) migrieren

Auf dieser Seite wird beschrieben, wie Sie von Hierarchy Controller (ab Dezember 2024 nicht mehr verfügbar) zur Kubernetes-basierten Open-Source-Lösung Hierarchical Namespace Controller (HNC) migrieren.

Untersuchen Sie das Objekt kubectl ConfigManagement oder die Datei gcloud apply spec 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:

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