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 definizione del pacchetto è contenuta in un oggetto RootSync o RepoSync nel 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 eseguire 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 su cluster diversi. Puoi modificare un pacchetto dopo averlo disegnato, 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 tipo di origine e poi fai clic su Continua.

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

  6. Nel campo Tipo di sincronizzazione, scegli Sincronizzazione basata sul cluster o Sincronizzazione basata sullo spazio dei nomi come 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 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, inserisci i seguenti campi:

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

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

    1. Seleziona un Tipo di autenticazione. Config Sync ha bisogno di accesso in sola lettura alla fonte attendibile per leggere i file di configurazione al suo interno e applicarli ai cluster. A meno che l'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 gcloud CLI). Scegli lo stesso tipo di autenticazione configurato durante l'installazione di Config Sync:

      • Nessuna: non utilizzare l'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.
      • 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 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 della sincronizzazione, che determina il tempo di attesa di Config Sync tra i tentativi di estrazione dalla fonte di riferimento.

    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 Esegui il deployment del pacchetto.

    Ti reindirizzeremo alla 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