Obiettivi

In questa esercitazione, impara come creare una toolchain aperta utilizzando Continuous Delivery per distribuire la tua applicazione a più cluster. Impara anche come vengono implementate le toolchain nel servizio Continuous Delivery e come distribuire una semplice applicazione web utilizzando un template di toolchain solo Continuous Delivery.

Con la configurazione Satellite, crei una configurazione che specifica quali risorse Kubernetes vuoi distribuire a un gruppo di cluster. Quindi, imposta una pipeline Continuous Delivery per distribuire queste risorse su un gruppo di cluster ogni volta che viene apportata una modifica alla configurazione.

La toolchain utilizzata in questa esercitazione implementa le pratiche DevOps standard relative alle funzionalità di fornitura continua gestendo le tue distribuzioni nelle ubicazioni Satellite. Dopo aver creato i cluster e averli associati a un gruppo di cluster Satellite, puoi creare una toolchain per modificare il codice sorgente di distribuzione ed eseguire il push della modifica al repository GitHub. Quando esegui il push delle modifiche al tuo repository, la pipeline di distribuzione basata su Tekton distribuisce automaticamente il codice ai tuoi cluster.

Destinatari

Questo tutorial è destinato agli amministratori che utilizzano le toolchain di Continuous Delivery e Satellite Config per distribuire risorse per la prima volta.

Prerequisiti

Prima di iniziare questa esercitazione, assicurati di disporre delle seguenti risorse.

• Un accountIBM Cloud. A seconda del tipo di account IBM Cloud, l'accesso ad alcune risorse potrebbe essere limitato. A seconda dei limiti previsti dal proprio piano di abbonamento, alcune funzionalità necessarie per determinate strategie di implementazione potrebbero non essere disponibili. Per ulteriori informazioni sugli account IBM Cloud, vedi Configurazione del tuo account IBM Cloud e Aggiornamento del tuo account.

• Un cluster Satellite o un cluster Red Hat® OpenShift® in IBM Cloud registrato con la tua ubicazione Satellite.

Se non disponi di un cluster Satellite, puoi registrare un cluster Red Hat OpenShift all'indirizzo Satellite.

• Un gruppo di clusterSatellite che contiene il cluster richiesto dalla toolchain. La toolchain in questa esercitazione supporta un gruppo di cluster Satellite che contiene solo cluster Red Hat OpenShift.

• Segreti di pull immagine. Assicurati di configurare i segreti di pull dell'immagine richiesti per distribuire le immagini dell'applicazione nel tuo spazio dei nomi del cluster. Per ulteriori informazioni, consulta la guida su come autorizzare il tuo cluster a scaricare immagini da un registro privato.

• Un'ubicazione Satellite per la distribuzione delle risorse.

• Un'istanza del servizio Continuous Delivery.

Introduzione

Inizia a creare una toolchain su IBM Cloud.

1. Accedi a IBM Cloud Toolchain con le credenziali IBM Cloud.
2. Selezionare il gruppo di risorse e l'ubicazione per la toolchain.
3. Fare clic su " Crea toolchain ".
4. Nella pagina Crea una toolchain, seleziona Satellite sotto Filtri per visualizzare i template applicabili per Satellite.
5. Seleziona il template Distribuisci le risorse Kubernetes a più cluster.
6. Leggere le informazioni per comprendere il funzionamento delle toolchain e fare clic su Avvia.

Definizione delle impostazioni della toolchain

Definire il nome, la regione e il gruppo di risorse per la toolchain.

1. Fornire un nome per la toolchain.
2. Seleziona la regione in cui desideri creare la toolchain.
3. Selezionare un gruppo di risorse in cui si desidera creare la toolchain.
4. Fai clic su Continue.

Definizione del repository di origine

Specificare i dettagli del repository di origine su cui si desidera che questa toolchain sia in ascolto. È possibile specificare queste informazioni utilizzando le opzioni di configurazione standard o le opzioni di configurazione avanzate.

1. Selezionare il provider di origine. A seconda del provider di origine scelto, vengono visualizzate le opzioni specifiche per tale provider di origine. Ad esempio, puoi selezionare Github Enterprise Whitewater come provider di origine.

2. Definire il repository di origine.

   • Per utilizzare un nuovo repository per questa toolchain, fare clic su Crea nuovo repository di origine e denominare il nuovo repository.
   • Per utilizzare un repository esistente per questa toolchain, fare clic su “Usa repository sorgente esistente ” e inserire l' URL e del repository. Seleziona il provider di origine e inserisci l' URL del tuo repository, ad esempio: https://github.com/my-org/my-repo.

3. Fai clic su Continue.

Se si desidera accedere a impostazioni del repository di origine più avanzate, ad esempio l'utilizzo di un server personalizzato e la modifica del comportamento di clonazione, selezionare Passa alla configurazione avanzata.

Impostazione della pipeline di distribuzione

Assegna un nome alla pipeline di distribuzione per l'implementazione delle tue applicazioni su più cluster all'interno del tuo gruppo di cluster " Satellite ".

1. Immetti il nome della pipeline, visualizzato nella tua toolchain.

2. Fai clic su Continue.

Fornitura di una chiave API

Fornisci le informazioni relative alla chiave API di IBM Cloud che la toolchain può utilizzare per accedere al tuo sito Satellite.

Se hai una chiave API esistente o più chiavi API esistenti, attieniti alla seguente procedura.

1. Selezionare il provider o i provider di segreti che si utilizzano. È possibile selezionare uno o più.

2. Fai clic su Continue.

3. Fornire le informazioni necessarie per accedere al provider di segreti.

Se non hai una chiave API esistente, puoi ignorare le opzioni in questa pagina e fare clic su Continua per passare alla pagina successiva, dove puoi creare una chiave API IBM Cloud e salvarla in un provider di segreti.

Configurazione della configurazione Satellite

Specificare le impostazioni che lo strumento di configurazione di Satellite può utilizzare durante la distribuzione delle risorse.

1. Inserisci una chiave API dell IBM Cloud. Se non hai fornito una chiave API IBM Cloud nella pagina precedente, puoi creare una nuova chiave API IBM Cloud facendo clic su Nuovo.

   È possibile salvare questa chiave in un provider segreto di propria scelta per riutilizzarla selezionando tale opzione quando si crea la nuova chiave o facendo clic sull'icona della chiave.

2. Definire lo spazio dei nomi a cui si desidera distribuire le risorse. Deve essere uno spazio dei nomi esistente.

3. Specificare il ramo a cui distribuire la risorsa; ad esempio v1.

4. Fornire il percorso a cui distribuire la risorsa; ad esempio deployments.

5. Selezionare il gruppo di cluster per ricevere le risorse che si stanno distribuendo.

6. Fornire il nome visualizzato della configurazione di Satellite.

7. Fai clic su Continue.

Revisione del riepilogo

Riesamina il riepilogo e conferma la creazione della tua toolchain.

• Per modificare i parametri forniti in precedenza, fare clic su Indietro.

• Per creare la toolchain con i parametri forniti, fai clic su Crea toolchain.

Verifica della toolchain

Quando la toolchain viene creata, viene visualizzata la pagina Panoramica della toolchain. In questa pagina è possibile visualizzare i repository, le pipeline e gli eventuali strumenti IBM Cloud associati a questa catena di strumenti.

In Repository sono i repository di origine e i repository aggiuntivi per le attività del catalogo Tekton e della pipeline. Se sei a tuo agio con l'utilizzo di Tekton, puoi andare a questi repository Tekton per apportare modifiche alla tua toolchain.

Sotto Delivery pipelines, puoi visualizzare lo stato delle tue esecuzioni di pipeline. Puoi fare clic sul nome della pipeline per visualizzare i dettagli sulla tua pipeline e impostarli. Da questa panoramica della pipeline, puoi configurare i trigger per la tua pipeline. I trigger definiscono quando viene avviata la pipeline.

È possibile avviare la pipeline di distribuzione in uno dei seguenti modi.

• Attivare manualmente la pipeline di distribuzione impostando un trigger manuale.
• Esegui il push di un commit al repository dell'origine di distribuzione come definito da un trigger del repository Git. Per impostare un trigger di repository Git, consulta Distribuzione di una nuova versione della tua applicazione da un ramo differente.

Per avviare un'esecuzione manuale della pipeline, attenersi alla seguente procedura.

1. Nella Panoramica della tua toolchain in Delivery pipelines, selezionare la delivery pipeline per visualizzarne lo stato.
2. Fare clic su Esegui pipeline.
3. Esaminare le proprietà del trigger per assicurarsi che corrispondano alla configurazione.
4. Fai clic su Esegui per eseguire la toolchain e distribuire la tua applicazione.
5. Facoltativo: fare clic sul nome dell'esecuzione per visualizzare lo stato, i log e i dettagli.
6. Facoltativo: dopo che l'applicazione è in esecuzione, vai a Satellite Configurazione o esegui il comando ibmcloud sat config per vedere le tue risorse di configurazione Satellite.

Verifica dell'esecuzione dell'applicazione di esempio

Una volta configurata la toolchain e completata con successo la fase " Delivery Pipeline ", esegui i passaggi seguenti per verificare la tua app.

1. Dalla pagina Cluster, fai clic sul cluster che hai utilizzato per distribuire la tua applicazione.
2. Fai clic sulla console web OpenShift.
3. Nella sezione Workloads > Pod, filtra in base al progetto o allo spazio dei nomi del cluster e verifica che i pod siano in esecuzione.
4. Nella sezione Networking > Routes, filtra in base al progetto o allo spazio dei nomi del cluster e individua l'app URL.
5. Verifica che l'app sia in esecuzione accedendo all' URL dell'app tramite il browser.
6. Facoltativo: puoi visualizzare la tua configurazione Satellite nella console oppure eseguendo il comando ibmcloud sat config ls .

Distribuzione di una nuova versione della tua app da un ramo diverso

Se hai più rami nel tuo repository che rappresentano più versioni dell'applicazione, puoi distribuire un ramo differente per vedere una nuova versione della tua applicazione in esecuzione. Attieniti a questa procedura per modificare la toolchain per distribuire un ramo diverso del tuo repository di origine.

1. Nella Panoramica della tua toolchain, seleziona la delivery pipeline da modificare.
2. Fare clic su Trigger.
3. Fai clic sul menu di azioni per il trigger commit - push.
4. Seleziona Edit.
5. Nel campo Ramo, selezionare il ramo che si desidera distribuire. Ad esempio, v2.
6. Nella riga deployment - branch in Proprietà, fare clic su Modifica.
7. Modificare il valore di questa proprietà nel nome del ramo che si desidera distribuire. Ad esempio, v2.
8. Salva la modifiche.
9. Verifica se la tua app è aggiornata alla nuova versione visitando l' URL dell'app dal tuo browser.
10. Facoltativo: visualizza la nuova versione della configurazione nella console Satellite configuration console oppure eseguendo il comando ibmcloud sat config get --config CONFIG .

Ora puoi distribuire le risorse Kubernetes a più cluster con una singola toolchain.