Contenuto correlato

• Introduzione a Continuous Delivery
• Introduzione ai cluster
• Introduzione alle toolchain

Configura il nome della toolchain e la regione

Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in IBM Cloud. Assicurati che il nome della toolchain sia univoco all'interno delle tue toolchain per la stessa regione e gruppo di risorse in IBM Cloud.

La regione della toolchain può essere diversa dal cluster e dalla regione di registro.

Selezionare la strategia di distribuzione

La toolchain crea una pipeline di distribuzione continua per distribuire l'immagine Docker dell'applicazione in IBM Cloud® Kubernetes Service. Selezionare la strategia di distribuzione che si desidera utilizzare. In base alla strategia di distribuzione scelta (Rolling, Blue - Green o Canary), è necessario fornire ulteriori dettagli.

1. Fare clic sulla strategia di distribuzione che si desidera utilizzare per la toolchain.

   

2. Fai clic su Continue.

Configura il repository del codice sorgente dell'applicazione

Nel passo Applicazione, le opzioni consigliate per il repository del codice sorgente dell'applicazione vengono visualizzate per impostazione predefinita. Per visualizzare tutte le opzioni disponibili per l'integrazione Git sottostante, fare clic su Opzioni avanzate. Per impostazione predefinita, la toolchain utilizza l'esempio predefinito che clona l'applicazione di esempio come repository IBMospitato Git Repos and Issue Tracking.

Puoi modificare il nome del repository dell'app. La regione del repository rimane uguale alla regione della toolchain.

Il template della toolchain fornisce un'applicazione Spring Java™ di esempio che utilizza una build Maven. Se si desidera collegare un repository di applicazioni esistente per la toolchain, selezionare Bring your own app e specificare l' URL a per il repository. La toolchain supporta il collegamento solo a repository Git Repos and Issue Tracking esistenti.

Per impostazione predefinita, il modello di repository dell'applicazione viene clonato nella tua Git Repos and Issue Tracking organizzazione. Per modificare l'organizzazione, abilita le Opzioni avanzate e specifica il proprietario del repository.

Configura il repository di inventario

Il repository di inventario registra i dettagli delle risorse create dalle toolchain di integrazione continua. Puoi creare un nuovo repository di inventario che sia un clone del template di repository di inventario oppure utilizzare un repository di inventario esistente che condividi tra le toolchain.

Per impostazione predefinita, il modello di repository dell'inventario viene clonato nella tua Git Repos and Issue Tracking organizzazione. Per cambiare l'organizzazione, seleziona Opzioni avanzate e specifica il proprietario del repository.

Archivia in modo sicuro i segreti

Diversi strumenti all'interno di questa toolchain richiedono segreti, come una chiave API IBM Cloud. Devi archiviare in modo sicuro tutti i segreti in un vault dei segreti e fare riferimento ad essi come richiesto dalla toolchain.

Utilizzando IBM Cloud, puoi scegliere tra diverse offerte di gestione dei segreti e di protezione dei dati che ti aiutano a proteggere i tuoi dati sensibili e centralizzare il segreto. Nel passo dei segreti, puoi specificare quali integrazioni del vault dei segreti aggiungere o rimuovere dalla tua toolchain. Per ulteriori informazioni sull'aggiunta e sulla rimozione delle integrazioni del vault, inclusi i prerequisiti e utilizzando i suggerimenti, vedi Gestione dei segreti IBM Cloud.

Utilizzando i suggerimenti all'interno di un template, una toolchain viene automaticamente popolata con segreti preconfigurati; non devi selezionare manualmente i segreti dalle integrazioni del vault che sono allegate alla toolchain.

Questa esercitazione utilizza IBM Secrets Manager come vault dei segreti.

IBM Secrets Manager archivia e applica in modo sicuro i segreti come le chiavi API, la firma immagine o le credenziali HashiCorp che fanno parte della tua toolchain.

Per ulteriori informazioni sulla gestione dei segreti in IBM Key Protect o HashiCorp, vedere Segreti.

Configura dettagli VPC

Configura la toolchain specificando le informazioni su VPC e VSI (Virtual Server Instances).

Hai fornito VPC e VSI utilizzando IBM Cloud® Schematics e Terraform quando hai selezionato la strategia di distribuzione da utilizzare.

• Virtual Private Cloud Region: seleziona la regione in cui hai eseguito il provisioning del VPC.
• Nome del cloud privato virtuale: seleziona il VPC di cui hai eseguito il provisioning utilizzando il template Terraform. Le opzioni includono tutte le VPC disponibili nella regione selezionata.
• Nome utente per le istanze VPC: specifica il nome utente che hai configurato quando hai eseguito il provisioning dell'istanza VPC. Tutte le VSI nel tuo VPC richiedono un nome utente e una chiave SSH per accedere e distribuire tale istanza.
• Base64 Encoded SSH Key for VPC Instances: specifica la chiave SSH privata nel modulo base64-encoded della chiave SSH pubblica che hai configurato quando hai eseguito il provisioning delle istanze VPC.

Configura dettagli host Bastion

Il modello Terraform crea anche una VSI da utilizzare come host Bastion. Un host Bastion fornisce un modo sicuro per connettersi alle VSI all'interno del tuo VPC per completare le attività di distribuzione e manutenzione. L'host Bastion si collega alle VSI su SSH utilizzando le credenziali (nome utente e chiave SSH) che hai configurato nei dettagli VPC.

La toolchain richiede che tu acceda alle VSI all'interno del VPC per distribuire il binario dell'app, avviare e arrestare l'applicazione e scaricare la dipendenza di terze parti per eseguire l'app. Tutte queste attività vengono eseguite utilizzando SSH - Tunneling con l'host Bastion. La toolchain utilizza le stesse credenziali per accedere all'host Bastion utilizzato dall'host Bastion per connettersi alle VSI.

• Host Bastion: seleziona la VSI di cui viene eseguito il provisioning come un host Bastion dal template Terraform.

Configura dettagli programma di bilanciamento del carico

L'applicazione di esempio distribuita sulle VSI nel tuo VPC visualizza una semplice pagina web sulla porta 8080. Per rendere l'applicazione disponibile su Internet utilizzando un nome DNS e per bilanciare il carico tra più VSI che eseguono l'applicazione, il template Terraform esegue il provisioning di un programma di bilanciamento del carico dell'applicazione. Tutte le VSI che eseguono l'applicazione dal pool di backend di server per il programma di bilanciamento del carico.

La toolchain utilizza i dettagli per il programma di bilanciamento del carico e due pool di backend per configurare e reindirizzare il traffico dell'applicazione in tempo reale durante il processo di distribuzione blue-green. Il pool di backend blu e il pool di backend verde contengono lo stesso numero di VSI. In qualsiasi momento, solo uno dei pool serve attivamente il traffico attivo mentre l'altro rimane inattivo eseguendo una versione precedente dell'applicazione. Il programma di bilanciamento del carico scambia o attiva / disattiva il pool di backend che serve il traffico attivo con ogni distribuzione. Mentre il pool di backend blu è attualmente attivo, la successiva distribuzione distribuisce l'app sulle VSI nel pool di backend verde e la rende attiva mentre il pool di backend blu è passivo.

Configura la toolchain specificando le informazioni su Load Balancer:

• Nome programma di bilanciamento del carico: seleziona il programma di bilanciamento del carico dell'applicazione di cui viene eseguito il provisioning dal modello Terraform.
• Nome pool di backend blu: seleziona il pool di backend blu di cui il modello Terraform fornisce il programma di bilanciamento del carico.
• Nome pool di backend verde: selezionare il pool di backend verde di cui il modello Terraform fornisce il programma di bilanciamento del carico.

Una volta popolati i dettagli per i passi deployment target, procedere al passo successivo.

Configura archiviazione risorse utente

Qualsiasi modifica all'origine attiva la pipeline di integrazione continua. Quando l'esecuzione di un'integrazione continua ha esito positivo, una risorsa utente binaria o di build viene creata e salvata nell'archiviazione transitoria e quindi distribuita alle VSI di destinazione.

Puoi utilizzare IBM Cloud Object Storage per archiviare le risorse di build transitorie all'interno della toolchain. La pipeline di integrazione continua crea il file .jar eseguibile per l'applicazione Spring Java di esempio.

In alternativa, puoi usare Artifactory se hai una tua Artifactory istanza di.

Esplora le pipeline

Puoi esplorare le pipeline per comprendere il flusso della toolchain e le differenti operazioni eseguite all'interno di ogni pipeline. La toolchain appena creata contiene tre pipeline:

• Pull request pipeline: viene eseguito quando uno sviluppatore unisce le modifiche dal proprio ramo di sviluppo al ramo master o a qualsiasi altro ramo nel repository. La pipeline di richiesta di pull esegue il test unità e le scansioni statiche sul codice sorgente dell'applicazione.
• Pipeline di integrazione continua: viene eseguito quando si unisce una modifica nel ramo principale del repository del codice sorgente applicazione. La pipeline di integrazione continua esegue il test unità, la copertura del codice e le scansioni statiche sul codice sorgente dell'applicazione, il controllo CIS e il controllo BOM (Bill Of Materials). La pipeline di fornitura continua genera anche le risorse di build binarie e le carica in IBM Cloud® Kubernetes Service, come configurato nella toolchain. E la pipeline di integrazione continua genera i metadati delle risorse di build e li archivia nel repository Inventory.
• Pipeline di distribuzione continua: distribuisce le risorse di build all'ambiente di distribuzione. La pipeline verifica la corretta distribuzione dell'applicazione eseguendo il controllo di integrità. È necessario attivare manualmente questa pipeline dopo il corretto completamento della pipeline di integrazione continua. A seconda della strategia di distribuzione selezionata, vengono aggiunti più trigger alla pipeline di fornitura continua.

Esegui la richiesta di pull e le pipeline di integrazione continua

Per avviare la pipeline di richiesta di pull, crea una richiesta di unione nel tuo repository dell'applicazione:

1. Nella pagina Panoramica della toolchain, nella scheda Repository fai clic sul repository dell'applicazione compliance-app-<timestamp>.
2. Dal repository master, crea un ramo.
3. Aggiornare del codice nel file readme o nell'applicazione del nodo di esempio e salvare queste modifiche.
4. Inoltrare la richiesta di integrazione.
5. Nella pagina della panoramica della toolchain, sulla scheda Repository, fai clic sul repository pr-pipeline per avviare la pipeline di richiesta di pull. La richiesta di unione corrispondente nel repository della tua applicazione rimane nello stato in sospeso fino a quando tutte le fasi della pipeline di richiesta di pull non vengono completate correttamente.
6. Dopo che l'esecuzione della pipeline di richiesta di pull ha esito positivo, puoi selezionarla per esplorare i passi completati.

Per avviare la pipeline di integrazione continua, unisci la richiesta di integrazione continua nel tuo repository dell'applicazione:

1. Andare alla richiesta di unione.
2. Unisci la richiesta in modo che le modifiche vengano copiate nel ramo master del tuo repository dell'app. La pipeline di integrazione continua viene attivata automaticamente.
3. Nella pagina della panoramica della toolchain di integrazione continua, sulla scheda Repository, fai clic sul repository ci-pipeline per avviare la pipeline di integrazione continua.
4. Dopo che l'esecuzione della pipeline di integrazione continua ha esito positivo, puoi fare clic sull'esecuzione della pipeline per esplorare i passi completati.

Per valutare se si verificano errori nell'esecuzione della pipeline, controllare il passo finale della pipeline, che dispone di un programma di valutazione della pipeline.

Esplora la pipeline di fornitura continua

La richiesta di pull e le pipeline di integrazione continua sono comuni a tutte le strategie di distribuzione. Le modifiche di progettazione e implementazione della pipeline di fornitura continua si basano sulla strategia di distribuzione precedentemente selezionata in questa esercitazione.

Questa esercitazione dimostra come funziona la strategia di distribuzione Blue - Green utilizzando l'applicazione di esempio.

Scopri la distribuzione Blue - Green

La strategia di distribuzione blu - verde utilizzata in questa esercitazione dimostra come puoi utilizzare una strategia di distribuzione con il servizio Continuous Delivery per eseguire i tuoi carichi di lavoro di produzione sul VPC. La pipeline di fornitura continua fornisce tre trigger per la distribuzione blu - verde. È possibile avviare una pipeline di fornitura continua in uno dei seguenti modi:

• Attivare manualmente la pipeline di fornitura continua.
• Attiva automaticamente la pipeline di fornitura continua dopo ogni azione Merge nel repository Inventory. Dopo l'unione, è necessario attivare manualmente l'esecuzione della pipeline di fornitura continua.
• Passa tra distribuzioni blu e verdi per un rollback automatizzato.

Questa esercitazione mostra come funziona la strategia di distribuzione Blue - Green utilizzando l'app di esempio.

1. Esegui il trigger manuale dalla pipeline di fornitura continua per distribuire la prima versione dell'applicazione.

   

2. Individua l'app URL all'interno del passaggio release della pipeline di consegna continua e fai clic su URL per verificare che l'app sia in esecuzione.

   

3. Aggiornare il codice app ed eseguire il commit delle modifiche. Per l'applicazione di esempio, aggiornare il messaggio di benvenuto:

   a. Nella pagina Panoramica della toolchain, sulla scheda Repository fai clic sul repository dell'applicazione di esempio.

   b. Aggiornare il messaggio di benvenuto nel file utils.js.

   c. Attendere il corretto completamento dell'esecuzione della pipeline di integrazione continua.

4. Eseguire il trigger manuale dalla pipeline di fornitura continua e attendere che l'esecuzione della pipeline di fornitura continua venga completata correttamente.

5. Controlla nuovamente l'app URL per confermare che l'app aggiornata sia stata distribuita. Entrambe le versioni dell'applicazione sono in esecuzione contemporaneamente. Tutto il traffico di rete sta fluendo verso l'applicazione aggiornata.

6. Verifica il rollback eseguendo il trigger switch-blue-green dalla pipeline di fornitura continua. Attendere il corretto completamento dell'esecuzione della pipeline del trigger dello switch.

   

7. Controlla nuovamente l'app URL per confermare che sia visualizzata la versione precedente dell'app.

Puoi eseguire il trigger dello switch più volte per alternare le versioni precedenti e più recenti dell'app.