Disinstalla Config Sync

Questa pagina spiega come disinstallare Config Sync dal cluster, disabilitare la funzionalità del parco risorse Config Management nel parco risorse e disinstallare l'operatore ConfigManagement.

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

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

1. Disinstallare Config Sync dal cluster
2. Disattivare la funzionalità Config Management nel parco risorse
3. Disinstalla 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: se disinstalli Config Sync verranno eliminati tutti i RootSync e i RepoSync di oggetti Kubernetes sul cluster. Prima di continuare, devi controllare l'eliminazione criteri di propagazione sugli oggetti RootSync e RepoSync. Per maggiori informazioni, consulta la sezione Eliminare più oggetti contemporaneamente.

Console

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

gcloud

1. Apri il manifest applySpec. 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. (obbligatorio solo per i cluster che utilizzano gli upgrade automatici di Config Sync) Nel manifest applySpec, imposta spec.upgrades su auto:

   Nota: il campo spec.upgrades è supportato nella versione 471.0.0 e successive di Google Cloud CLI. Puoi aggiornare Google Cloud CLI alla versione più recente eseguendo il comando gcloud components update.

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

4. 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 che vuoi a cui applicare questa configurazione. Se hai registrato il cluster nella console Google Cloud, il nome dell'appartenenza corrisponde al nome del cluster.

   • CONFIG_YAML: aggiungi il percorso al tuo 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 della piattaforma Google Cloud, aggiorna la risorsa per disinstallare Config Sync.

1. Identifica la risorsa gke_hub_feature_membership in Terraform di configurazione dei file per cui è stato completato un argomento configmanagement.

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.17.0"
     }
   }
   

3. Applica la configurazione Terraform:

   terraform apply
   

   Conferma di voler applicare le azioni descritte inserendo yes.

Config Connector

Se utilizzavi Connettore di configurazione per installare Config Sync utilizzando GKEHubFeatureMembership quindi aggiornala per disinstallare Config Sync.

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

2. Applica la patch all'oggetto risorsa GKEHubFeatureMembership per rimuovere .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 creato in precedenza.

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

Disabilita 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 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 Gestione funzionalità.

   Vai a Gestore funzionalità

2. Nella riga Gestione configurazione 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 disabilitare Config Management in tutti i cluster nel parco risorse, esegui il seguente 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 utilizzando una risorsa google_gke_hub_feature del provider della piattaforma Google Cloud, aggiorna la risorsa per disattivare la gestione della configurazione su tutti i cluster del parco.

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

2. Se hai ancora una risorsa gke_hub_feature_membership definita con un feature campo che fa riferimento al 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à Config Management nel tuo parco risorse utilizzando una risorsa GKEHubFeature, aggiornala per disattivare Config Management su tutti i cluster del parco risorse.

1. Identifica l'oggetto di 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 creato in precedenza.

   • FEATURE_MEMBERSHIP_OBJECT_NAMESPACE: aggiungi lo spazio dei nomi che contiene l'oggetto risorsa GKEHubFeatureMembership 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 creato in precedenza.

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

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

Disinstalla l'operatore ConfigManagement

Utilizza kubectl per eliminare l'operatore ConfigManagement dopo la disattivazione Config Management nel parco risorse o annullare la registrazione del cluster della flotta.

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 verificano le seguenti operazioni:

   • Eventuali ClusterRole e ClusterRoleBinding creati nel cluster L'operatore ConfigManagement viene eliminato dal cluster.
   • Qualsiasi configurazione del controller di ammissione installata L'operatore ConfigManagement è stato eliminato.
   • I contenuti dello spazio dei nomi config-management-system vengono eliminati, con l'eccezione del git-creds segreto e, per le versioni di Config Sync a partire dalla 1.9.0, del config-management-operator deployment e del config-management-operator pod. L'operatore ConfigManagement non può funzionare senza lo spazio dei nomi config-management-system. Qualsiasi CustomResourceDefinitions (CRD) creata o modificata da Gli operatori ConfigManagement vengono rimossi dai cluster in cui in cui sono stati creati o modificati. Il CRD necessario per eseguire ConfigManagement Operator esiste ancora perché dal punto di vista di Kubernetes, sono stati aggiunti dall'utente che ha installato ConfigManagement Operator. Informazioni sulla rimozione di questi componenti è spiegata nel passaggio successivo.

2. Se devi conservare il secret di 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 CustomResourceDefinition ConfigManagement:

   kubectl delete crd configmanagements.configmanagement.gke.io