Disinstalla Config Sync

Questa pagina mostra come disinstallare Config Sync dal cluster, disattivare la funzionalità di gestione della configurazione del parco risorse e disinstallare l'operatore ConfigManagement.

Questa pagina è rivolta agli amministratori e agli operatori IT che gestiscono il ciclo di vita dell'infrastruttura tecnologica sottostante. Per scoprire di più sui ruoli comuni e sulle attività di esempio a cui facciamo riferimento nei contenuti, consulta Ruoli utente e attività comuni di GKE. Google Cloud

La funzionalità del parco risorse Config Management gestisce Config Sync utilizzando l'operatore ConfigManagement. A causa di questa architettura, i passaggi di disinstallazione devono essere completati nel seguente ordine:

1. Disinstallare Config Sync dal cluster
2. Disattiva la funzionalità Config Management nel tuo parco risorse
3. Disinstallare l'operatore ConfigManagement dal cluster

Nota: se utilizzi Config Controller per installare e gestire Config Sync, non utilizzare le istruzioni riportate in questa pagina. Segui invece le istruzioni riportate in Eliminare l'istanza di Config Controller per disinstallare Config Controller.

Disinstalla Config Sync dal cluster

Nota: la disinstallazione di Config Sync comporta l'eliminazione di tutti gli oggetti RootSync e RepoSync sul cluster. Prima di continuare, controlla le norme di propagazione dell'eliminazione sugli oggetti RootSync e RepoSync. Per ulteriori informazioni, vedi Eliminare in blocco gli oggetti.

Console

Non puoi disinstallare Config Sync solo con la console Google Cloud . Utilizza Google Cloud CLI.

gcloud

1. Apri il manifest applySpec che hai creato durante l'installazione con Google Cloud CLI.

2. Nel manifest applySpec, imposta spec.configSync.enabled su false:

   applySpecVersion: 1
   spec:
     configSync:
       enabled: false
   ...
   

3. Applica le modifiche:

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

   Sostituisci quanto segue:

   • MEMBERSHIP_NAME: aggiungi il cluster registrato a cui vuoi applicare questa configurazione. Se hai registrato il cluster nella consoleGoogle Cloud , il nome dell'appartenenza è lo stesso del nome del cluster.

   • CONFIG_YAML: aggiungi il percorso del file apply-spec.yaml.

   • PROJECT_ID: aggiungi il tuo ID progetto.

Terraform

Se hai utilizzato Terraform per installare Config Sync utilizzando una risorsa gke_hub_feature_membership del provider Google Cloud, aggiorna questa risorsa per disinstallare Config Sync. Non utilizzare il comando terraform destroy. Il comando terraform destroy non disinstalla completamente Config Sync. Alcuni componenti rimangono.

1. Identifica la risorsa gke_hub_feature_membership nei file di configurazione Terraform che ha un argomento configmanagement compilato.

2. Aggiorna la risorsa gke_hub_feature_membership per rimuovere l'argomento config_sync da configmanagement.

   Ad esempio:

   resource "google_gke_hub_feature_membership" "feature_member" {
     location = "global"
     feature = google_gke_hub_feature.feature.name
     membership = google_gke_hub_membership.membership.membership_id
     membership_location = google_gke_hub_membership.membership.location
     configmanagement {
       version = "1.20.0"
     }
   }
   

3. Applica la configurazione Terraform:

   terraform apply
   

   Conferma di voler applicare le azioni descritte inserendo yes.

Config Connector

Se hai utilizzato Config Connector per installare Config Sync utilizzando una risorsa GKEHubFeatureMembership, aggiorna questa risorsa per disinstallare Config Sync.

1. Identifica l'oggetto risorsa GKEHubFeatureMembership sul tuo cluster che ha un campo .spec.configmanagement.configSync compilato.

2. Applica una patch all'oggetto risorsa GKEHubFeatureMembership per rimuovere il campo .spec.configmanagement.configSync impostandolo su null:

   kubectl patch GKEHubFeatureMembership FEATURE_MEMBERSHIP_OBJECT_NAME \
       --namespace FEATURE_MEMBERSHIP_OBJECT_NAMESPACE \
       -p '{"spec":{"configmanagement":{"configSync": null}}}'
   

   Sostituisci quanto segue:

   • FEATURE_MEMBERSHIP_OBJECT_NAME: aggiungi il nome dell'oggetto risorsa GKEHubFeatureMembership che hai creato in precedenza.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: aggiungi lo spazio dei nomi che contiene l'oggetto risorsa GKEHubFeatureMembership che hai creato in precedenza.

Disattivare Config Management nel tuo parco risorse

Nota: se vuoi comunque utilizzare Config Management su altri cluster nel parco risorse, puoi saltare questo passaggio, ma non potrai disinstallare l'operatore ConfigManagement finché la funzionalità Config Management non viene disattivata nel parco risorse o il cluster non viene rimosso dal parco risorse.

Console

1. Nella console Google Cloud , vai alla pagina Feature Manager.

   Vai a Gestore funzionalità

2. Nella riga Config Management della tabella Funzionalità, fai clic su Dettagli. Viene visualizzata la pagina Riepilogo stato.

3. Fai clic su Disattiva Config Management. Viene visualizzata una pagina di conferma.

4. Nella pagina di conferma, fai clic su Disattiva Config Management.

gcloud

1. Per disattivare Config Management su tutti i cluster nel parco risorse, esegui questo comando:

   gcloud beta container fleet config-management disable
   

   Nota: i comandi precedenti non interrompono la generazione di report sullo stato. Se vuoi interrompere la generazione di report sullo stato, devi annullare la registrazione del cluster.

Terraform

Se hai utilizzato Terraform per attivare la funzionalità di gestione della configurazione nel tuo parco risorse utilizzando una risorsa google_gke_hub_feature del provider Google Cloud, aggiorna questa risorsa per disattivare la gestione della configurazione in tutti i cluster del parco risorse.

1. Aggiorna il file HCL contenente la risorsa google_gke_hub_feature per rimuovere la risorsa google_gke_hub_feature.

2. Se hai ancora una risorsa gke_hub_feature_membership definita con un campo feature che fa riferimento a google_gke_hub_feature rimosso, rimuovi anche la risorsa gke_hub_feature_membership.

3. Applica la configurazione Terraform:

   terraform apply
   

   Conferma di voler applicare le azioni descritte inserendo yes.

Config Connector

Se hai utilizzato Config Connector per attivare la funzionalità di gestione della configurazione nel tuo parco risorse utilizzando una risorsa GKEHubFeature, aggiorna questa risorsa per disattivare la gestione della configurazione su tutti i cluster del parco risorse.

1. Identifica l'oggetto risorsa GKEHubFeature sul tuo cluster che ha un valore .spec.resourceID di configmanagement.

2. Se hai ancora un oggetto risorsa GKEHubFeatureMembership definito con un campo .spec.featureRef che fa riferimento a quell'oggetto risorsa GKEHubFeature, eliminalo:

   kubectl delete GKEHubFeatureMembership FEATURE_MEMBERSHIP_OBJECT_NAME \
       --namespace FEATURE_MEMBERSHIP_OBJECT_NAMESPACE
   

   Sostituisci quanto segue:

   • FEATURE_MEMBERSHIP_OBJECT_NAME: aggiungi il nome dell'oggetto risorsa GKEHubFeatureMembership che hai creato in precedenza.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: aggiungi lo spazio dei nomi che contiene l'oggetto risorsa GKEHubFeatureMembership che hai creato in precedenza.

3. Elimina la risorsa GKEHubFeature dal cluster:

   kubectl delete GKEHubFeature FEATURE_OBJECT_NAME \
       --namespace FEATURE_OBJECT_NAMESPACE
   

   Sostituisci quanto segue:

   • FEATURE_OBJECT_NAME: aggiungi il nome dell'oggetto risorsa GKEHubFeature che hai creato in precedenza.

   • FEATURE_OBJECT_NAMESPACE: aggiungi lo spazio dei nomi che contiene l'oggetto risorsa GKEHubFeature che hai creato in precedenza.

Nota: la disattivazione della funzionalità Config Management nel tuo parco risorse non disinstalla automaticamente l'operatore ConfigManagement dai cluster del parco risorse. Procedi alla sezione successiva per disinstallare l'operatore ConfigManagement su ogni cluster.

Disinstalla l'operatore ConfigManagement

Utilizza kubectl per eliminare l'operatore ConfigManagement dopo aver disattivato la funzionalità Config Management nel parco risorse o dopo aver annullato la registrazione del cluster dal parco risorse.

Per rimuovere l'operatore ConfigManagement, esegui questi comandi:

1. Elimina l'oggetto ConfigManagement dal cluster:

   kubectl delete configmanagement --all
   

   Dopo aver eseguito questo comando, si verifica quanto segue:

   • Tutti i ClusterRole e i ClusterRoleBinding creati nel cluster dall'operatore ConfigManagement vengono eliminati dal cluster.
   • Vengono eliminate tutte le configurazioni dei controller di ammissione installate da ConfigManagement Operator.
   • I contenuti dello spazio dei nomi config-management-system vengono eliminati, ad eccezione del secret git-creds e, per le versioni di Config Sync a partire dalla 1.9.0, del deployment config-management-operator e del pod config-management-operator. L'operatore ConfigManagement non può funzionare senza lo spazio dei nomi config-management-system. Tutte le CustomResourceDefinitions (CRD) create o modificate dal controller dell'operatore ConfigManagement vengono rimosse dai cluster in cui sono state create o modificate. La CRD necessaria per eseguire ConfigManagement Operator esiste ancora perché, dal punto di vista di Kubernetes, è stata aggiunta dall'utente che ha installato ConfigManagement Operator. Le informazioni sulla rimozione di questi componenti sono trattate nel passaggio successivo.

2. Se devi conservare il segreto git-creds, fallo ora:

   kubectl -n config-management-system get secret git-creds -o yaml
   

3. Elimina lo spazio dei nomi config-management-system:

   kubectl delete ns config-management-system
   

4. Elimina lo spazio dei nomi config-management-monitoring:

   kubectl delete ns config-management-monitoring
   

5. Elimina la CustomResourceDefinition ConfigManagement:

   kubectl delete crd configmanagements.configmanagement.gke.io