Installazione di Hierarchy Controller

Beta

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Hierarchy Controller consente di organizzare gli spazi dei nomi Kubernetes in gerarchie, applicare criteri (ad esempio RBAC e quote delle risorse gerarchiche) e osservare i carichi di lavoro dagli spazi dei nomi correlati.

Questa pagina mostra come installare, configurare e disinstallare Hierarchy Controller.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti attività:

• Installa e inizializza Google Cloud CLI, che fornisce i comandi gcloud e kubectl utilizzati in queste istruzioni. Se utilizzi Cloud Shell, Google Cloud CLI è preinstallato.

• Avere un cluster che esegue una versione di Kubernetes 1.16.x o successiva.

Hierarchy Controller è progettato per lavorare a stretto contatto con Config Sync per consentirti di gestire gli spazi dei nomi e i criteri gerarchici tramite un repository Git. Se scegli di farlo, ti consigliamo di selezionare un repository non strutturato al momento di installare Config Sync, che consente di organizzare il repository nel modo che preferisci mantenendo i vantaggi dei criteri gerarchici. Al contrario, un repository gerarchico può entrare in conflitto con Hierarchy Controller; non è consigliabile utilizzare i due elementi insieme.

In alternativa, puoi scegliere di installare Hierarchy Controller senza configurare un repository Config Sync. Gli spazi dei nomi gerarchici possono essere definiti interamente sul cluster tramite l'API Kubernetes. Se non prevedi di utilizzare Git, non è necessario concedere all'operatore l'accesso a Git né configurarlo in alcun modo, ad eccezione di quanto descritto nella sezione seguente.

Abilita Hierarchy Controller

Segui questi passaggi per configurare Config Sync per installare Hierarchy Controller.

Nota: Hierarchy Controller non è supportato sui cluster Autopilot.

gcloud

Nota: il formato file per il comando gcloud CLI apply è stato modificato per la versione 1.8.0. Assicurati di aggiornare gcloud CLI alla versione più recente.

Segui questi passaggi per configurare Config Sync e installare Hierarchy Controller, inclusi tutti i componenti facoltativi. Se non vuoi abilitare l'osservabilità gerarchica o le quote delle risorse gerarchiche, commenta le righe indicate.

1. (Facoltativo) Se utilizzi cluster privati, aggiungi regole firewall ai progetti di ciascun cluster per consentire ai piani di controllo del cluster GKE di connettersi ai webhook del controller gerarchia sulla porta 9443:

    gcloud compute firewall-rules create allow-cluster-control-plane-tcp-9443 \
      --allow tcp:9443 \
      --network default \
      --source-ranges CONTROL_PLANE_CIDR \
      --target-tags NODE_TAG
   

   Sostituisci quanto segue:

   • CONTROL_PLANE_CIDR: l'intervallo IP per il piano di controllo del cluster GKE. Ad esempio, 172.16.0.16/28.
   • NODE_TAG: un tag applicato a tutti i nodi nel cluster GKE.

2. Imposta i seguenti valori nell'oggetto spec.hierarchyController su true nel file di configurazione di gcloud:

   # apply-spec.yaml
   
   applySpecVersion: 1
   spec:
     hierarchyController:
       # Set to true to enable hierarchical namespaces
       enabled: true
       # Comment to disable hierarchical quota:
       enableHierarchicalResourceQuota: true
       # Comment to disable hierarchical observability:
       enablePodTreeLabels: true
     # ...other fields...
   

3. Applica il file apply-spec.yaml:

    gcloud beta container fleet config-management apply \
        --membership=CLUSTER_NAME \
        --config=CONFIG_YAML \
        --project=PROJECT_ID
   

   Sostituisci quanto segue:

   • CLUSTER_NAME: aggiungi il cluster registrato a cui vuoi applicare questa configurazione.
   • CONFIG_YAML: aggiungi il percorso al tuo file apply-spec.yaml.
   • PROJECT_ID: aggiungi il tuo ID progetto.

   Viene eseguito il deployment di diversi carichi di lavoro e Hierarchy Controller diventa utilizzabile nel cluster. L'operazione può richiedere fino a un minuto.

kubectl

Segui questi passaggi per configurare Config Sync e installare Hierarchy Controller, inclusi tutti i componenti facoltativi. Se non vuoi abilitare l'osservabilità gerarchica o le quote delle risorse gerarchiche, commenta le righe indicate.

1. (Facoltativo) Se utilizzi cluster privati, aggiungi regole firewall ai progetti di ciascun cluster per consentire ai piani di controllo del cluster GKE di connettersi ai webhook del controller gerarchia sulla porta 9443:

    gcloud compute firewall-rules create allow-cluster-control-plane-tcp-9443 \
      --allow tcp:9443 \
      --network default \
      --source-ranges CONTROL_PLANE_CIDR \
      --target-tags NODE_TAG
   

   Sostituisci quanto segue:

   • CONTROL_PLANE_CIDR: l'intervallo IP per il piano di controllo del cluster GKE. Ad esempio, 172.16.0.16/28.
   • NODE_TAG: un tag applicato a tutti i nodi nel cluster GKE.

2. Nel file di configurazione per l'operatore, nell'oggetto spec.hierarchyController, imposta il valore di enabled su true:

   # config-management.yaml
   
   apiVersion: configmanagement.gke.io/v1
   kind: ConfigManagement
   metadata:
     name: config-management
   spec:
     # Set to true to enable hierarchical namespaces
     hierarchyController:
       enabled: true
       # Comment to disable hierarhical quota:
       enableHierarchicalResourceQuota: true
       # Comment to disable hierarchical observability:
       enablePodTreeLabels: true
      # ...other fields...
   

3. Applica la configurazione:

     kubectl apply -f config-management.yaml
   

   Viene eseguito il deployment di diversi carichi di lavoro e Hierarchy Controller diventa utilizzabile nel cluster. L'operazione può richiedere fino a un minuto.

Installa il plug-in kubectl

È possibile interagire con Hierarchy Controller esclusivamente tramite strumenti client Kubernetes come kubectl. Tuttavia, il plug-in kubectl open source kubectl-hns semplifica enormemente diverse attività. Questo plug-in fa parte di Hierarchical Namespace Controller (HNC), che è un componente di Hierarchical Namespace Controller.

Questo plug-in è distribuito dalla community OSS ed è attualmente disponibile per Linux e macOS. Per installarlo sulla workstation, consulta Installare il plug-in kubectl nella documentazione di Config Sync.

Verifica l'installazione

Dopo aver installato Hierarchy Controller, puoi verificare che l'installazione sia stata completata correttamente.

gcloud

Esegui questo comando:

gcloud beta container fleet config-management status \
    --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto.

Dovresti vedere un output simile all'esempio seguente:

Name          ...other columns... Hierarchy_Controller
CLUSTER_NAME  ...other fields ... INSTALLED

Un'installazione completata presenta lo stato INSTALLED nella colonna Hierarchy_Controller. Potrebbero essere necessari diversi minuti prima che lo stato venga visualizzato dopo l'abilitazione di Hierarchy Controller.

kubectl

Se Hierarchy Controller è installato correttamente, i relativi pod saranno in esecuzione. I pod potrebbero riavviarsi più volte prima di essere disponibili.

Poiché i pod del controller gerarchia vengono eseguiti nello spazio dei nomi hnc-system, puoi visualizzarne lo stato eseguendo questo comando:

kubectl get pods -n hnc-system

Dovresti vedere un output simile all'esempio seguente:

NAME                                         READY   STATUS    RESTARTS   AGE
gke-hc-controller-manager-6f4dbb484d-t8tdm   2/2     Running   1          1m
hnc-controller-manager-7b75655894-tzqvx      2/2     Running   1          1m

Esegui l'upgrade del controller gerarchia

Hierarchy Controller viene aggiornato ogni volta che si esegue l'upgrade di Config Sync. Per scoprire di più, consulta Eseguire l'upgrade di Config Sync.

Disinstalla controller gerarchia

Segui questi passaggi per disinstallare Hierarchy Controller dai tuoi cluster.

gcloud

Per disinstallare Hierarchy Controller:

1. Modifica la configurazione di Hierarchy Controller nel file apply-spec.yaml e imposta hierarchyController.enabled su false.

2. Applica le modifiche nel file apply-spec.yaml:

    gcloud beta container fleet config-management apply \
        --membership=CLUSTER_NAME \
        --config=CONFIG_YAML \
        --project=PROJECT_ID
   

   Sostituisci quanto segue:

   • CLUSTER_NAME: aggiungi il cluster registrato a cui vuoi applicare questa configurazione.
   • CONFIG_YAML: aggiungi il percorso al tuo file apply-spec.yaml.
   • PROJECT_ID: aggiungi il tuo ID progetto.

Dopo che Hierarchy Controller avrà rimosso il finalizzatore hierarchycontroller.configmanagement.gke.io, la disinstallazione è completata.

Nota: la disinstallazione di Hierarchy Controller non rimuove gli spazi dei nomi né rimuove qualsiasi oggetto propagato dagli spazi dei nomi predecessore ai relativi discendenti. Tuttavia, eventuali ulteriori modifiche agli oggetti non vengono propagate.

kubectl

Per disinstallare Hierarchy Controller, modifica la configurazione di Config Sync nel file config-management.yaml e imposta hierarchyController.enabled su false. Dopo che Config Sync ha rimosso il finalizzatore hierarchycontroller.configmanagement.gke.io, la disinstallazione è completata.

Nota: la disinstallazione di Hierarchy Controller non rimuove gli spazi dei nomi né rimuove qualsiasi oggetto propagato dagli spazi dei nomi predecessore ai relativi discendenti. Tuttavia, eventuali ulteriori modifiche agli oggetti non vengono propagate.

Se vuoi disinstallare completamente Config Sync, consulta Disinstallare Config Sync da un cluster.

Passaggi successivi

• Scopri di più su Hierarchy Controller
• Applicare quote delle risorse gerarchiche
• Osservare i carichi di lavoro gerarchici
• Esplora le funzionalità degli spazi dei nomi gerarchici di base
• Esplora le funzionalità avanzate degli spazi dei nomi gerarchici