Questa guida spiega come eseguire deployment blu/verde senza tempi di inattività sulle gruppi di istanze gestite di Compute Engine mediante Cloud Build e con Terraform.
Cloud Build ti consente di automatizzare vari processi degli sviluppatori, tra cui la creazione e il deployment di applicazioni su vari runtime Google Cloud come Compute Engine, Google Kubernetes Engine, GKE Enterprise e Cloud Functions.
I MIG di Compute Engine ti consentono di operare su più macchine virtuali (VM) identiche. Puoi rendere i tuoi carichi di lavoro scalabili e ad alta disponibilità sfruttando i gruppi di istanze gestite tra cui: scalabilità automatica, riparazione automatica, regione (più zone) deployment e aggiornamento automatico. Utilizzo del deployment continuo blu/verde imparerai a trasferire gradualmente il traffico degli utenti da un gruppo di istanze gestite (blu) a un altro gruppo di istanze gestite (verde), entrambi in esecuzione in produzione.
Panoramica del design
Il seguente diagramma mostra il modello di deployment blu/verde utilizzato dal codice esempio descritto in questo documento:
A livello generale, questo modello include i seguenti componenti:
- Due pool di VM di Compute Engine: blu e verde.
- Tre bilanciatori del carico HTTP(S) esterni:
- Un bilanciatore del carico blu/verde, che instrada il traffico dagli utenti finali a il pool di istanze VM blu o verde.
- Un bilanciatore del carico blu che instrada il traffico dagli ingegneri QA gli sviluppatori al pool di istanze VM blu.
- Un bilanciatore del carico verde che instrada il traffico dai tecnici QA gli sviluppatori al pool di istanze Green.
- Due gruppi di utenti:
- Gli utenti finali che hanno accesso al bilanciatore del carico blu/verde, che indica al pool di istanze blu o verde.
- i tecnici e gli sviluppatori addetti al QA che richiedono l'accesso a entrambi i set di pool per per scopi di sviluppo e test. Possono accedere sia all'app Bilanciatori del carico verdi, che li instradano al pool di istanza blu Pool di istanze verdi.
I pool di VM blu e verdi sono implementati come gruppi di istanze gestite di Compute Engine, e gli indirizzi IP esterni vengono instradati nelle VM nel gruppo di istanze gestite utilizzando HTTP(s) esterni bilanciatori del carico. L'esempio di codice descritto in questo documento utilizza Terraform per per configurare l'infrastruttura.
Il seguente diagramma illustra le operazioni dello sviluppatore che si verificano nella deployment:
Nel diagramma in alto, le frecce rosse rappresentano il flusso di bootstrap si verifica quando configuri l'infrastruttura di deployment per la prima volta le frecce blu rappresentano il flusso GitOps che si verifica durante ogni deployment.
Per configurare questa infrastruttura, devi eseguire uno script di configurazione che avvia il bootstrap e configurare i componenti del flusso GitOps.
Lo script di configurazione esegue una pipeline di Cloud Build che esegue le seguenti operazioni:
- Crea un repository in Cloud Source Repositories.
denominato
copy-of-gcp-mig-simple
e copia il codice sorgente da GitHub di esempio nel repository in Cloud Source Repositories. - Crea due trigger di Cloud Build denominati
apply
edestroy
.
Il trigger apply
è collegato a un file Terraform denominato main.tfvars
nel
Cloud Source Repositories. Questo file contiene le variabili Terraform che rappresentano
i bilanciatori del carico blu e verde.
Per configurare il deployment, aggiorna le variabili nel file main.tfvars
.
Il trigger apply
esegue una pipeline di Cloud Build che
tf_apply
ed esegue le seguenti operazioni:
- Crea due gruppi di istanze gestite di Compute Engine (uno per il verde e uno per il blu), Istanze VM di Compute Engine (due per il gruppo di istanze gestite verde e due per il gruppo di istanze gestite in blu MIG), i tre bilanciatori del carico (blu, verde e splitter) e tre dagli indirizzi IP pubblici.
- Stampa gli indirizzi IP che puoi utilizzare per visualizzare i deployment le applicazioni nelle istanze blu e verde.
Il trigger di eliminazione viene attivato manualmente per eliminare tutte le risorse create l'attivatore apply.
Obiettivi
Utilizzare Cloud Build e Terraform per configurare il carico HTTP(S) esterno con backend di gruppi di istanze VM di Compute Engine.
Eseguire deployment blu/verde sulle istanze VM.
Costi
In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:
Per generare una stima dei costi basata sull'utilizzo previsto,
utilizza il Calcolatore prezzi.
Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina Pulizia.
Prima di iniziare
- 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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
Prova
Esegui lo script di configurazione dal repository di esempio di codice Google:
bash <(curl https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-build-samples/main/mig-blue-green/setup.sh)
Quando lo script di configurazione chiede il consenso dell'utente, inserisci yes.
L'esecuzione dello script termina tra pochi secondi.
Nella console Google Cloud, apri la Cronologia build di Cloud Build pagina:
Fai clic sulla build più recente.
Viene visualizzata la pagina Dettagli build, che mostra una riga di Cloud Build con tre passaggi di build: il primo passaggio crea un repository Cloud Source Repositories, il secondo passaggio clona i contenuti dell'esempio repository in GitHub a Cloud Source Repositories e il terzo passaggio aggiunge due e i trigger di build.
Apri Cloud Source Repositories:
Nell'elenco dei repository, fai clic su
copy-of-gcp-mig-simple
.Nella scheda Cronologia nella parte inferiore della pagina, vedrai un impegno con la descrizione
A copy of https://github.com/GoogleCloudPlatform/cloud-build-samples.git
creato da Cloud Build per creare un repository denominatocopy-of-gcp-mig-simple
.Apri la pagina Trigger di Cloud Build:
Per avviare il processo di deployment, aggiorna il file
infra/main.tfvars
:Nella finestra del terminale, crea ed esplora una cartella denominata
deploy-compute-engine
:mkdir ~/deploy-compute-engine cd ~/deploy-compute-engine
Clona il repository
copy-of-gcp-mig-simple
:gcloud source repos clone copy-of-mig-blue-green
Passa alla directory clonata:
cd ./copy-of-mig-blue-green
Aggiorna
infra/main.tfvars
per sostituire il blu con il verde:sed -i'' -e 's/blue/green/g' infra/main.tfvars
Aggiungi il file aggiornato:
git add .
Esegui il commit del file:
git commit -m "Promote green"
Esegui il push del file:
git push
Le modifiche apportate a
infra/main.tfvars
attivano l'esecuzione diapply
che avvia il deployment.
Apri Cloud Source Repositories:
Nell'elenco dei repository, fai clic su
copy-of-gcp-mig-simple
.Visualizzerai il commit con la descrizione
Promote green
nel Cronologia nella parte inferiore della pagina.Per visualizzare l'esecuzione dell'attivatore
apply
, apri la pagina Cronologia di build nella console Google Cloud:Apri la pagina Dettagli build facendo clic sulla prima build.
Vedrai la pipeline del trigger
apply
con due passaggi di build. Il primo il passaggio di build esegue Terraform apply per creare Compute Engine e caricare delle risorse per il deployment. Il secondo passaggio di build viene stampato l'indirizzo IP dove puoi vedere l'esecuzione dell'applicazione.Apri l'indirizzo IP corrispondente al gruppo di istanze gestite verde in un browser. Vedrai uno screenshot simile al seguente che mostra il deployment:
Vai alla pagina Gruppo di istanze di Compute Engine per visualizzare le icone blu e Gruppi di istanze verdi:
Apri la pagina Istanze VM per vedere le quattro istanze VM:
Apri la pagina Indirizzi IP esterni per vedere i tre bilanciatori del carico:
Vedrai due trigger di build denominati apply
e destroy
. Attivatore apply
è allegato al file infra/main.tfvars
nel ramo main
. Questo attivatore
viene eseguita ogni volta che il file viene aggiornato. L'attivatore destroy
è un attivatore
trigger.
Nozioni di base sul codice
Il codice sorgente per questo esempio di codice include:
- Codice sorgente correlato allo script di configurazione.
- Codice sorgente relativo alle pipeline di Cloud Build.
- Codice sorgente relativo ai modelli Terraform.
Script di configurazione
setup.sh
è lo script di configurazione che esegue il processo di bootstrap e crea
per il deployment blu/verde. Lo script esegue queste operazioni:
operazioni:
- Abilita Cloud Build, Resource Manager Compute Engine e le API Cloud Source Repositories.
- Concede il ruolo IAM
roles/editor
all'amministratore nel tuo progetto. Questo ruolo è richiesta per Cloud Build per creare e configurare Componenti GitOps per il deployment. - Concede il ruolo IAM
roles/source.admin
all'amministratore nel tuo progetto. Questo ruolo è richiesta per l'account di servizio Cloud Build per creare Cloud Source Repositories del progetto e clona i contenuti dell'esempio il repository GitHub nel tuo Cloud Source Repositories. Genera una pipeline Cloud Build denominata
bootstrap.cloudbuild.yaml
in linea, che:- Crea un nuovo repository in Cloud Source Repositories.
- Copia il codice sorgente dal repository GitHub di esempio nel un nuovo repository in Cloud Source Repositories.
- Crea i trigger di build apply e di eliminazione.
Pipeline di Cloud Build
apply.cloudbuild.yaml
e destroy.cloudbuild.yaml
sono i
I file di configurazione di Cloud Build utilizzati dallo script di configurazione
per il flusso GitOps. apply.cloudbuild.yaml
contiene due passaggi di build:
tf_apply build
passaggio di build che chiama la funzionetf_install_in_cloud_build_step
, che installa Terraform.tf_apply
che crea le risorse utilizzate nel flusso GitOps. Le funzionitf_install_in_cloud_build_step
etf_apply
sono definiti inbash_utils.sh
e il passaggio di build utilizza il comandosource
per chiamare che li rappresentano.describe_deployment
passaggio di build che chiama la funzionedescribe_deployment
che stampa gli indirizzi IP del carico bilanciatori del carico e bilanciatori del carico.
destroy.cloudbuild.yaml
chiama tf_destroy
che elimina tutte le risorse
creato da tf_apply
.
Le funzioni tf_install_in_cloud_build_step
, tf_apply
,
describe_deployment
e tf_destroy
sono definiti nel file bash_utils.sh
.
I file di configurazione di compilazione utilizzano il comando source
per chiamare le funzioni.
Il seguente codice mostra la funzione tf_install_in_cloud_build_step
che è
definita in bash_utils.sh
. I file di configurazione di compilazione chiamano questa funzione a
per installare Terraform al volo. Crea un bucket Cloud Storage
e registrare lo stato di Terraform.
Il seguente snippet di codice mostra la funzione tf_apply
definita in
bash_utils.sh
. Innanzitutto chiama terraform init
, che carica tutti i moduli
librerie personalizzate, quindi esegue terraform apply
per caricare le variabili
il file main.tfvars
.
Il seguente snippet di codice mostra la funzione describe_deployment
definita in bash_utils.sh
. Utilizza gcloud compute addresses describe
per recuperare
gli indirizzi IP dei bilanciatori del carico
utilizzando il nome e li stampa.
Il seguente snippet di codice mostra la funzione tf_destroy
definita in
bash_utils.sh
. Chiama terraform init
che carica tutti i moduli e
librerie e poi esegue terraform destroy
che scarica le variabili Terraform.
Modelli Terraform
Troverai tutte le variabili e tutti i file di configurazione di Terraform
copy-of-gcp-mig-simple/infra/
cartella.
main.tf
: questo è il file di configurazione di Terraformmain.tfvars
: questo file definisce le variabili Terraform.mig/
esplitter/
: queste cartelle contengono i moduli che definiscono bilanciatori del carico. La cartellamig/
contiene il file di configurazione di Terraform che definisce il gruppo di istanze gestite per i bilanciatori del carico blu e verde. L'architettura blu e i gruppi di istanze gestite sono identici, perciò vengono definiti e creazione di un'istanza per gli oggetti blu e verde. La configurazione di Terraform del bilanciatore del carico splitter si trova nella cartellasplitter/
.
Il seguente snippet di codice mostra i contenuti di infra/main.tfvars
. it
contiene tre variabili: due che determinano la versione dell'applicazione di cui eseguire il deployment
alle piscine blu e verde e a una variabile per il colore attivo: blu o
Verde. Le modifiche a questo file attivano il deployment.
Di seguito è riportato uno snippet di codice di infra/main.tf
. In questo snippet:
- Viene definita una variabile per il progetto Google Cloud.
- Google è impostato come provider Terraform.
- Viene definita una variabile per lo spazio dei nomi. Tutti gli oggetti creati da Terraform preceduta da questa variabile in modo che più versioni dell'applicazione possano essere distribuiti nello stesso progetto e i nomi degli oggetti non sono in conflitto con e l'altro.
- Le variabili
MIG_VER_BLUE
,MIG_VER_BLUE
eMIG_ACTIVE_COLOR
sono per le variabili nel fileinfra/main.tfvars
.
Il seguente snippet di codice da infra/main.tf
mostra l'istanza del
separatore. Questo modulo assume il colore attivo in modo che lo strumento di ripartizione si carichi
sa quale gruppo di istanze gestite eseguire il deployment dell'applicazione.
Il seguente snippet di codice da infra/main.tf
definisce due moduli identici
per i gruppi di istanze gestite blu e verdi. Prende il colore, la rete e la subnet
definiti nel modulo di suddivisione.
Il file splitter/main.tf
definisce gli oggetti che vengono creati per l'attributo
splitter MIG. Di seguito è riportato uno snippet di codice di splitter/main.tf
che
contiene la logica per passare tra il MIG verde e quello blu. È supportato da
il servizio google_compute_region_backend_service
, che può instradare il traffico a
due regioni di backend: var.instance_group_blue
o var.instance_group_green
.
capacity_scaler
definisce la quantità di traffico da indirizzare.
Il seguente codice indirizza il 100% del traffico al colore specificato, ma puoi aggiornare questo codice per il deployment canary in modo da instradare il traffico a un sottoinsieme per conto degli utenti.
Il file mig/main.tf
definisce gli oggetti relativi al blu e al verde
gruppi di istanze gestite. Il seguente snippet di codice di questo file definisce
utilizzato per creare i pool di VM. Tieni presente che questa istanza
ha la proprietà del ciclo di vita di Terraform impostata su create_before_destroy
.
Questo perché, quando aggiorni la versione del pool, non puoi usare il metodo
per creare la nuova versione dei pool quando viene ancora utilizzato
la versione precedente del pool. Ma se la versione precedente del pool
prima di creare il nuovo modello, ci sarà un periodo di tempo
le piscine non sono disponibili. Per evitare questo scenario, impostiamo il ciclo di vita di Terraform su
create_before_destroy
in modo che venga creata prima la versione più recente di un pool di VM
prima dell'eliminazione
della versione precedente.
Esegui la pulizia
Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.
Elimina singole risorse
Elimina le risorse Compute Engine create dal trigger di applicazione:
Apri la pagina Trigger di Cloud Build:
Nella tabella Trigger, individua la riga corrispondente all'eliminazione e fai clic su Esegui. Quando il trigger completa l'esecuzione, le risorse create dall'attivatore apply vengono eliminate.
Elimina le risorse create durante il bootstrap eseguendo questo comando nella finestra del terminale:
bash <(curl https://raw.githubusercontent.com/GoogleCloudPlatform/cloud-build-samples/main/mig-blue-green/teardown.sh)
Elimina il progetto
Elimina un progetto Google Cloud:
gcloud projects delete PROJECT_ID
Passaggi successivi
- Scopri di più sui trigger di build.
- Scopri come visualizzare la provenienza della build.