Esegui la migrazione da Hierarchy Controller a Hierarchical Namespace Controller (HNC)

Questa pagina spiega come eseguire la migrazione da Hierarchy Controller (non disponibile a partire da dicembre 2024) a Hierarchical Namespace Controller (HNC) di Kubernetes open source.

Per determinare come eseguire la migrazione a HNC, controlla l'oggetto kubectl ConfigManagement o il file gcloud apply spec e esegui un'azione corrispondente al valore nei seguenti campi:

• hierarchyController.enablePodTreeLabels: se true e utilizzi la osservabilità gerarchica, non procedere con i passaggi descritti in questa pagina. Rivolgiti all'assistenza clienti Google Cloud per ricevere assistenza per la migrazione a un'alternativa.
• hierarchyController.enabled: se true, procedi nel seguente modo:
  1. Disattiva Hierarchy Controller.
  2. Installa HNC.
  3. Se vuoi, esegui la migrazione delle quote per le risorse gerarchiche a HNC.

Disattiva Hierarchy Controller

Quando disattivi Hierarchy Controller, vengono eliminati i componenti di Hierarchy Controller nel cluster. Non elimina le definizioni di risorse personalizzate (CRD) di Hierarchy Controller:

• HierarchyConfiguration
• HNCConfiguration
• SubnamespaceAnchor
• HierarchicalResourceQuota

Per rimuovere i campi di Hierarchy Controller, consulta le istruzioni per il metodo utilizzato per installare Hierarchy Controller:

gcloud

Rimuovi il blocco hierarchyController dal file apply spec di Google Cloud CLI.

Terraform

Rimuovi il blocco hierarchyController dalla risorsa Terraform.

Config Connector

Imposta i campi Hierarchy Controller su false nella risorsa GKEHubFeatureMembership.

Importante: non rimuovere i campi del controller gerarchico dalla risorsa GKEHubFeatureMembership. La rimozione dei campi non disattiva Hierarchy Controller e fa sì che i campi diventino gestiti esternamente anziché da Config Connector.

kubectl

Rimuovi il blocco hierarchyController dall'oggetto ConfigManagement.

Installa HNC

Segui le istruzioni per installare HNC su un cluster.

Se utilizzi le quote di risorse gerarchiche, devi installare la versione 1.1.0 di HNC o successive.

Eseguire la migrazione delle quote delle risorse gerarchiche

Se hai utilizzato le quote per le risorse gerarchiche con Hierarchy Controller impostando hierarchyController.enableHierarchicalResourceQuota su true, per completare la migrazione a HNC, completa i seguenti passaggi:

1. Installa le quote di risorse gerarchiche HNC installando il file hrq.yaml in Releases > Assets.

2. Per eseguire la migrazione delle risorse personalizzate delle quote per risorse gerarchiche esistenti, modifica il campo apiVersion da hierarchycontroller.configmanagement.gke.io/v1alpha1 a hnc.x-k8s.io/v1alpha2. Puoi trovare le risorse personalizzate sul tuo cluster eseguendo il seguente comando:

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

3. Applica di nuovo le risorse di quota delle risorse gerarchiche.

4. Elimina il CRD per la quota di risorse gerarchica dal controller della gerarchia:

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