Gestisci pacchetti

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

Un pacchetto è un insieme di manifest degli oggetti di risorse Kubernetes gestiti in una fonte attendibile che viene sincronizzata con un cluster da Config Sync. Ogni pacchetto è contenuta in un oggetto RootSync o RepoSync sul cluster. Per informazioni più dettagliate sugli oggetti RootSync e RepoSync, vedi 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 o eseguire il deployment di pacchetti diversi in cluster diversi. Puoi modificare un pacchetto dopo il deployment, ad eccezione di alcune impostazioni come il nome del pacchetto e il tipo di sincronizzazione. Per ulteriori informazioni, vedi 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 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 seleziona il tipo di origine e fai clic su Continua.

5. Nella sezione Dettagli pacchetto, inserisci un Nome pacchetto, 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 il 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 l'URL del repository Git che stai utilizzando come fonte attendibile 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 il repository principale.
     4. (Facoltativo) Aggiorna il campo Ramo se non utilizzi il valore predefinito Ramo 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 radice, come Directory.

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

   1. Seleziona un Tipo di autenticazione. Config Sync richiede l'accesso di sola lettura a la 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 di sola lettura al tuo repository Git Immagine OCI o grafico Helm (solo gcloud CLI). Scegli lo stesso tipo di autenticazione che hai configurato durante l'installazione 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 il repository Cloud Source Repositories. Seleziona questa opzione solo se Workload Identity non è abilitato nel tuo 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 tempo che Config Sync attende tra un tentativo e l'altro per eseguire il pull dalla fonte attendibile.

   3. Inserisci un URL del proxy Git per il proxy HTTPS da utilizzare quando comunicando con la fonte dei dati.

   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 si desidera.

9. Fai clic su Esegui il deployment del pacchetto.

   Si aprirà la pagina Pacchetti di Config Sync. Dopo alcune minuti, dovresti vedere Sincronizzato in 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 per trovare il pacchetto che desideri modificare.

3. Espandi il nome del pacchetto da modificare, quindi, nella riga che contiene sul nome del cluster, fai clic sul menu contestuale e poi fai clic 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 delle risorse del pacchetto. Se non gestisci gli oggetti RootSync e RepoSync con nella console Google Cloud, puoi comunque utilizzare la funzionalità di propagazione dell'eliminazione per ottenere un comportamento di disinstallazione simile, con kubectl o qualsiasi altro di alto profilo. Per ulteriori informazioni, vedi 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 aiuta a trovare il pacchetto che vuoi disinstallare.

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

4. Nella finestra di dialogo di conferma, scegli se disinstallare solo l'oggetto RootSync o RepoSync, oppure disinstalla RootSync o RepoSync e tutte le risorse gestite 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