Deployment in GKE

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

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

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

  • Aggiornamento del file di risorse Kubernetes dell'applicazione per l'utilizzo del container digest dell'immagine anziché di 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 strumento di creazione 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.

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

  • Devi disporre 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 i passaggi riportati di seguito per generarne uno per la tua applicazione:

    1. Apri la pagina 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. Viene visualizzata la sezione Configurazione.
    4. In YAML configurazione, fai clic su Visualizza YAML per ottenere un file di risorse Kubernetes di esempio.

Autorizzazioni IAM richieste

Aggiungi il ruolo Sviluppatore Google Kubernetes Engine al tuo account:

  1. Apri la pagina Impostazioni di Cloud Build:

    Apri la pagina Impostazioni di Cloud Build

    Viene visualizzata la pagina Autorizzazioni account di servizio:

    Screenshot della pagina Autorizzazioni dell'account di servizio

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

Deployment di un'immagine container predefinita

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

  1. Assicurati che il file della risorsa Kubernetes faccia riferimento al tag o al digest dell'immagine del contenitore corretto.

  2. Aggiungi il passaggio gke-deploy nel 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=location
  - --cluster=cluster

    JSON 

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

    Dove:

    • kubernetes-resource-file è il percorso del file della risorsa Kubernetes o il percorso della directory contenente i file delle risorse Kubernetes.
    • cluster è il nome del cluster GKE in cui verrà eseguito il deployment dell'applicazione.
    • location è la regione/zona del cluster.

    Per ulteriori informazioni sui flag disponibili, consulta Flag gke-deploy run.

  3. Avvia la compilazione:

    gcloud builds submit --region=REGION --project=project-id --config build-config

    Dove:

    • project-id è l'ID del tuo progetto.
    • build-config è il nome del file di configurazione della build.
    • REGION è una delle regioni di build supportate.

Creazione e deployment di una nuova immagine container in corso...

Per creare una nuova immagine container ed eseguirne il deployment:

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

    YAML 

    steps:
  # build the container image
- name: "gcr.io/cloud-builders/docker"
  args: ["build", "-t", "gcr.io/project-id/image:tag", "."]
  # push container image
- name: "gcr.io/cloud-builders/docker"
  args: ["push", "gcr.io/project-id/image:tag"]
  # deploy container image to GKE
- name: "gcr.io/cloud-builders/gke-deploy"
  args:
  - run
  - --filename=kubernetes-resource-file
  - --image=gcr.io/project-id/image:tag
  - --location=location
  - --cluster=cluster

    JSON 

    {
  "steps": [
    {
      "name": "gcr.io/cloud-builders/docker",
      "args": [
        "build",
        "-t",
        "gcr.io/project-id/image:tag",
        "."
      ]
    },
    {
      "name": "gcr.io/cloud-builders/docker",
      "args": [
        "push",
        "gcr.io/project-id/image:tag"
      ]
    },
    {
      "name": "gcr.io/cloud-builders/gke-deploy",
      "args": [
        "run",
        "--filename=kubernetes-resource-file",
        "--image=gcr.io/project-id/image:tag",
        "--location=location",
        "--cluster=cluster"
      ]
    }
  ]
}

    Dove:

    • project-id è l'ID del tuo progetto.
    • image è il nome desiderato dell'immagine container, di solito l'applicazione nome.
    • tag è il tag dell'immagine container.
      • Se crei una nuova immagine container con ogni commit, consiste nell'utilizzare l'algoritmo SHA breve di commit come tag. Con Cloud Build, disponibile come sostituzione predefinita, $SHORT_SHA.
    • kubernetes-resource-file è il percorso del file della risorsa Kubernetes o il percorso della directory contenente i file delle risorse Kubernetes.
    • cluster è il nome del cluster GKE in cui verrà eseguito il deployment dell'applicazione.
    • location è la regione/zona in cui verrà eseguito il deployment del cluster.

  2. Avvia la compilazione:

    gcloud builds submit --region=REGION --project=project-id --config build-config

    Dove:

    • project-id è l'ID del tuo progetto.
    • build-config è il nome del file di configurazione della build.
    • REGION è una delle regioni di build supportate.

Automatizzare i deployment

Puoi automatizzare il deployment della tua applicazione su GKE creando un trigger in Cloud Build. Puoi configurare gli attivatori per compilare e implementare le immagini ogni volta che esegui il push delle modifiche al codice.

Per creare un attivatore di compilazione:

  1. Apri la pagina Trigger nella console Google Cloud:

    Apri la pagina Trigger

  2. Seleziona il tuo progetto dal menu a discesa del selettore progetti nella parte superiore di 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 l'attivatore.

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

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

    5. Scegli una configurazione per l'attivatore.

      Se scegli un file di configurazione di Cloud Build, specificare le variabili di sostituzione specificando un nome e il valore che vuoi associare a quella variabile. Nell'esempio: di seguito, la variabile di sostituzione definita dall'utente _CLOUDSDK_CONTAINER_CLUSTER specifica il cluster in 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 compilazione 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=gcr.io/project-id/image: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=gcr.io/project-id/image:tag",
        "--location=${_CLOUDSDK_COMPUTE_ZONE}",
        "--cluster=${_CLOUDSDK_CONTAINER_CLUSTER}"
      ]
    }
  ]
}

      Dove:

      • kubernetes-resource-file è il percorso del file del file di configurazione di Kubernetes o il percorso della directory i tuoi file di risorse Kubernetes.
      • project-id è l'ID del tuo progetto.
      • image è il nome desiderato dell'immagine container, in genere il nome dell'applicazione.
      • tag è il tag dell'immagine container.

      Per saperne di più su come definire sostituzioni per i file di configurazione di compilazione, consulta l'articolo Utilizzare sostituzioni definite dall'utente.

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

Quando esegui il push del codice nel tuo repository, Cloud Build avvia automaticamente una build. Per scoprire di più sugli trigger di compilazione, consulta Creare e gestire trigger di compilazione.

Passaggi successivi