Eseguire la migrazione da un controller di gerarchia a un controller dello spazio dei nomi gerarchico (HNC)

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

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 osservabilità gerarchica, non continuare con i passaggi descritti in questa pagina. Contatta invece Assistenza clienti Google Cloud per un aiuto nella migrazione a un'alternativa.
• hierarchyController.enabled: se true:
  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 controllo della gerarchia, consulta le istruzioni per il metodo usato per installare Hierarchy Controller:

gcloud

Rimuovi il blocco hierarchyController da 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 disabilita la gerarchia di controller e le cause i campi per diventare gestiti esternamente anziché da Config Connector.

kubectl

Rimuovi il blocco hierarchyController dall'oggetto ConfigManagement.

Installare 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 quote gerarchiche delle risorse con Hierarchy Controller Impostazione di 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 della quota di risorse gerarchica esistente, 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. Riapplica 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