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 gestiti in una fonte attendibile e sincronizzati con un cluster da Config Sync. Ogni definizione del pacchetto è contenuta in un oggetto RootSync o RepoSync sul cluster. Per informazioni più dettagliate sugli oggetti RootSync e RepoSync, consulta Architettura di Config Sync.

Prima di iniziare

• Installa Config Sync.

Deployment di un pacchetto

Dopo aver registrato i cluster in un parco risorse e 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 eseguire il deployment di pacchetti diversi in cluster diversi. Puoi modificare un pacchetto dopo aver eseguito il deployment, ad eccezione di alcune impostazioni come il nome del pacchetto e il tipo di sincronizzazione. Per maggiori informazioni, consulta Gestire i 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 i cluster per il deployment del pacchetto, 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 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 di spazio dei nomi come tipo di sincronizzazione.

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

7. Nella sezione Origine, completa i seguenti campi:

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

     1. Inserisci l'URL del repository Git che stai utilizzando come fonte attendibile come URL repository.
     2. (Facoltativo) Aggiorna il campo Revisione per verificare se non stai utilizzando 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, inserisci 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 radice, come Directory.

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

   1. Seleziona un Tipo di autenticazione. Config Sync ha bisogno dell'accesso di sola lettura all'origine 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 di sola lettura al tuo repository Git, all'immagine OCI o al grafico Helm (solo a gcloud CLI). Scegli lo stesso tipo di autenticazione che hai configurato quando hai installato Config Sync:

      Nota: per OCI, puoi selezionare solo Workload Identity per l'autenticazione.
      • Nessuna: non utilizzare alcuna autenticazione.
      • SSH: esegui l'autenticazione utilizzando 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 tuo 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 di pull dalla fonte attendibile.

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

   4. Scegli Gerarchia per modificare il Formato di origine.

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

9. Fai clic su Esegui il deployment del pacchetto.

   Verrai reindirizzato alla pagina Pacchetti di Config Sync. Dopo alcuni minuti, verrà visualizzato il messaggio 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 il pacchetto che vuoi modificare.

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

4. Rivedi 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 del pacchetto. 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 che contiene il nome del cluster, fai clic sul menu contestuale , quindi 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
• Risolvere i problemi di Config Sync