Utilizzare la dashboard di Config Sync

Questa pagina spiega come utilizzare la dashboard di Config Sync.

Questa dashboard fornisce una panoramica completa dei pacchetti Config Sync gestisce e lo stato delle risorse in questi pacchetti.

Termine chiave: un pacchetto contiene tutte le configurazioni contenute in ogni fonte attendibile. Poiché puoi sincronizzare il cluster da più origini, potresti avere più pacchetti per cluster.

Prima di iniziare

Autorizzazioni IAM

Per accedere alla dashboard di Config Sync, sono richiesti i seguenti ruoli IAM in del progetto:

• roles/container.clusterViewer
• roles/gkehub.viewer

Controllo dell'accesso basato sui ruoli

Inoltre, l'utente deve disporre delle autorizzazioni Kubernetes pertinenti in ogni cluster. Se non vuoi concedere agli utenti autorizzazioni estese, come quelle del cluster puoi creare un ruolo RBAC personalizzato che includa le autorizzazioni minime per utilizzare la dashboard di Config Sync.

config-sync-dashboard-reader ClusterRole concede all'utente le autorizzazioni get e list per le risorse necessarie per la dashboard.

1. Per creare il config-sync-dashboard-reader ClusterRole e applicarlo al cluster, esegui il seguente comando:

   cat <<EOF > config-sync-dashboard-reader.yaml
   kind: ClusterRole
   apiVersion: rbac.authorization.k8s.io/v1
   metadata:
     name: config-sync-dashboard-reader
   rules:
   - apiGroups: ["apiextensions.k8s.io"]
     resources: ["customresourcedefinitions"]
     verbs: ["get", "list"]
   - apiGroups: ["configmanagement.gke.io"]
     resources: ["configmanagements"]
     verbs: ["get", "list"]
   - apiGroups: ["configsync.gke.io"]
     resources: ["rootsyncs", "reposyncs"]
     verbs: ["get", "list"]
   - apiGroups: ["kpt.dev"]
     resources: ["resourcegroups"]
     verbs: ["get", "list"]
   - apiGroups: ["apps"]
     resources: ["deployments"]
     verbs: ["get", "list"]
   - apiGroups: [""]
     resources: ["pods", "services"]
     verbs: ["get", "list"]
   - apiGroups: ["anthos.cloud.google.com"]
     resources: ["canonicalservices"]
     verbs: ["get", "list"]
   - apiGroups: ["networking.istio.io"]
     resources: ["virtualservices"]
     verbs: ["get", "list"]
   
   EOF
   kubectl apply -f config-sync-dashboard-reader.yaml
   

2. Segui le istruzioni per configurare il controllo dell'accesso basato sui ruoli sui cluster Google Kubernetes Engine (GKE) Enterprise per configurare ClusterRoleBinding.

Accedere alla dashboard

1. Nella console Google Cloud, vai alla pagina Configurazione nella sezione Funzionalità.

   Vai a Config

2. Seleziona il progetto che vuoi visualizzare.

Visualizzare la dashboard

La scheda Dashboard fornisce una panoramica dello stato del tuo Installazioni di Config Sync:

• Stato riconciliazione indica il numero di pacchetti riconciliati. R viene riconciliato se lo stato desiderato, come espresso di risorse nel pacchetto.

  I pacchetti possono avere i seguenti stati di riconciliazione:

  • Attuale: lo stato effettivo del pacchetto corrisponde a quello che preferisci. Il processo di riconciliazione è considerato completo finché non vengono apportate modifiche allo stato desiderato o a quello effettivo.
  • In corso: lo stato effettivo del pacchetto non ha ancora raggiunto lo stato che vuoi (come espresso dalle risorse nel pacchetto). In genere, i pacchetti appena creati iniziano con questo stato.
  • Non riuscita: il processo di riconciliazione dello stato effettivo con lo stato. desiderato ha riscontrato un errore o non è sufficiente progressi.
  • Sconosciuto: Config Sync non è stato in grado di determinare lo stato della riconciliazione di un pacchetto.

• Lo stato di sincronizzazione indica quanti pacchetti sono sincronizzati. Un pacchetto viene sincronizzato quando il più recente stato osservato del pacchetto nell'origine (ad esempio un repository Git) viene riportato nel cluster.

  I pacchetti possono avere i seguenti stati di sincronizzazione:

  • Sincronizzato: il pacchetto viene sincronizzato con un cluster.
  • In attesa: il pacchetto è in attesa di sincronizzazione.
  • Riconciliazione: il deployment che sincronizza un pacchetto è in fase di riconciliato.
  • In pausa: il deployment che sincronizza un pacchetto è in pausa.
  • Errore: il pacchetto ha riscontrato un errore durante la sincronizzazione.
  • Sconosciuto: Config Sync non è riuscito a determinare la sincronizzazione lo stato di un pacchetto.

• Lo stato di Config Sync mostra lo stato di installazione di Config Sync sui tuoi cluster.

  I tuoi cluster possono avere il seguente stato relativo a Config Sync:

  • Abilitato: cluster in cui è abilitato Config Sync.
  • Non abilitato: i cluster per cui Config Sync non è abilitato.
  • In attesa: cluster in cui Config Sync è abilitato, ma che stanno subendo modifiche. Questo stato si verifica in genere durante la prima configurazione o l'aggiornamento a una nuova versione.
  • Errore: cluster in cui Config Sync è abilitato, ma si è verificato un problema e Config Sync non funziona.
  • Sconosciuto: non è possibile determinare lo stato di Config Sync.

Le tabelle aggiuntive mostrano i problemi raggruppati per pacchetto e cluster e forniscono i link per installare Config Sync e visualizzare impostazioni e risorse per iniziare.

Visualizza lo stato del pacchetto

La scheda Pacchetti consente di visualizzare dettagli approfonditi su singoli di pacchetti e cluster. Utilizza questa scheda per comprendere meglio le potenziali cause degli errori di sincronizzazione e delle risorse non sicure.

Modifica un pacchetto

È possibile utilizzare la scheda Pacchetti anche per modificare le configurazioni dei pacchetti.

Nota: non puoi modificare i pacchetti gestiti dall'hub in questo modo. Per abilitare la modifica in nella console Google Cloud, segui i passaggi descritti in Eseguire la migrazione di RootSync.

Per modificare un pacchetto:

1. Accanto al nome del pacchetto da modificare, seleziona nella colonna Modifica pacchetto
2. Nella sezione Dettagli pacchetto, seleziona il tipo di origine dall'elenco a discesa Tipo di origine.

3. Nella sezione Origine, completa quanto segue:

   • Per le origini ospitate in un repository Git, inserisci i seguenti campi:

     1. Inserisci l'URL del repository Git che utilizzi come fonte attendibile come URL del repository.
     2. (Facoltativo) Aggiorna il campo Revisione per verificare se non utilizzi il valore predefinito HEAD.
     3. (Facoltativo) Aggiorna il campo Percorso se non vuoi eseguire la sincronizzazione dal repository principale.
     4. (Facoltativo) Aggiorna il campo Ramo se non utilizzi il ramo predefinito main.

   • Per le origini ospitate in un'immagine OCI, compila i seguenti campi:

     1. Inserisci l'URL dell'immagine OCI che stai utilizzando come fonte attendibile come Immagine.
     2. Inserisci il percorso della directory da cui eseguire la sincronizzazione, rispetto alla directory principale, come Directory.

4. (Facoltativo) Espandi la sezione Impostazioni avanzate per completare quanto segue:

   1. Seleziona un Tipo di autenticazione:

      Nota: per OCI, puoi selezionare solo Workload Identity per l'autenticazione.
      • Nessuna: non viene utilizzata l'autenticazione.
      • SSH: utilizza una coppia di chiavi SSH.
      • Cookiefile: utilizza un cookiefile.
      • Token: utilizza un token.
      • Repository Google Cloud: utilizza un account di servizio Google per accedere a un repository Cloud Source Repositories. Seleziona questa opzione solo se La federazione delle identità per i carichi di lavoro per GKE non è abilitata nel cluster.
      • Identità carico di lavoro: utilizza un account di servizio Google per accedere a un il repository Cloud Source Repositories.

   2. Inserisci un numero in secondi per impostare il Tempo di attesa sincronizzazione, che determina il tempo di attesa di Config Sync tra la sincronizzazione dalla fonte attendibile.

   3. Inserisci un URL di proxy Git per il proxy HTTPS da utilizzare per la comunicazione con la fonte di verità.

   4. Scegli Gerarchia per modificare il Formato dell'origine.

      Il valore predefinito Non strutturato è consigliato nella maggior parte dei casi poiché consente di organizzare la fonte di riferimento come si desidera.

5. Al termine della modifica del pacchetto, fai clic su Salva.

   Si aprirà la pagina Pacchetti di Config Sync. Dopo alcuni minuti, dovrebbe essere visualizzato il messaggio Sincronizzato in Stato sincronizzazione per il pacchetto configurato.

Visualizza impostazioni

La scheda Impostazioni mostra un elenco di cluster, insieme alle informazioni sulle impostazioni di Config Sync e del parco risorse.

Puoi anche utilizzare questa scheda per eseguire l'upgrade di Config Sync su un cluster:

• Accanto al nome del cluster di cui vuoi eseguire l'upgrade, seleziona il contesto Menu e poi seleziona Modifica configurazione.

Per indicazioni sulle impostazioni di Config Sync, vedi Configurare Config Sync.

Passaggi successivi

• Scopri come utilizzare Google Cloud CLI per monitorare Config Sync.
• Scopri come utilizzare lo strumento a riga di comando nomos per monitorare Config Sync.
• Scopri come monitorare Config Sync con metriche.