Gestire i 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 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

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 saperne di più, consulta Gestire i pacchetti.

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 su cui vuoi eseguire il deployment di un pacchetto e poi 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 basata sul cluster crea un oggetto RootSync e la sincronizzazione basata sullo spazio dei nomi crea un oggetto RepoSync. Per ulteriori informazioni su questi oggetti, consulta la 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 utilizzi 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 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 radice, come Directory.

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

    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 configurato durante l'installazione di Config Sync:

      • 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.
      • 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.
      • 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 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 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 l'origine attendibile come preferisci.

  9. Fai clic su Deploy Package (Esegui il deployment del pacchetto).

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

Modifica un pacchetto

Per modificare un pacchetto già di cui è stato eseguito il deployment:

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

    Vai a Pacchetti

  2. (Facoltativo) Espandi il menu Filtri rapidi e seleziona un filtro per aiutarti a trovare il pacchetto che vuoi modificare.

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

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

  5. Fai clic su Salva.

Disinstallare un pacchetto

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 e seleziona un filtro per aiutarti a 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 , 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