Gestisci pacchetti

Questa pagina spiega come gestire i pacchetti con Config Sync dalla console Google Cloud.

Un pacchetto è un insieme di manifest degli oggetti delle risorse Kubernetes che vengono gestiti in una fonte attendibile e sincronizzati in un cluster da Config Sync. Ogni definizione del pacchetto è contenuta in un oggetto RootSync o RepoSync nel cluster. Per informazioni più dettagliate sugli oggetti RootSync e RepoSync, consulta l'architettura di Config Sync.

Prima di iniziare

• Installa Config Sync.

Deployment di un pacchetto

Dopo aver registrato i cluster in un parco risorse e aver installato Config Sync, puoi configurare Config Sync per il deployment di un pacchetto in un cluster da una fonte attendibile. Puoi eseguire il deployment dello stesso pacchetto su più cluster o di pacchetti diversi in cluster diversi. Puoi modificare un pacchetto dopo averlo distribuito, ad eccezione di alcune impostazioni come nome del pacchetto e tipo di sincronizzazione. Per ulteriori informazioni, consulta la sezione Gestione dei pacchetti.

Nota: se vuoi che Config Sync esegua il rendering e applichi un grafico Helm, devi configurare Config Sync con Google Cloud CLI.

Per eseguire il deployment di un pacchetto, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla dashboard di Config Sync.

   Vai alla dashboard di Config Sync

2. Fai clic su Esegui il deployment del pacchetto.

3. Nella tabella Seleziona cluster per il deployment dei pacchetti, seleziona il cluster in cui vuoi eseguire il deployment di un pacchetto, quindi fai clic su Continua.

4. Seleziona Pacchetto ospitato su Git o Pacchetto ospitato su OCI come tipo di origine, quindi fai clic su Continua.

5. Nella sezione Dettagli del pacchetto, inserisci un Nome pacchetto, che identifica l'oggetto RootSync o RepoSync.

6. Nel campo Tipo di sincronizzazione, scegli Sincronizzazione con ambito cluster o Sincronizzazione con ambito spazio dei nomi come tipo di sincronizzazione.

   La sincronizzazione con ambito cluster crea un oggetto RootSync, mentre la sincronizzazione con ambito spazio dei nomi crea un oggetto RepoSync. Per ulteriori informazioni su questi oggetti, consulta Architettura di Config Sync.

7. Nella sezione Origine, completa i seguenti passaggi:

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

     1. Inserisci come fonte attendibile l'URL del repository Git che stai utilizzando come URL del repository.
     2. (Facoltativo) Aggiorna il campo Revisione per verificare se non utilizzi il valore predefinito di 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 main predefinito.

   • 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 relativo alla directory principale in Directory.

8. (Facoltativo) Espandi la sezione Impostazioni avanzate per completare le seguenti operazioni:

   1. Seleziona un Tipo di autenticazione. Config Sync ha bisogno dell'accesso di sola lettura alla tua fonte attendibile per leggere i file di configurazione nell'origine e applicarli ai cluster. A meno che la tua origine non richieda l'autenticazione, ad esempio un repository pubblico, assicurati di concedere a Config Sync l'accesso in sola lettura al repository Git, all'immagine OCI o al grafico Helm (solo gcloud CLI). Scegli lo stesso tipo di autenticazione che hai configurato durante l'installazione di Config Sync:

      Nota: per OCI, puoi selezionare solo Workload Identity per l'autenticazione.
      • Nessuna: non viene utilizzata l'autenticazione.
      • SSH: esegui l'autenticazione mediante una coppia di chiavi SSH.
      • Cookiefile: esegui l'autenticazione utilizzando un cookiefile.
      • Token: esegui l'autenticazione utilizzando un token di accesso o una password.
      • Google Cloud Repository: utilizza un account di servizio Google per accedere a un repository Cloud Source Repositories. Seleziona questa opzione solo se Workload Identity non è abilitato nel cluster.
      • Workload Identity: utilizza un account di servizio Google per accedere a un repository Cloud Source Repositories.

   2. Inserisci un numero in secondi per impostare il Tempo di attesa per la sincronizzazione, che determina il tempo di attesa di Config Sync tra un tentativo e l'altro di eseguire il pull dalla fonte attendibile.

   3. Inserisci un URL del proxy Git per il proxy HTTPS da utilizzare durante le comunicazioni con la fonte attendibile.

   4. Scegli Gerarchia per modificare il Formato di origine.

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

9. Fai clic su Esegui il deployment del pacchetto.

   Si aprirà la pagina Pacchetti di Config Sync. Dopo alcuni minuti, dovresti vedere Sincronizzato nella colonna Stato sincronizzazione per il cluster che hai configurato.

Modifica un pacchetto

Per modificare un pacchetto di cui hai già eseguito il deployment, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla scheda Pacchetti di Config Sync.

   Vai a Pacchetti

2. (Facoltativo) Espandi il menu Filtri rapidi, quindi seleziona un filtro per trovare più facilmente il pacchetto da modificare.

3. Espandi il nome del pacchetto da modificare, quindi, nella riga contenente il nome del cluster, fai clic sul menu contestuale e poi su Modifica pacchetto.

4. Controlla e aggiorna le impostazioni del pacchetto che vuoi modificare.

5. Fai clic su Salva.

Disinstallare un pacchetto

Nota: la console Google Cloud utilizza la funzionalità di propagazione dell'eliminazione per eliminare le risorse dei pacchetti. Se non gestisci gli oggetti RootSync e RepoSync con la console Google Cloud, puoi comunque utilizzare la funzionalità di propagazione dell'eliminazione per ottenere un comportamento di disinstallazione simile, con kubectl o qualsiasi altro client Kubernetes. Per maggiori informazioni, consulta Eliminare gli oggetti in blocco (Anteprima).

Per disinstallare un pacchetto dalla console Google Cloud, completa i seguenti passaggi:

1. Nella console Google Cloud, vai alla scheda Pacchetti di Config Sync.

   Vai a Pacchetti

2. (Facoltativo) Espandi il menu Filtri rapidi, quindi seleziona un filtro per trovare il pacchetto che vuoi disinstallare.

3. Espandi il nome del pacchetto che vuoi disinstallare e, nella riga contenente il nome del cluster, fai clic sul menu contestuale e poi su Disinstalla pacchetto.

4. Nella finestra di dialogo di conferma, scegli se disinstallare solo l'oggetto RootSync o RepoSync oppure disinstallare RootSync o RepoSync e tutte le risorse gestite da RootSync o RepoSync.

5. Digita il messaggio di conferma e fai clic su Disinstalla.

Passaggi successivi

• Monitorare lo stato di Config Sync e dei pacchetti
• Utilizza lo strumento a riga di comando nomos
• Risolvi i problemi di Config Sync