Esegui il deployment di un'app in GKE utilizzando Cloud Deploy

Questa pagina mostra come utilizzare Cloud Deploy per distribuire un'applicazione di esempio denominata nginx a una sequenza di due cluster Google Kubernetes Engine.

In questa guida rapida, imparerai a:

  1. Crea i due cluster.

  2. Creare una configurazione Skaffold e un cluster Kubernetes per specificare l'immagine del container (predefinita) di cui eseguire il deployment.

  3. Definisci la pipeline di distribuzione e il deployment di Cloud Deploy target, che puntano ai due cluster.

  4. Crea un'istanza per la tua pipeline di distribuzione creando una release, che automaticamente nel primo target.

  5. Promuovi la release al secondo target.

  6. Visualizza entrambi gli implementamenti nella console Google Cloud.

Prima di iniziare

  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs.

    Enable the APIs

  5. Install the Google Cloud CLI.
  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  9. Enable the Cloud Deploy, Cloud Build, GKE, and Cloud Storage APIs.

    Enable the APIs

  10. Install the Google Cloud CLI.
  11. To initialize the gcloud CLI, run the following command:

    gcloud init
  12. Assicurati che l'account di servizio Compute Engine predefinito abbia le autorizzazioni sufficienti.

    L'account di servizio potrebbe già disporre delle autorizzazioni necessarie. Questi passaggi sono inclusi per i progetti che disattivano la concessione automatica di ruoli account di servizio.

    1. Aggiungi il ruolo clouddeploy.jobRunner:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/clouddeploy.jobRunner"
      

    2. Aggiungi le autorizzazioni sviluppatore Kubernetes:

      gcloud projects add-iam-policy-binding PROJECT_ID \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/container.developer"
      

      Se hai difficoltà ad aggiungere uno di questi ruoli, contatta l'amministratore del progetto.

    3. Aggiungi il ruolo iam.serviceAccountUser, che include l'actAsautorizzazione per eseguire il deployment nel runtime:

      gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
          --format="value(projectNumber)")-compute@developer.gserviceaccount.com \
          --role="roles/iam.serviceAccountUser" \
          --project=PROJECT_ID
      

Crea i tuoi cluster Google Kubernetes Engine

Crea due cluster: qsdev e qsprod, con impostazioni predefinite. Il cluster Gli endpoint dell'API Kubernetes devono essere raggiungibili in rete dalla rete internet pubblica. I cluster GKE sono accessibili dall'esterno per impostazione predefinita.

gcloud container clusters create-auto quickstart-cluster-qsdev --project=PROJECT_ID --region=us-central1 && gcloud container clusters create-auto quickstart-cluster-qsprod --project=PROJECT_ID --region=us-central1

Prepara la configurazione Skaffold e il manifest di Kubernetes

Cloud Deploy utilizza Skaffold per fornire i dettagli per di cosa eseguire il deployment e di come eseguirne il deployment target.

In questa guida rapida creerai un file skaffold.yaml, che identifica le Manifest di Kubernetes da utilizzare per il deployment dell'app di esempio.

  1. Apri una finestra del terminale.

  2. Crea una nuova directory, denominata deploy-gke-quickstart, e vai alla directory.

    mkdir deploy-gke-quickstart
    cd deploy-gke-quickstart
    
  3. Crea un file denominato skaffold.yaml con il seguente contenuto:

    apiVersion: skaffold/v4beta7
    kind: Config
    manifests:
      rawYaml:
      - k8s-*
    deploy:
      kubectl: {}
    

    Questo file è una configurazione Skaffold minima, che identifica il manifest. Per questo rapida, devi creare il file. Ma puoi anche fai in modo che Cloud Deploy ne crei uno per te, per applicazioni semplici non di produzione.

    Consulta la documentazione di riferimento di skaffold.yaml per ulteriori informazioni su questo file.

  4. Crea un file denominato k8s-pod.yaml con il seguente contenuto:

    apiVersion: v1
    kind: Pod
    metadata:
      name: getting-started
    spec:
      containers:
      - name: nginx
        image: my-app-image
    

    Questo file è un semplice manifest Kubernetes, che viene applicato al cluster per eseguire il deployment dell'applicazione.

di Gemini Advanced.

Crea la pipeline di distribuzione e i target

Puoi definire la pipeline e i target in un file o in file separati. Nel di questa guida rapida, creerai un singolo file.

  1. Nella directory deploy-gke-quickstart, crea un nuovo file: clouddeploy.yaml, con i seguenti contenuti:

    apiVersion: deploy.cloud.google.com/v1
    kind: DeliveryPipeline
    metadata:
      name: my-gke-demo-app-1
    description: main application pipeline
    serialPipeline:
      stages:
      - targetId: qsdev
        profiles: []
      - targetId: qsprod
        profiles: []
    ---
    
    apiVersion: deploy.cloud.google.com/v1
    kind: Target
    metadata:
      name: qsdev
    description: development cluster
    gke:
      cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsdev
    ---
    
    apiVersion: deploy.cloud.google.com/v1
    kind: Target
    metadata:
      name: qsprod
    description: production cluster
    gke:
      cluster: projects/PROJECT_ID/locations/us-central1/clusters/quickstart-cluster-qsprod
    
  2. Registra la pipeline e i target con il servizio Cloud Deploy:

    gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
    

    Ora hai una pipeline, con destinazioni, pronta per il deployment dell'applicazione il primo obiettivo.

  3. Conferma la pipeline e i target:

    Nella console Google Cloud, vai a Cloud Deploy Pagina Pipeline di distribuzione per visualizzare l'elenco della distribuzione disponibile pipeline di dati.

    Apri la pagina Pipeline di distribuzione

    Viene mostrata la pipeline di distribuzione appena creata e i due target elencati nella colonna Destinazioni.

    visualizzazione della pipeline di distribuzione nella console Google Cloud

Crea una release

Una release è la risorsa centrale di Cloud Deploy che rappresenta delle modifiche implementate. La pipeline di distribuzione definisce il relativo ciclo di vita . Per informazioni dettagliate sul ciclo di vita, consulta la sezione Architettura del servizio Cloud Deploy.

Esegui questo comando dalla directory deploy-gke-quickstart per creare un'istanza Risorsa release che rappresenta l'immagine container di cui eseguire il deployment:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=my-gke-demo-app-1 \
  --images=my-app-image=gcr.io/google-containers/nginx@sha256:f49a843c290594dcf4d193535d1f4ba8af7d56cea2cf79d1e9554f077f1e7aaa

Come per tutte le release (a meno che non includano --disable-initial-rollout), Cloud Deploy crea automaticamente risorsa rollout. L'applicazione è il deployment automatico nel primo target nella progressione.

Promuovi la release

  1. Nella pagina Pipeline di pubblicazione, fai clic sulla pipeline my-gke-demo-app-1.

    Apri la pagina Pipeline di distribuzione

    La pagina Dettagli pipeline di distribuzione mostra una rappresentazione grafica avanzamento della pipeline di distribuzione. In questo caso, indica che la release è stata di cui è stato eseguito il deployment nel target qsdev.

    visualizzazione della pipeline di distribuzione nella console Google Cloud

  2. Nel primo target nella visualizzazione della pipeline di distribuzione, fai clic su Promuovi.

    Viene mostrata la finestra di dialogo Promuovi release. Mostra i dettagli del target a cui promuovi l'account.

  3. Fai clic su Promuovi.

    La release è ora in coda per il deployment in qsprod. Quando il deployment completato, la visualizzazione della pipeline di distribuzione mostra l'esecuzione del deployment:

    visualizzazione della pipeline di distribuzione nella console Google Cloud

Visualizza i risultati nella console Google Cloud

  1. Nella console Google Cloud, vai a Cloud Deploy Pagina Pipeline di distribuzione per visualizzare la pipeline di distribuzione my-gke-demo-app-1.

    Apri la pagina Pipeline di distribuzione

  2. Fai clic sul nome della pipeline di distribuzione "my-gke-demo-app-1".

    La visualizzazione della pipeline mostra l'avanzamento dell'app nella pipeline.

    visualizzazione della pipeline di distribuzione nella console Google Cloud

    La tua uscita è elencata nella scheda Uscite in Dettagli della pipeline di caricamento.

  3. Fai clic sul nome della release, test-release-001.

    Le implementazioni vengono visualizzate in Implementazioni. Puoi fare clic su un'implementazione per visualizzarne tra cui il log di deployment.

    le implementazioni nella console Google Cloud

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi per le risorse utilizzate in questa pagina, segui questi passaggi.

  1. Elimina il cluster qsdev:

    gcloud container clusters delete quickstart-cluster-qsdev --region=us-central1 --project=PROJECT_ID
    
  2. Elimina il cluster qsprod:

    gcloud container clusters delete quickstart-cluster-qsprod --region=us-central1 --project=PROJECT_ID
    
  3. Elimina la pipeline di distribuzione, i target, la release e le implementazioni:

    gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
    
  4. Eliminare i bucket Cloud Storage creati da Cloud Deploy.

    Uno termina con _clouddeploy e l'altro è [region].deploy-artifacts.[project].appspot.com.

    Apri la pagina del browser di Cloud Storage

Hai completato questa guida rapida.

Passaggi successivi