Deployment in GKE

Questa pagina spiega come eseguire il deployment di un'applicazione in Kubernetes utilizzando Cloud Build.

Cloud Build fornisce un builder gke-deploy che ti consente di eseguire il deployment di un'applicazione containerizzata in un cluster GKE.

gke-deploy è un wrapper di kubectl, l'interfaccia a riga di comando per Kubernetes. Applica le pratiche consigliate di Google per il deployment delle applicazioni in Kubernetes:

• Aggiornamento del file di risorse Kubernetes dell'applicazione per utilizzare il digest dell'immagine container anziché un tag.

• Aggiunta di etichette consigliate al file di risorse Kubernetes.

• Recupero delle credenziali per i cluster GKE in cui esegui il deployment dell'immagine.

• In attesa che il file di risorse Kubernetes inviato sia pronto.

Se vuoi eseguire il deployment delle tue applicazioni utilizzando direttamente kubectl e non hai bisogno di funzionalità aggiuntive, Cloud Build fornisce anche un builder kubectl che puoi utilizzare per eseguire il deployment della tua applicazione in un cluster GKE.

Prima di iniziare

• Crea un cluster GKE, se non ne hai ancora uno.

• Avere l'applicazione containerizzata sotto forma di codice sorgente e un Dockerfile pronto. Il codice sorgente deve essere archiviato in un repository, ad esempio Cloud Source Repositories, GitHub o Bitbucket.

• Avrai bisogno di almeno un file di risorse Kubernetes che descriva le risorse Kubernetes utilizzate per eseguire l'applicazione. Se non hai file di risorse Kubernetes, segui questi passaggi per generarne uno per la tua applicazione:

  1. Apri la pagina dei cluster di Kubernetes Engine nella console Google Cloud .
  2. Nella pagina dei cluster Kubernetes Engine, fai clic su Esegui il deployment.
  3. Seleziona il contenitore e fai clic su Continua. Vedrai la sezione Configurazione.
  4. In YAML configurazione, fai clic su Visualizza YAML per ottenere un file di risorse Kubernetes di esempio.
  Nota: se hai già un altro tipo di file di risorse Kubernetes basato su modelli, ad esempio un grafico Helm o una risorsa in formato Kustomize, consulta Helm Builder o Kustomize Builder per esempi di configurazioni di build che puoi utilizzare per il deployment.

Attenzione:a partire dal 17 giugno 2024, Cloud Source Repositories non è disponibile per i nuovi clienti. Se la tua organizzazione non ha mai utilizzato Cloud Source Repositories, non puoi abilitare l'API o utilizzare Cloud Source Repositories. I nuovi progetti non collegati a un'organizzazione non possono abilitare l'API Cloud Source Repositories. Le organizzazioni che hanno utilizzato Cloud Source Repositories prima del 17 giugno 2024 non sono interessate da questa modifica.

Autorizzazioni IAM obbligatorie

Aggiungi il ruolo Sviluppatore Google Kubernetes Engine al tuo account:

1. Nella console Google Cloud , vai alla pagina Autorizzazioni di Cloud Build:

   Vai ad Autorizzazioni

2. Imposta lo stato del ruolo Sviluppatore Kubernetes Engine su Attivato.

Deployment di un'immagine container predefinita

Per eseguire il deployment di una versione specifica dell'applicazione con gke-deploy:

1. Assicurati che il file di risorse Kubernetes faccia riferimento al tag o al digest dell'immagine container corretti.

2. Aggiungi il passaggio gke-deploy al file di configurazione della build:

   YAML

   steps:
   ...
   # deploy container image to GKE
   - name: "gcr.io/cloud-builders/gke-deploy"
     args:
     - run
     - --filename=KUBERNETES_RESOURCE_FILE
     - --location=CLUSTER_LOCATION
     - --cluster=CLUSTER
   

   JSON

   {
     "steps": [
       {
         "name": "gcr.io/cloud-builders/gke-deploy",
         "args": [
           "run",
           "--filename=KUBERNETES_RESOURCE_FILE",
           "--location=CLUSTER_LOCATION",
           "--cluster=CLUSTER"
         ]
       }
     ]
   }
   

   Dove:

   • KUBERNETES_RESOURCE_FILE è il percorso del file di risorse Kubernetes o il percorso della directory contenente i file di risorse Kubernetes.
   • CLUSTER_LOCATION è la regione del cluster.
   • CLUSTER è il nome del cluster GKE in cui verrà eseguito il deployment dell'applicazione.

   Per saperne di più sui flag disponibili, vedi Flag gke-deploy run.

   Nota: quando esegui il deployment su più cluster GKE, Cloud Build mantiene la directory home nei passaggi di build, il che significa che il contesto kubectl del passaggio precedente viene utilizzato per impostazione predefinita dai passaggi successivi. Per evitare questo problema, aggiungi una dichiarazione di variabile di ambiente, KUBECONFIG=/tmp/kubeconfig, a ogni passaggio del file di configurazione della build.

3. Avvia la build:

   gcloud builds submit --region=LOCATION --project=PROJECT --config BUILD_CONFIG
   

   Dove:

   • LOCATION è una delle località di build supportate.
   • PROJECT è l'ID del tuo progetto.
   • BUILD_CONFIG è il nome del file di configurazione della build.

Creazione e deployment di una nuova immagine container

Per creare una nuova immagine container ed eseguirne il deployment:

1. Aggiorna il file di risorse Kubernetes con la nuova immagine container utilizzando l'attributo --image:

   YAML

   steps:
     # build the container image
   - name: "gcr.io/cloud-builders/docker"
     args: ["build", "-t", "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG", "."]
     # push container image
   - name: "gcr.io/cloud-builders/docker"
     args: ["push", "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG"]
     # deploy container image to GKE
   - name: "gcr.io/cloud-builders/gke-deploy"
     args:
     - run
     - --filename=KUBERNETES_RESOURCE_FILE
     - --image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG
     - --location=CLUSTER_LOCATION
     - --cluster=CLUSTER
   

   JSON

   {
     "steps": [
       {
         "name": "gcr.io/cloud-builders/docker",
         "args": [
           "build",
           "-t",
           "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
           "."
         ]
       },
       {
         "name": "gcr.io/cloud-builders/docker",
         "args": [
           "push",
           "LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG"
         ]
       },
       {
         "name": "gcr.io/cloud-builders/gke-deploy",
         "args": [
           "run",
           "--filename=KUBERNETES_RESOURCE_FILE",
           "--image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
           "--location=CLUSTER_LOCATION",
           "--cluster=CLUSTER"
         ]
       }
     ]
   }
   

   Dove:

   • LOCATION è una delle località di compilazione supportate.
   • PROJECT è l'ID del tuo progetto.
   • IMAGE_NAME è il nome che vuoi assegnare all'immagine del container, in genere il nome dell'applicazione.
   • TAG è il tag dell'immagine container.
     • Se crei una nuova immagine container a ogni commit, una buona pratica è utilizzare lo SHA breve del commit come tag. Cloud Build lo rende disponibile come sostituzione predefinita, $SHORT_SHA.
   • KUBERNETES_RESOURCE_FILE è il percorso del file di risorse Kubernetes o il percorso della directory contenente i file di risorse Kubernetes.
   • CLUSTER è il nome del cluster GKE in cui verrà eseguito il deployment dell'applicazione.
   • CLUSTER_LOCATION è la regione in cui verrà eseguito il deployment del cluster.
   Nota: gke-deploy può fare riferimento a una sola immagine nel file di configurazione della build. Se i file di risorse Kubernetes contengono più riferimenti alle immagini, solo le immagini che iniziano con LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG verranno aggiornate in modo da fare riferimento al tag specificato.

2. Avvia la build:

   gcloud builds submit --region=LOCATION --project=PROJECT --config BUILD_CONFIG
   

   Dove:

   • LOCATION è una delle regioni di build supportate.
   • PROJECT è l'ID del tuo progetto.
   • BUILD_CONFIG è il nome del file di configurazione della build.

Automatizzare i deployment

Puoi automatizzare il deployment della tua applicazione su GKE creando un trigger in Cloud Build. Puoi configurare i trigger per creare e distribuire immagini ogni volta che esegui il push delle modifiche al codice.

Per creare un trigger di build:

1. Apri la pagina Trigger nella console Google Cloud :

   Apri la pagina Trigger

2. Seleziona il tuo progetto dal menu a discesa del selettore di progetti nella parte superiore della pagina.

3. Fai clic su Apri.

4. Fai clic su Crea trigger.

   Nella pagina Crea trigger, inserisci le seguenti impostazioni:

   1. Inserisci un nome per l'attivatore.

   2. Seleziona l'evento del repository per avviare il trigger.

   3. Seleziona il repository che contiene il codice sorgente e il file di configurazione della build.

   4. Specifica l'espressione regolare per il nome del ramo o del tag che avvierà il trigger.

   5. Scegli una configurazione per il trigger.

      Se scegli un file di configurazione Cloud Build, puoi specificare le variabili di sostituzione fornendo un nome di variabile e il valore che vuoi associare a quella variabile. Nell'esempio seguente, la variabile di sostituzione definita dall'utente _CLOUDSDK_CONTAINER_CLUSTER specifica il cluster di cui eseguire il deployment e la variabile di sostituzione definita dall'utente _CLOUDSDK_COMPUTE_ZONE ne specifica la posizione. Se vuoi eseguire il deployment in un cluster diverso, puoi utilizzare la stessa configurazione di build e devi solo modificare i valori delle variabili di sostituzione:

      YAML

      steps:
      ...
      # deploy container image to GKE
      - name: "gcr.io/cloud-builders/gke-deploy"
        args:
        - run
        - --filename=KUBERNETES_RESOURCE_FILE
        - --image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG
        - --location=${_CLOUDSDK_COMPUTE_ZONE}
        - --cluster=${_CLOUDSDK_CONTAINER_CLUSTER}
      

      JSON

      {
        "steps": [
          {
            "name": "gcr.io/cloud-builders/gke-deploy",
            "args": [
              "run",
              "--filename=KUBERNETES_RESOURCE_FILE",
              "--image=LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE_NAME:TAG",
              "--location=${_CLOUDSDK_COMPUTE_ZONE}",
              "--cluster=${_CLOUDSDK_CONTAINER_CLUSTER}"
            ]
          }
        ]
      }
      

      Dove:

      • KUBERNETES_RESOURCE_FILE è il percorso del file di configurazione di Kubernetes o il percorso della directory contenente i file di risorse di Kubernetes.
      • PROJECT è l'ID del tuo progetto.
      • IMAGE_NAME è il nome che vuoi assegnare all'immagine container, di solito il nome dell'applicazione.
      • TAG è il tag dell'immagine container.

      Per saperne di più su come definire le sostituzioni per i file di configurazione della build, consulta Utilizzo di sostituzioni definite dall'utente.

5. Fai clic su Crea per salvare il trigger di build.

Quando esegui il push del codice nel repository, Cloud Build attiva automaticamente una build. Per scoprire di più sui trigger di build, consulta la pagina Creare e gestire i trigger di build.

Passaggi successivi

• Scopri come configurare i deployment automatizzati per i tuoi carichi di lavoro su GKE.
• Scopri come creare una pipeline CI/CD in stile GitOps che esegue il deployment su GKE con Cloud Build.
• Scopri di più sulle opzioni aggiuntive per gke-deploy.
• Scopri come eseguire deployment blu/verde su Compute Engine.
• Scopri di più sui builder Cloud aggiuntivi.
• Scopri come risolvere gli errori di build.