CI/CD moderno con GKE: applica il flusso di lavoro per sviluppatori

Last reviewed 2023-09-11 UTC

Questo tutorial mostra come fare l'onboarding di una nuova applicazione, sviluppare una funzionalità per ed eseguire il deployment dell'applicazione in produzione utilizzando tecniche di integrazione/distribuzione continua (CI/CD) con Google Kubernetes Engine (GKE).

Questo documento fa parte di una serie:

In questo tutorial utilizzi strumenti come Skaffold kustomize, Artifact Registry, Config Sync, Cloud Build e Cloud Deploy per sviluppare, creare ed eseguire il deployment della tua applicazione.

Questo documento è rivolto a Enterprise Architect e sviluppatori di applicazioni, nonché a team di sicurezza IT, DevOps e Site Reliability Engineering (SRE). Per comprendere i concetti di questo documento, è utile avere una certa esperienza con gli strumenti e le procedure di implementazione automatica.

Architettura

In questo tutorial imparerai a creare una nuova applicazione. Quindi, sviluppa una nuova funzionalità ed esegui il deployment dell'applicazione negli ambienti di sviluppo, gestione temporanea e produzione. L'architettura di riferimento contiene l'infrastruttura e gli strumenti necessari per l'onboarding e il rilascio di una nuova applicazione con il flusso di lavoro mostrato nel seguente diagramma:

Il ciclo di sviluppo comprende repository di codice, Cloudbuild e pipeline di deployment nel cloud.

A partire dal repository di codice per CI, il flusso di lavoro include quanto segue passaggi:

  1. Condividi il codice sorgente dell'applicazione tramite la tua applicazione repository.

  2. Quando esegui il commit e il push del codice nel repository dell'applicazione, viene attivata automaticamente una pipeline CI in Cloud Build. Il processo CI crea ed esegue il push di un'immagine container ad Artifact Registry.

  3. Il processo di CI crea anche una release CD per l'applicazione in Cloud Deploy.

  4. La release CD genera manifest Kubernetes con rendering completo per lo sviluppo utilizzando skaffold e ne esegue il deployment nel cluster GKE di sviluppo.

  5. La release CD viene quindi promossa da dev a target di gestione temporanea, che genera manifest di gestione temporanea con rendering completo e ne esegue il deployment nel cluster GKE di gestione temporanea.

  6. La release CD viene quindi promossa dalla fase di staging a quella di produzione, generando manifest di produzione completamente visualizzati e eseguendone il deployment nei cluster GKE di produzione.

Per ulteriori informazioni sugli strumenti e sull'infrastruttura utilizzati in questo flusso di lavoro, vedi Approccio CI/CD moderno con GKE: crea un sistema CI/CD.

Obiettivi

  • Eseguire l'onboarding di una nuova applicazione.

  • Esegui il deployment dell'applicazione nell'ambiente di sviluppo.

  • Sviluppare una nuova funzionalità ed eseguirne il deployment nell'ambiente di sviluppo.

  • Promuovi la nuova funzionalità in gestione temporanea e poi rilasciala in produzione.

  • Testa la resilienza dell'applicazione.

Costi

In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Al termine delle attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la sezione Pulizia.

Prima di iniziare

prepara l'ambiente

  1. Se continui direttamente da CI/CD moderno con GKE: creazione di un sistema CI/CD, vai alla sezione successiva. Tuttavia, se hai una nuova sessione o la tua sessione scaduta, apri Cloud Shell e imposta il progetto in cui hai installato l'infrastruttura dell'architettura di riferimento:

    gcloud config set core/project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

Eseguire l'onboarding di una nuova applicazione

L'architettura di riferimento contiene una fabbrica di applicazioni. Questa factory è una raccolta di un repository Git denominato application-factory-repo e dei seguenti trigger Cloud Build:

  • create-app
  • tf-plan
  • tf-apply
  • create-team

Puoi utilizzare la fabbrica delle applicazioni per eseguire l'onboarding di una nuova applicazione dai repository di base. L'onboarding per la richiesta prevede i seguenti passaggi:

  1. Crea la definizione dell'applicazione: crei la definizione dell'applicazione in un file Terraform e la archivi in application-factory-repo, che funge da catalogo delle applicazioni.

  2. Crea l'infrastruttura dell'applicazione: esegui Terraform sul file di definizione dell'applicazione per creare l'infrastruttura dell'applicazione. L'infrastruttura dell'applicazione è costituita da:

    1. Una landing zone per la nuova applicazione include la definizione dello spazio dei nomi, dell'account di servizio e dei criteri di base nel repository acm-gke-infrastructure-repo. La zona di destinazione viene creata in un cluster GKE di sviluppo solo durante l'onboarding di una nuova applicazione. Questo viene fatto per sbloccare gli sviluppatori in modo che possano utilizzare l'ambiente di sviluppo e iniziare a eseguirlo. La zona di destinazione nei cluster di staging e di produzione viene creata con l'approccio GitOps. Questo approccio viene illustrato più avanti in questo documento quando è tutto pronto per promuovere la release in questi cluster.

    2. Il repository di infrastruttura del repository di partenza dell'infrastruttura che ospita il codice per creare la pipeline CI in Cloud Build, la pipeline CD in Cloud Deploy e il repository Artifact Registry per l'archiviazione degli artefatti.

    3. Un trigger di Cloud Build dell'infrastruttura che acquisisce il codice nel repository dell'infrastruttura e crea le risorse in base alla relativa definizione.

    4. Un repository dell'applicazione dal repository di partenza dell'applicazione che ospita il codice sorgente dell'applicazione.

  3. Crea le risorse CI/CD dell'applicazione: utilizza l'infrastruttura dell'applicazione per creare risorse CI/CD per l'applicazione.

Crea la definizione dell'applicazione:

Esegui l'attivatore create-app per generare un file di definizione dell'applicazione in application-factory-repo. Il file di definizione contiene la definizione dichiarativa delle risorse necessarie per creare un'applicazione.

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

    Vai alla pagina Cloud Build

  2. Fai clic su create-app attivatore.

  3. Fai clic su MOSTRA ANTEPRIMA URL per visualizzare l'URL necessario per richiamare il webhook.

  4. In Cloud Shell, invoca l'attivatore inviando una richiesta curl all'URL ottenuto dal passaggio precedente e passando i parametri come payload.

    curl "WEBHOOK_URL" -d '{"message": {"app": "sample","runtime": "python","trigger_type": "webhook","github_team": ""}}'

    Nell'esempio di codice precedente:

    • Sostituisci WEBHOOK_URL con l'URL ottenuto dall'attivatore.

    • "app": "sample" specifica il nome dell'applicazione.

    • "runtime": "python" indica al produttore di applicazioni di utilizzare il modello Python per creare repository di applicazioni.

    • "trigger_type": "webhook" specifica il tipo di pipeline CI/CD per l'applicazione.

    • "github_team": "" è un team in GitHub che verrà associato ai repository creati per l'applicazione. Dato che non hai ancora creato un team GitHub, passalo come stringa vuota.

  5. Controlla la pipeline per l'attivatore create-app:

    Vai alla pagina Cronologia di Cloud Build.

    È presente una nuova pipeline per create-app trigger. Al termine, la definizione dell'applicazione viene creata in application-factory-repo.

  6. Esamina il file di definizione dell'applicazione:

    1. In un browser web, vai a GitHub e accedi al tuo account.

    2. Fai clic sull'icona dell'immagine e poi su Your organizations. Scegli la tua organizzazione.

    3. Fai clic sul repository application-factory-repo, vai alla cartella apps/python e apri il nuovo file denominato sample.tf creato dal trigger di create-app. Esamina il file, che contiene il codice Terraform per creare una nuova applicazione.

Crea l'infrastruttura dell'applicazione:

Ora che hai creato la definizione dell'applicazione, esegui l'attivatore tf-apply per creare l'infrastruttura dell'applicazione.

  1. Nella console Google Cloud:

    Vai alla pagina di Cloud Build .

    Fai clic su tf-apply trigger.

  2. Fai clic su "MOSTRA ANTEPRIMA URL" per visualizzare l'URL necessario per richiamare l'webhook.

  3. Richiama l'attivatore:

    curl "WEBHOOK_URL" -d '{}'

    Nell'esempio di codice precedente:

    • Sostituisci WEBHOOK_URL con l'URL ottenuto dall'attivatore.
  4. Controlla la pipeline per il trigger tf-apply:

    Vai alla pagina Cronologia di Cloud Build.

    È disponibile una nuova pipeline per l'attivatore tf-apply. Attendi il completamento.

Questo trigger crea l'infrastruttura dell'applicazione.

Esamina l'infrastruttura dell'applicazione:

Esamina i vari componenti dell'infrastruttura dell'applicazione.

Zona di destinazione

  1. Vai a Cloud Shell e imposta il progetto.

    gcloud config set core/project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

  2. Recupera le credenziali per il cluster GKE di sviluppo.

    gcloud container clusters get-credentials gke-dev-us-central1 --zone us-central1-a
    
  3. Controlla lo spazio dei nomi dell'applicazione. Lo spazio dei nomi prende il nome dall'applicazione, sample.

    kubectl get namespaces sample
    

    L'output è simile al seguente:

    NAME     STATUS   AGE
    sample   Active   15m
    

  4. Controlla l'account di servizio nello spazio dei nomi.

    kubectl get serviceaccounts -n sample
    

    Esiste un account di servizio oltre a quello predefinito. L'output è simile al seguente:

    NAME         SECRETS   AGE
    default      0         15m
    sample-ksa   0         15m
    

Repository dell'infrastruttura

In un browser web, vai a GitHub e accedi al tuo account. Fai clic sull'icona dell'immagine. Poi fai clic su Your organizations. Scegli la tua organizzazione e fai clic sul repository sample-infra.

Questo repository ha quattro branch: cicd-trigger, dev, staging e prod. Contiene anche quattro cartelle cicd-trigger, dev, staging e prod. Il ramo predefinito è cicd-trigger e puoi eseguire il push del codice mentre altri rami hanno regole di protezione, quindi non puoi eseguire il push del codice direttamente in quei rami. Per eseguire il push del codice a questi rami, devi creare una richiesta di pull. La cartella cicd-trigger contiene il codice per creare risorse CI/CD per l'applicazione, mentre le cartelle dev, staging e prod contengono il codice per creare l'infrastruttura per diversi ambienti dell'applicazione.

Trigger dell'infrastruttura

  • Nella console Google Cloud:

    Vai alla pagina di Cloud Build

    Esiste un nuovo attivatore denominato deploy-infra-sample.

  • Questo trigger è connesso al repository sample-infra in modo che quando viene eseguito il push del codice al repository, il trigger viene richiamato e identifica il ramo in cui è stato eseguito il push, quindi va alla cartella corrispondente su quel ramo ed esegue Terraform lì. Ad esempio, se il codice viene eseguito nel ramo cicd-trigger, l'attivatore esegue Terraform nella cartella cicd-trigger del ramo cicd-trigger. Analogamente, quando viene eseguito un push al ramo dev, il trigger esegue Terraform sulla cartella dev del ramo dev e così via.

Repository delle applicazioni

  • Vai su GitHub e visualizza i repository della tua organizzazione. Esiste un nuovo repository con il nome sample. Questo repository ospita il codice sorgente e i passaggi per creare i container in Dockerfile, nelle configurazioni kustomize che descrivono le configurazioni necessarie dell'applicazione e in skaffold.yaml che definisce i passaggi di deployment per Cloud Deploy per CD.

Crea risorse CI/CD dell'applicazione

Ora che hai creato lo scheletro dell'applicazione, esegui il trigger deploy-infra-sample per creare le relative risorse CI/CD. Puoi richiamare il trigger manualmente utilizzando l'URL webhook o eseguendo un commit nel repository Git sample-infra.

  1. Per richiamare il trigger di Cloud Build, aggiungi una nuova riga in un file nel repository. Quindi, esegui il push delle modifiche:

    1. Se non hai mai utilizzato Git in Cloud Shell, configuralo con il tuo nome e indirizzo email. Git utilizza queste informazioni per identificarti come autore dei commit che crei in Cloud Shell:

      git config --global user.email "GITHUB_EMAIL_ADDRESS"
      git config --global user.name "GITHUB_USERNAME"

      Sostituisci quanto segue:

      • GITHUB_EMAIL_ADDRESS: l'indirizzo email associato al tuo account GitHub
      • GITHUB_USERNAME: il nome utente associato al tuo account GitHub
    2. Clona il repository Git sample-infra:

      git clone https://github.com/GITHUB_ORG/sample-infra
      
      cd sample-infra

      Sostituisci quanto segue:

      • GITHUB_ORG con la tua organizzazione GitHub.

      Il ramo predefinito cicd-trigger è stato sottoposto a check-out.

    3. Aggiungi una nuova riga al file env/cicd-trigger/main.tf, esegui il commit della modifica ed esegui il push.

        echo "" >> env/cicd-trigger/main.tf
      
    4. Esegui il commit e il push delle modifiche:

      git add .
      git commit -m "A dummy commit to invoke the infrastrucutre trigger"
      git push
      cd ..
      

      Non appena le modifiche vengono inviate, viene avviato l'attivatore Cloud Deploy deploy-infra-sample.

  2. Monitora lo stato dell'attivatore:

    Vai alla pagina della cronologia di Cloud Build per visualizzare la pipeline e attendere il suo completamento.

Rivedi le risorse CICD dell'applicazione

Esamina le varie risorse CI/CD create per l'applicazione.

  1. Nella console Google Cloud:

    Vai alla pagina Cloud Build e visualizza l'attivatore deploy-app-sample.

    Questo è l'attivatore della pipeline CI. È connesso al repository del codice dell'applicazione sample. L'attivatore viene richiamato quando viene eseguito il push nel repository dell'applicazione ed esegue i passaggi di compilazione come definito nella configurazione dell'attivatore. Per visualizzare i passaggi eseguiti dall'attivatore quando viene richiamato, fai clic sul nome dell'attivatore e poi sul pulsante APRI EDITOR.

  2. Vai alla pagina Artifact Registry e visualizza il nuovo repository con il nome sample.

    Questo repository di artefatti memorizza gli artefatti dell'applicazione.

  3. Vai alla pagina della pipeline di Cloud Deploy e visualizza la pipeline con il nome sample. Questa è la pipeline di deployment continuo che esegue il deployment dell'applicazione nei cluster GKE.

Esegui il deployment dell'applicazione nell'ambiente di sviluppo

Il trigger deploy-app-sample è connesso al repository di applicazioni denominato sample. Puoi richiamare l'attivatore manualmente utilizzando l'URL webhook o tramite un push al repository dell'applicazione.

  1. Aggiungi una nuova riga in un file del repository sample e invia le modifiche per richiamare l'attivatore Cloud Build:

    1. Clona il repository Git sample:

      In Cloud Shell:

      git clone https://github.com/GITHUB_ORG/sample
      
      cd sample

      Sostituisci GITHUB_ORG con la tua prganizzazione GitHub.

    2. Aggiungi una nuova riga al file skaffold.yaml.

        echo "" >> skaffold.yaml
      
    3. Esegui il commit e il push delle modifiche:

      git add .
      git commit -m "A dummy commit to invoke CI/CD trigger"
      git push
      
    4. Non appena le modifiche vengono inviate, viene avviato l'attivatore Cloud Deploy deploy-app-sample.

  2. Monitora lo stato dell'attivatore:

    Vai alla pagina della cronologia di Cloud Build per visualizzare la pipeline e attendi che venga completata.

    L'attivatore esegue i passaggi definiti nella relativa configurazione. Il primo passaggio consiste nel creare un'immagine Docker dal codice dell'applicazione nel repository sample. L'ultimo passaggio consiste nell'avviare la pipeline Cloud Deploy che esegue il deployment dell'applicazione nel cluster GKE di sviluppo.

  3. Controlla il deployment nel cluster dev:

    Vai alla pagina della pipeline Cloud Deploy.

    Fai clic sulla pipeline sample. Il deployment nel cluster GKE di sviluppo è stato avviato. Attendi il completamento.

Verifica che il deployment dell'applicazione sia andato a buon fine:

  1. Recupera le credenziali per il cluster di sviluppo.

    gcloud container clusters get-credentials gke-dev-us-central1 --zone us-central1-a
    
  2. Tunnel nel cluster GKE.

    gcloud container clusters get-credentials gke-dev-us-central1 --zone us-central1-a && kubectl port-forward --namespace sample $(kubectl get pod --namespace sample --selector="deploy.cloud.google.com/delivery-pipeline-id=sample" --output jsonpath='{.items[0].metadata.name}') 8080:8080
    
  3. Nella barra degli strumenti di Cloud Shell, fai clic su

    Anteprima web e poi fai clic su Anteprima sulla porta 8080: Comandi della barra degli strumenti di Cloud Shell.

    L'output è il seguente:

    Hello World!
    
  4. In Cloud Shell, premi CTRL+C per terminare il port forwarding.

Aggiungere una nuova funzionalità all'applicazione

Quando sviluppi una nuova funzionalità, devi eseguire rapidamente il deployment delle modifiche nell'ambiente di sviluppo per testarle e eseguirne l'iterazione. In questo tutorial, apporti modifiche al repository del codice dell'applicazione e le esegui nell'ambiente di sviluppo.

  1. In Cloud Shell, cambia directory impostandola sul repository sample già clonato:

  2. Aggiorna l'applicazione per generare un messaggio diverso:

      sed -i "s/Hello World/My new feature/g" main.py
    
  3. Esegui il commit e il push delle modifiche:

    git add .
    git commit -m "Changed the message"
    git push
    

    Non appena il codice viene eseguito nel repository GitHub, viene attivato l'attivatore webhook deploy-app-sample.

  4. Monitora lo stato dell'attivatore nella pagina Cronologia di Cloud Build e attendi il completamento.

  5. Vai alla pagina della pipeline Cloud Deploy

    Fai clic sulla pipeline sample. Il deployment nel cluster GKE di sviluppo è stato avviato. Attendi che venga completato.

Verifica che il deployment dell'applicazione sia stato eseguito correttamente :

  1. Se hai aperto una nuova Cloud Shell, ottieni le credenziali per il cluster di sviluppo:

    gcloud container clusters get-credentials gke-dev-us-central1 --zone us-central1-a
    
  2. Tunnel nel cluster GKE:

    gcloud container clusters get-credentials gke-dev-us-central1 --zone us-central1-a && kubectl port-forward --namespace sample $(kubectl get pod --namespace sample --selector="deploy.cloud.google.com/delivery-pipeline-id=sample" --output jsonpath='{.items[0].metadata.name}') 8080:8080
    
  3. Nella barra degli strumenti di Cloud Shell, fai clic su

    Anteprima web e poi fai clic su Anteprima sulla porta 8080:

    Comandi della barra degli strumenti di Cloud Shell.

    L'output è il seguente:

    My new feature!
    
  4. In Cloud Shell, premi CTRL+C per terminare il port forwarding.

Esegui la promozione della modifica ai cluster di staging e di produzione

Prima di promuovere l'applicazione in ambienti di gestione temporanea e produzione, devi creare la zona di destinazione per l'applicazione nei cluster GKE per questi ambienti. Quando hai eseguito l'onboarding dell'applicazione, la zona di destinazione per lo sviluppo è stata creata automaticamente nel cluster GKE dev aggiungendo il codice a acm-gke-infrastructure-repo nel ramo dev.

Crea una zona di destinazione nella gestione temporanea e nella produzione di cluster GKE

  1. Crea una zona di destinazione nel cluster GKE gestione temporanea: devi creare una richiesta di pull da dev al ramo gestione temporanea in acm-gke-infrastructure-repo e uniscilo.

    1. Vai a GitHub e accedi al repository acm-gke-infrastructure-repo. Fai clic su Pull requests e poi sul pulsante New pull request. Nel menu Base, scegli staging e nel menu Confronta, scegli dev. Fai clic sul pulsante Create pull request.

    2. In genere, un utente che ha accesso al repository esamina le modifiche e quindi unisce il PR per assicurarsi che solo le modifiche previste vengano promosse nell'ambiente di gestione temporanea. Per consentire ai singoli utenti di provare l'architettura di riferimento, le regole di protezione dei rami sono state semplificate in modo che l'amministratore del repository sia in grado di ignorare la revisione e unire il PR. Se sei un amministratore del repository, unisci la richiesta di pull. In caso contrario, chiedi all'amministratore di unirli.

    Config Sync sincronizza le modifiche che arrivano sul ramo di staging del repository acm-gke-infrastructure-repo con il cluster GKE di staging, il che si traduce nella creazione della landing zone per l'applicazione sul cluster GKE di staging.

  2. Crea una landing zone nei cluster GKE di produzione: devi creare una richiesta di pull dal ramo di staging a quello di produzione e unirli.

    1. Fai clic su Pull requests, quindi sul pulsante New pull request. Nel menu Base, scegli prod e nel menu Confronta, scegli staging. Fai clic sul pulsante Create pull request.

    2. Se sei un amministratore del repository, unisci la richiesta di pull. In caso contrario, chiedi all'amministratore di unire i gruppi.

    Config Sync sincronizza le modifiche che arrivano sul ramo prod del repository acm-gke-infrastructure-repo con i cluster GKE di produzione, il che si traduce nella creazione di una landing zone per l'applicazione sui cluster GKE di produzione.

Esegui la promozione delle modifiche dallo sviluppo alla versione temporanea

Ora che hai creato la zona di destinazione per l'applicazione nei cluster GKE di gestione temporanea e produzione, promuovi l'applicazione dall'ambiente di sviluppo all'ambiente di gestione temporanea.

  1. Trova il nome della release più recente e salvalo come variabile di ambiente:

      export RELEASE=$(gcloud deploy targets describe dev --region=us-central1 --format="json" | jq -r '."Active Pipeline"[0]."projects/PROJECT_ID/locations/us-central1/deliveryPipelines/sample"."Latest release"' | awk -F '/' '{print $NF}')
     

    Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud.

    Verifica che la variabile di ambiente sia stata impostata:

      echo $RELEASE
      

  2. In Cloud Shell, esegui questo comando per attivare la promozione della release dall'ambiente di sviluppo all'ambiente di gestione temporanea:

     gcloud deploy releases promote --release=$RELEASE --delivery-pipeline=sample  --region=us-central1 --to-target=staging --quiet
     

  3. Controlla il deployment di staging:

    Vai alla pagina della pipeline di Cloud Deploy

    Fai clic sulla pipeline sample: il deployment nel cluster GKE di gestione temporanea è stato avviato. Attendi il completamento.

  4. Verifica che il deployment di staging sia andato a buon fine:

    1. Recupera le credenziali per il cluster di staging:

      gcloud container clusters get-credentials gke-staging-us-central1 --zone us-central1-a
      
    2. Tunnel nel cluster GKE:

      gcloud container clusters get-credentials gke-staging-us-central1 --zone us-central1-a && kubectl port-forward --namespace sample $(kubectl get pod --namespace sample --selector="deploy.cloud.google.com/delivery-pipeline-id=sample" --output jsonpath='{.items[0].metadata.name}') 8080:8080
      
    3. Nella barra degli strumenti di Cloud Shell, fai clic su

      Anteprima web e poi fai clic su Anteprima sulla porta 8080:

      Comandi della barra degli strumenti di Cloud Shell.

      L'output è il seguente:

      My new feature!
      
    4. In Cloud Shell, premi CTRL+C per terminare il port forwarding.

Esegui la promozione delle modifiche dalla versione temporanea alla produzione

Ora promuovi la release dalla versione temporanea alla produzione. Hai due cluster di produzione e Cloud Deploy ha un target per ciascuno di essi denominato rispettivamente prod1 e prod2.

  1. In Cloud Shell, esegui il seguente comando per attivare la promozione della release dal cluster di staging a prod1:

     gcloud deploy releases promote --release=$RELEASE --delivery-pipeline=sample  --region=us-central1 --to-target=prod1 --quiet
     

  2. Le release nei cluster di produzione richiedono l'approvazione, quindi l'implementazione attende fino a quando non la approvi. Per visualizzarla:

    Vai alla pagina della pipeline Cloud Deploy

    Fai clic su sample pipeline. L'implementazione in prod1 richiede l'approvazione e il ruolo clouddeploy.approver è necessario per approvare l'implementazione. Poiché sei il proprietario del progetto, hai accesso per approvare la release.

  3. Approva la release in prod1:

    Esegui questo comando per recuperare il nome dell'implementazione in attesa di approvazione e salvarlo in una variabile di ambiente:

     export ROLLOUT=$(gcloud deploy targets describe prod1 --region=us-central1 --format="json" | jq -r '."Pending Approvals"[]' | awk -F '/' '{print $NF}')
     

    Approva l'uscita:

     gcloud deploy rollouts approve $ROLLOUT --delivery-pipeline=sample --region=us-central1 --release=$RELEASE --quiet
     

  4. Dopo aver ricevuto l'approvazione, inizia la release prod1. Monitora l'avanzamento nella pagina della pipeline Cloud Deploy.

  5. Al termine del deployment di prod1, avvia il rilascio di prod2.

     gcloud deploy releases promote --release=$RELEASE --delivery-pipeline=sample  --region=us-central1 --to-target=prod2 --quiet
     

  6. Anche il rilascio in prod2 richiede l'approvazione. Approva la release nel cluster prod2:

    Esegui questo comando per recuperare il nome dell'implementazione in attesa di approvazione e salvarlo in una variabile di ambiente:

     export ROLLOUT=$(gcloud deploy targets describe prod2 --region=us-central1 --format="json" | jq -r '."Pending Approvals"[]' | awk -F '/' '{print $NF}')
     

    Approva la release:

     gcloud deploy rollouts approve $ROLLOUT --delivery-pipeline=sample --region=us-central1 --release=$RELEASE --quiet
     

  7. Una volta concessa l'approvazione, inizia il rilascio di prod2. Monitora l'avanzamento nella pagina della pipeline Cloud Deploy.

  8. Verifica che il deployment nel cluster di produzione sia andato a buon fine dopo il completamento delle pipeline Cloud Deploy in prod1 e prod2.

    1. Viene creato un Ingress multi-cluster nei cluster di produzione e utilizzi un bilanciatore del carico per accedere all'applicazione di produzione. Queste configurazioni di Ingress multicluster vengono create utilizzando i file YAML k8s/prod/mci.yaml e k8s/prod/mcs.yaml nel repository sample. Quando invii una richiesta all'indirizzo IP del bilanciatore del carico, Ingress multi-cluster la inoltra a una delle due istanze dell'applicazione in esecuzione in due diversi cluster GKE.

    2. Elenca la regola di forwarding associata al bilanciatore del carico per trovare l'indirizzo IP.

      gcloud compute forwarding-rules list
    3. L'output è simile al seguente:

      NAME: mci-qqxs9x-fw-sample-sample-ingress
      REGION:
      IP_ADDRESS: 34.36.123.118
      IP_PROTOCOL: TCP
      TARGET: mci-qqxs9x-sample-sample-ingress
      

    4. Apri un browser web e inserisci il seguente URL nell'URL:

      http://IP_ADDRESS:80

      Sostituisci IP_ADDRESS con l'indirizzo IP del bilanciatore del carico.

      L'output è il seguente:

      My new feature!
      

      Ciò conferma che l'applicazione viene eseguita come previsto nei cluster di produzione.

Testa la resilienza dell'applicazione

In questa sezione testerai la resilienza dell'applicazione in esecuzione in produzione riavviando uno dei nodi di uno dei due cluster GKE di produzione senza influire sull'applicazione.

L'applicazione in produzione utilizza Ingress multi-cluster ed è accessibile tramite l'IP di un bilanciatore del carico. Quando si accede all'applicazione tramite questo IP, Ingress multi-cluster la instrada a una delle due istanze dell'applicazione in esecuzione su due diversi cluster GKE. Se uno dei cluster GKE non è integro e non è possibile raggiungere l'istanza dell'applicazione in esecuzione su di esso, il traffico in entrata multi-cluster continua a inviare il traffico all'istanza in stato integro dell'applicazione in esecuzione sull'altro cluster GKE. Ciò rende l'interruzione del cluster invisibile all'utente finale e l'applicazione gestisce continuamente le richieste.

Per testare la resilienza:

  1. Individua il pool di nodi dei cluster GKE di produzione in esecuzione in us-west1.

     gcloud container clusters describe gke-prod-us-west1 --zone=us-west1-a --format=json | jq ".nodePools[0].instanceGroupUrls[]" | tr '"' ' ' |  awk -F '/' '{for(i=NF-2; i<=NF; i=i+2) printf ("%s ",$i); print  ""}'

  2. L'output è simile al seguente:

    us-west1-b gke-gke-prod-us-west1-node-pool-01-6ad4e1ed-grp
    us-west1-c gke-gke-prod-us-west1-node-pool-01-98407373-grp
    

    L'output ha due colonne: la prima colonna riporta la zona e la seconda colonna il nome del gruppo di istanze associato al pool di nodi del cluster GKE di produzione nella regione us-west1.

  3. Riavvia il gruppo di istanze corrispondente ai pool di nodi:

     gcloud compute instance-groups managed rolling-action restart INSTANCE_GROUP_1  --zone=ZONE_1 --max-unavailable=100%
    
     gcloud compute instance-groups managed rolling-action restart INSTANCE_GROUP_2  --zone=ZONE_2 --max-unavailable=100%

    Sostituisci INSTANCE_GROUP_1 con il nome del primo gruppo di istanze.

    Sostituisci ZONE_1 con la zona del primo gruppo di istanze.

    Sostituisci INSTANCE_GROUP_2 con il nome del secondo gruppo di istanze.

    Sostituisci ZONE_2 con la zona del secondo gruppo di istanze.

  4. Controlla lo stato del gruppo di istanze.

    Vai alla pagina Gruppi di istanze

    È in corso il riavvio dei due gruppi di istanze, mentre gli altri gruppi presentano un segno di spunta verde.

    Stato dei gruppi di istanze.

  5. Apri un browser web e inserisci quanto segue nell'URL:

    http://IP_ADDRESS:80

    Sostituisci IP_ADDRESS con l'indirizzo IP del bilanciatore del carico.

    Anche quando uno dei due cluster GKE non è attivo, l'applicazione è disponibile e l'output è il seguente:

     My new feature!
     

    Ciò dimostra che la tua applicazione è resiliente e altamente disponibile.

Gestisci l'applicazione

Quando hai creato questa applicazione dal fabbrica dell'applicazione, hai ottenuto repository Git, pipeline di infrastruttura e CI/CD separate per l'applicazione. Hai utilizzato queste risorse per eseguire il deployment dell'applicazione e aggiungere una nuova funzionalità. Per gestire ulteriormente l'applicazione, devi solo interagire con i repository Git e la pipeline senza dover aggiornare il data di fabbrica dell'applicazione. Puoi personalizzare le pipeline e i repository Git dell'applicazione in base ai tuoi requisiti. In qualità di proprietario dell'applicazione, puoi definire chi può accedere alle pipeline e ai repository Git della tua applicazione per gestirla.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial.

Elimina il progetto

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi