Configurazione dei deployment automatizzati

Puoi configurare deployment automatizzati per i tuoi carichi di lavoro su Google Kubernetes Engine (GKE).

Questa pagina mostra come configurare una semplice pipeline di integrazione continua/distribuzione continua (CI/CD) per il carico di lavoro. Quando esegui il push di una modifica nel repository, Cloud Build crea ed esegue il deployment del container nel tuo cluster GKE.

Come funziona un deployment automatico

Se hai un carico di lavoro che fa riferimento a un'immagine a un singolo container in GKE, puoi configurare un deployment automatizzato, in modo che l'applicazione venga ricreata e sottoposta a deployment ogni volta che una modifica del codice viene registrata nel repository.

Con un deployment automatico, definisci il tuo carico di lavoro come file YAML e archivi quel file YAML nel tuo repository (in linea con le best practice). GKE genera un YAML che puoi utilizzare a questo scopo.

Per utilizzare i file YAML, hai a disposizione due opzioni:

  • Se non hai ancora un file YAML che definisce il tuo carico di lavoro, puoi utilizzare il file YAML generato. Salva il file YAML nel tuo repository. Cloud Build lo utilizza ogni volta per eseguire il deployment del tuo carico di lavoro.

  • Se hai già un file YAML che definisce il tuo carico di lavoro, puoi puntare GKE alla sua posizione nel repository. Puoi confrontare il file YAML nel tuo repository con il file YAML consigliato per assicurarti di eseguire il deployment del carico di lavoro corretto nel modo corretto.

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti attività:

  • Abilita l'API Google Kubernetes Engine.
    • Abilita l'API Google Kubernetes Engine
  • Se vuoi utilizzare Google Cloud CLI per questa attività, installa e initialize gcloud CLI. Se hai già installato gcloud CLI, scarica la versione più recente eseguendo gcloud components update.

Requisiti

I deployment automatici hanno i seguenti requisiti:

  • Puoi utilizzare un deployment automatico solo con carichi di lavoro di tipo Deployment che specificano una singola immagine container. I carichi di lavoro multi-container e altri tipi di carichi di lavoro (ad esempio, ReplicaSet) non sono supportati.

  • Il repository del codice sorgente deve contenere un Dockerfile per creare l'immagine.

    Puoi ospitare questo repository su uno dei seguenti prodotti:

    Se utilizzi GitHub o Bitbucket, devi concedere a Google Cloud l'accesso al tuo repository.

  • Archivia l'immagine container in Artifact Registry, nello stesso progetto Google Cloud del tuo cluster GKE. Devi avere l'immagine in Artifact Registry, di cui devi aver eseguito il deployment almeno una volta, in modo da avere un carico di lavoro in GKE.

Creazione del deployment automatico

Per creare un deployment automatico, segui questi passaggi:

  1. Vai alla pagina Carichi di lavoro nella console Google Cloud.

    Vai a Carichi di lavoro

  2. Nell'elenco dei carichi di lavoro, fai clic sul nome del deployment da modificare.

  3. Fai clic su Azioni > Deployment automatico.

Nel riquadro Automatizza il deployment, segui questi passaggi:

  1. In Repository di codice sorgente, scegli il repository del codice sorgente:

    1. Nell'elenco a discesa Provider di repository, scegli il provider per il tuo repository

      Un deployment automatico supporta i seguenti host di controllo del codice sorgente:

      • Cloud Source Repositories
      • GitHub

      • Bitbucket

        Se utilizzi GitHub o Bitbucket, autentica con il tuo nome utente e la tua password.

    2. Dall'elenco a discesa Repository, seleziona il nome del repository contenente il codice sorgente del tuo deployment.

    3. Fai clic su Continua.

  2. In Configurazioni build, specifica le informazioni sulla configurazione build:

    1. Inserisci il nome del ramo da cui vuoi creare o un'espressione regolare (RegExp2) per trovare una corrispondenza con il ramo o i rami. Il ramo predefinito è master. Quando esegui il push a questo ramo, Cloud Build crea la tua applicazione.
    2. Inserisci il percorso relativo della directory Dockerfile.

    3. Inserisci il Nome Dockerfile.

    4. Fai clic su Continua.

  3. In Configurazione deployment automatico, specifica la posizione del file YAML di configurazione.

    Il sistema genera automaticamente un file YAML che puoi usare per compilare il file YAML nel tuo repository.

    1. Fai clic su Visualizza YAML consigliato da Google per visualizzare il file YAML generato.

    2. Confrontalo con il tuo file YAML, se ce l'hai, e aggiorna il tuo in base a questo.

      In caso contrario, crea un nuovo file e completalo con il codice YAML generato. Ciò contribuisce a garantire che il carico di lavoro di cui viene eseguito il deployment corrisponda a quello attualmente in esecuzione. Il file può avere qualsiasi nome, ma deve avere un'estensione .yaml o .yml.

    3. Specifica il percorso relativo alla directory che contiene il file YAML.

      Se nella directory specificata è presente più di un file YAML, GKE li utilizza tutti.

  4. Fai clic su Configura per completare la configurazione del deployment automatico.

    È possibile che ti venga richiesto di concedere le autorizzazioni all'account di servizio Cloud Build. Questa autorizzazione è obbligatoria.

Fasi successive

Dopo aver configurato il deployment automatico per il carico di lavoro selezionato, viene visualizzato un trigger di Cloud Build che crea un'immagine container dopo il push al ramo selezionato del repository. Cloud Build esegue inoltre il deployment di una nuova revisione del carico di lavoro nel cluster in cui è stato eseguito il deployment dell'immagine originale.

Per ulteriori informazioni sul carico di lavoro, consulta la pagina Dettagli deployment (scheda Cronologia delle revisioni).