Applicazione

1. Selezionare Source Provider come Git Repos and Issue Tracking.
2. Il comportamento predefinito della toolchain è Usa l'applicazione di esempio predefinita. La toolchain attualmente supporta il collegamento solo ai repository esistenti Git Repos and Issue Tracking. Se si utilizza il repository del codice sorgente 'applicazione/servizio proprio, fare riferimento a:

• Portare la propria applicazione a DevSecOps.
• Configurare automaticamente le pipeline DevSecOps utilizzando la funzione Inferred DevSecOps Pipeline Configuration.

3. Inserite un nome univoco per Nome nuovo repository.
4. Fai clic su Continue.

Inventario

Il repository di inventario registra i dettagli delle risorse utente create dalle toolchain CI.

1. È possibile accettare la configurazione predefinita fornita nel modello o modificare la configurazione in base alle proprie esigenze.
2. Fai clic su Continue.

Problemi

Il repository dei problemi registra i problemi rilevati durante l'esecuzione della pipeline CI.

1. È possibile accettare la configurazione predefinita fornita nel modello o modificare la configurazione in base alle proprie esigenze.
2. Fai clic su Continue

Segreti

Specificare le integrazioni del caveau segreto da aggiungere alla propria toolchain utilizzando le levette. Per ulteriori informazioni, vedere Gestione di IBM Cloud segreti.

La toolchain CI supporta solo i tipi di segreto Segreti arbitrari e Credenziali IAM.

1. Questa esercitazione utilizza IBM Cloud® Secrets Manager come vault per i segreti. I campi Regione, Gruppo di risorse e Nome servizio vengono popolati automaticamente in base alle opzioni disponibili. Selezionare gli indicatori a discesa per visualizzare le altre scelte.
2. Inserite il vostro Secrets Manager nome istanza.
3. Selezionare il tipo di autorizzazione.
4. Fai clic su Continue.

Archiviazione prove

L'archivio delle prove memorizza tutte le prove e gli artefatti generati dalla pipeline DevSecOps CI.

1. Attivare il cursore del secchio IBM Cloud Object Storage per memorizzare tutte le prove nel secchio IBM Cloud Object Storage che può essere configurato nella pagina successiva.
2. Accettare le impostazioni predefinite.
3. Fai clic su Continue.

Bucket Object Storage cloud

È necessario disporre dell 'istanza IBM Cloud® Object Storage e di un bucket Cloud Object Storage che funga da archivio delle prove di conformità.

1. I campi Istanza Cloud Object Storage, Nome del bucket e Cloud Object Storage endpoint sono popolati automaticamente.
2. Inserite la vostra chiave API ID servizio.
   • Preferito: è possibile importare una chiave esistente da un vault dei segreti facendo clic sull'icona della chiave.
   • È possibile copiare e incollare una chiave esistente.
3. Fai clic su Continue.

Il campo endpoint è facoltativo. Si consiglia di selezionare o fornire l'endpoint durante la configurazione della toolchain o durante l'esecuzione della pipeline.

Distribuisci

Configurare il cluster di destinazione Kubernetes in cui viene distribuita l'applicazione.

1. Utilizzare il nome predefinito della app hello-compliance-app.

2. Digitare la propria IBM Cloud chiave API. La chiave API viene usata per interagire con lo strumento IBM Cloud CLI in diverse attività.

   • Preferito: è possibile importare una chiave esistente da un vault dei segreti facendo clic sull'icona della chiave.
   • È possibile copiare e incollare una chiave esistente.
   • Una nuova chiave può essere creata da qui facendo clic su Nuovo +.

   La chiave API appena generata può essere immediatamente salvata in un vault dei segreti.

3. Se la chiave API è valida e ha un accesso sufficiente, il Container Registry, Container Registry namespace, Regione del cluster Dev, Gruppo di risorse, Nome del cluster, Spazio dei nomi del cluster sono popolati automaticamente. È possibile modificare uno qualsiasi di questi campi per adattarlo alla propria configurazione.

4. Fai clic su Continue.

Firma risorsa utente

Gli artefatti costruiti dalla toolchain e registrati nell'inventario devono essere firmati prima di essere distribuiti in produzione.

1. Immettere la chiave privata GnuPG. In alternativa, è possibile creare una nuova chiave GPG facendo clic su NEW. Per ulteriori informazioni, vedere Generazione di una chiave GPG.
2. Fai clic su Continue.

DevOps Insights

Il IBM Cloud DevOps Insights è incluso nella toolchain. Visualizzare i risultati del test della pipeline per ogni build, da ogni distribuzione e ambiente.

1. Accettare la configurazione predefinita.
2. Fai clic su Continue.

SonarQube

Configurare SonarQube come strumento di analisi statica del codice per la catena di strumenti. SonarQube fornisce una panoramica dello stato generale e della qualità del codice sorgente ed evidenzia i problemi riscontrati nel nuovo codice. Gli analizzatori statici di codice rilevano bug difficili, come le dereferenze dei null-pointer, gli errori logici e le perdite di risorse per diversi linguaggi di programmazione.

1. Accettare la configurazione predefinita.
2. Fai clic su Continue.

Strumenti facoltativi

Eseguire la pipeline ci-pr

Per avviare il ci-pr pipeline, è necessario creare una richiesta di unione nel repository dell'applicazione.

1. Dalla pagina della catena di strumenti CI, fare clic sul riquadro ci-pr pipeline. Per impostazione predefinita, viene creato con il nome compliance-app-<timestamp>.

2. Creare un ramo dal ramo master.

3. Aggiornare il codice dell'applicazione o aggiungere un file readme e salvare le modifiche.

4. Fare clic su Invia richiesta di unione.

5. Nella pagina della toolchain CI, fai clic sul tile pr - pipeline. Verificare che il ci-pr pipeline sia attivato dalla creazione della richiesta di unione.

6. Attendere il completamento dell'esecuzione di ci-pr pipeline. La richiesta di unione corrispondente, che si trova nel repository dell'applicazione, è nello stato Pending finché tutte le fasi della pipeline PR non si concludono con successo.

7. Dopo che l'esecuzione della pipeline PR è andata a buon fine, fare clic sulla pipeline per esplorare i numerosi passaggi completati e visualizzare la pagina.

   

8. Accedere a Richiesta di fusione per unire la richiesta in modo che le modifiche vengano copiate nel ramo master del repository dell'applicazione.

Esegui la pipeline CI

Avviare la pipeline CI in uno dei seguenti modi:

• Automaticamente: Dopo una pipeline PR di successo, approvando e unendo la PR al ramo master.
• Manualmente: Per attivare manualmente la pipeline CI, selezionare la scheda Delivery Pipeline, fare clic su Esegui pipeline e selezionare Attivazione manuale.

In questa esercitazione, la pipeline CI è stata attivata dopo l'unione delle modifiche al codice nel ramo master del repository dell'applicazione.

1. Nella pagina CI toolchain, fai clic sul tile ci - pipeline.

2. Fare clic su Esegui contro il nome della pipeline. Osservare l'esecuzione di una pipeline. Attendere il completamento dell'esecuzione della pipeline.

3. Dopo che l'esecuzione della pipeline CI è andata a buon fine, fare clic sulla pipeline per esplorare i passaggi completati e visualizzare la pagina come mostrato nella cattura dello schermo.

   

4. Fare clic sul riquadro DevOps Insights per esaminare le evidenze raccolte nella pagina Quality Dashboard, come mostrato nell'immagine.

   

   È inoltre possibile esaminare le prove se durante la configurazione è abilitato il bucket " IBM Cloud Object Storage ". Per valutare se hai degli errori nell'esecuzione della tua pipeline, devi controllare il passo finale della tua pipeline, che ha un programma di valutazione della pipeline.

Visualizzazione dell'applicazione in esecuzione

Dopo una corretta esecuzione della pipeline CI, l'applicazione di esempio viene distribuita nel tuo cluster Kubernetes.

L'applicazione URL si trova alla fine del registro della fase di run stage dell'attività di deploy-dev dell'esecuzione della pipeline CI. Utilizza l' URL a per verificare che l'applicazione sia in esecuzione.

Personalizzazione pipeline

Le varie pipeline fornite nelle toolchain di riferimento per l'integrazione continua e la distribuzione continua si basano sul supporto Continuous Delivery per le pipeline Tekton. Per ulteriori informazioni sulla personalizzazione della pipeline, vedere Come può un utente personalizzare la pipeline?