Creazione di una toolchain da un template utilizzando la console

È possibile utilizzare un modello come punto di partenza per creare una toolchain che includa un insieme specifico di integrazioni di strumenti. A seconda del template che utilizzi, puoi creare una toolchain che dispone di una serie di integrazioni dello strumento o una toolchain vuota a cui puoi aggiungere le integrazioni dello strumento. Ulteriori informazioni su come utilizzare i template da IBM Cloud Metodo Garage.

1. Accedi a IBM Cloud.

2. Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains.

3. Nella pagina Toolchains, fai clic su Create a Toolchain.

4. Nella pagina "Crea una toolchain", fare clic su un modello di toolchain.

5. Esamina il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain.

   Alcuni template della toolchain dispongono di più istanze di un'integrazione dello strumento. Ad esempio, il modello di toolchain "Develop and test microservices with Kubernetes and Helm " su IBM Cloud Public contiene quattro istanze di GitHub e quattro istanze di Delivery Pipeline.

   Il diagramma nella seguente immagine è un esempio. Quando crei una toolchain, il diagramma mostra ogni integrazione dello strumento che fa parte della toolchain.

   

6. Rivedi le informazioni predefinite per la configurazione della toolchain:

   • Il nome della toolchain la identifica in IBM Cloud. Se vuoi utilizzare un nome diverso, modifica il nome della toolchain.
   • La regione in cui creare la toolchain. Se vuoi utilizzare una regione differente, selezionala dall'elenco delle regioni disponibili.
   • Il gruppo di risorse in cui creare la catena di strumenti. Se desideri utilizzare un gruppo di risorse diverso, selezionalo dall'elenco dei gruppi di risorse disponibili.
   • Il provider per il tuo repository di origine, come GitHub, GitLab o Bitbucket. Se vuoi utilizzare un provider di origine differente, selezionalo dall'elenco dei repository disponibili.

7. Nella sezione Integrazioni dello strumento, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Alcune delle integrazioni dello strumento non richiedono configurazione. Per ulteriori informazioni sulla configurazione delle integrazioni dello strumento, consulta Configurazione delle integrazioni dello strumento.

   Molte delle integrazioni dello strumento che comprendono una toolchain richiedono un segreto per l'autenticazione con il servizio Continuous Delivery.

   Un segreto sono le credenziali che possono essere fornite nel formato di una password, di un token di autenticazione, di una chiave API o di un certificato. Ad esempio, quando aggiungi l'integrazione dello strumento Delivery Pipeline alla tua toolchain, devi fornire un segreto nel formato di una chiave API.

   a. Nella sezione Integrazioni strumento, fai clic su Delivery Pipeline.

   b. Fai clic su New per creare una chiave API IBM Cloud®.

   c. Fai clic su OK per applicare la tua nuova chiave API.

   Ogni utente può avere un massimo di 20 chiavi API.

   d. Fai clic su OK per creare la chiave API senza salvare una copia protetta della chiave.

   e. Per salvare in modo sicuro la chiave API in modo da poterla riutilizzare in altri flussi di lavoro della toolchain:

   • Selezionare la casella di controllo “Salva questa chiave in un archivio di segreti per il riutilizzo” per integrare il sistema con l’archivio di segreti Key Protect o Secrets Manager.
   • Se non disponi già di un'istanza di Key Protect o Secrets Manager, specifica un nome per l'istanza e il segreto.
   • Fai clic su OK per applicare la tua nuova chiave API.

   f. Per confermare che la tua istanza Key Protect o Secrets Manager è stata creata correttamente, vai al tuo IBM Cloud® Elenco risorse ed espandi il triangolo Servizi. Per visualizzare le tue chiavi API, dalla barra dei menu, fai clic su Gestisci > Accesso (IAM), quindi seleziona " IBM Cloud® " > Chiavi API.

   es. La chiave API che hai creato e copiato in Key Project è ora disponibile per l'uso sulla pagina Create a Toolchain. Tutte le integrazioni dello strumento che richiedono un segreto visualizzano un'icona chiave. Fare clic sull'icona a forma di chiave per aprire la finestra di dialogo "Secrets Picker" e recuperare i segreti da una o più istanze di Key Protect o Secrets Manager.

8. Fai clic su Crea. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain. Le integrazioni dello strumento che sono configurate sono diverse a seconda del template di toolchain che hai selezionato. Ad esempio, quando crei una toolchain "Develop and test microservices with Kubernetes e Helm" su IBM Cloud Public, esegui questa procedura:

   • La toolchain viene creata.
   • Se hai configurato Delivery Pipeline, le pipeline vengono create e attivate.
   • Se hai configurato Event Notifications, la toolchain è impostata per inviare notifiche di eventi al servizio Event Notifications da te specificato.
   • Se hai configurato Sauce Labs, la toolchain viene configurata per aggiungere i lavori di verifica Sauce Labs alle pipeline.
   • Se hai configurato PagerDuty, la toolchain viene configurata per inviare notifiche di avviso al servizio PagerDuty che hai specificato.
   • Se hai configurato Slack, la toolchain viene configurata per inviare notifiche sullo stato della distribuzione al canale Slack che hai specificato.
   • Se hai configurato un'integrazione dello strumento del codice sorgente come GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub.

   È ora possibile distribuire le notifiche degli eventi utilizzando lo strumento di integrazione Event NotificationsIBM Cloud Event Notifications è il metodo preferito per distribuire le notifiche a PagerDuty e ad altri canali di comunicazione come Slack, e-mail, SMS, notifiche push, webhook, Microsoft® Teams, ServiceNow, e IBM Cloud Functions. Per ulteriori informazioni sull'uso di Event Notifications, vedere Abilitazione delle notifiche di eventi per le catene di strumenti.

Creazione di una toolchain da un'applicazione utilizzando la console

Puoi creare una toolchain dalla tua applicazione. La toolchain può supportare il monitoraggio, la distribuzione e lo sviluppo continuo ed anche altro, e viene associata alla tua applicazione. Ogni applicazione può essere associata con una toolchain. Quando esegui il push delle modifiche a un repository GitHub della toolchain, la pipeline automaticamente crea e distribuisce l'applicazione.

1. Se hai utilizzato IBM Cloud Public per creare la tua app, questa è configurata per la distribuzione continua da un nuovo repository GitHub, che contiene il codice di avvio dell'app.

2. Nella pagina di configurazione della toolchain, esamina il diagramma della toolchain che stai per creare. Il diagramma mostra ogni integrazione dello strumento nella fase del suo ciclo di vita nella toolchain.

3. Rivedi le informazioni predefinite per la configurazione della toolchain. Il nome della toolchain la identifica in IBM Cloud. Se vuoi utilizzare un nome diverso, modifica il nome della toolchain.

4. Nella sezione Integrazioni dello strumento, seleziona ogni integrazione dello strumento che desideri configurare per la tua toolchain. Alcune delle integrazioni dello strumento non richiedono configurazione. Per ulteriori informazioni sulla configurazione delle integrazioni dello strumento, consulta Configurazione delle integrazioni dello strumento.

5. Fai clic su Crea. Diversi passi vengono eseguiti automaticamente per configurare la tua toolchain. Ad esempio, quando crei una toolchain da un'applicazione su IBM Cloud Pubblico, devono essere eseguiti questi passi:

   • La toolchain viene creata.
   • Se hai configurato Delivery Pipeline, le pipeline vengono create e attivate.
   • Se hai configurato GitHub, il repository GitHub di esempio viene clonato nel tuo account GitHub.

Creazione di una toolchain tramite l'API

1. Ottieni un token di connessione IAM. In alternativa, se stai utilizzando un SDK, ottieni una chiave API IAM e imposta le opzioni client utilizzando le variabili di ambiente.

   export CD_TOOLCHAIN_AUTH_TYPE=iam && \
   export CD_TOOLCHAIN_APIKEY={iam_api_key} && \
   export CD_TOOLCHAIN_URL={base_url}
   

2. Cerca l'ID del gruppo di risorse in cui vuoi creare la tua toolchain.

3. Scegli la regione in cui vuoi creare la tua toolchain.

4. Crea un'istanza della toolchain.

   curl -X POST \
     "{base_url}/toolchains" \
     -H 'Authorization: Bearer {token}' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "{toolchain_name}",
       "resource_group_id": "{resource_group_id}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolchainPrototypeModel = {
         description: {toolchain_description},
         name: {toolchain_name},
         resourceGroupId: {resource_group_id}
      };
      const response = await toolchainService.createToolchain(toolchainPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolchainOptions := toolchainClient.NewCreateToolchainOptions({toolchain_name}, {resource_group_id})
   createToolchainOptions.SetDescription({toolchain_description})
   toolchain, response, err := toolchainClient.CreateToolchain(createToolchainOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   toolchain = toolchain_service.create_toolchain(
      description = {toolchain_description},
      name = {toolchain_name},
      resource_group_id = {resource_group_id}
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   CreateToolchainOptions createToolchainOptions = new CreateToolchainOptions.Builder()
      .description({toolchain_description})
      .name({toolchain_name})
      .resourceGroupId({resource_group_id})
      .build();
   Response<ToolchainPost> response = toolchainService.createToolchain(createToolchainOptions).execute();
   ToolchainPost toolchain = response.getResult();
   

La seguente tabella elenca e descrive ciascuna delle variabili utilizzate nei passi precedenti.

Per ulteriori informazioni sulla creazione di toolchain con l'API, consulta Crea una toolchain nei documenti API IBM Cloud.

Creazione di una toolchain con Terraform

1. Per installare la CLI Terraform e configurare il plug-in del provider IBM Cloud per Terraform, segui l'esercitazione per Introduzione a Terraform su IBM Cloud®.

2. Crea un file di configurazione Terraform denominato “ main.tf ”. In tale file, aggiungere la configurazione per creare una toolchain utilizzando il linguaggio di configurazione HashiCorp. Per ulteriori informazioni sull'utilizzo di questa lingua di configurazione, consultare la documentazione Terraform.

   Il seguente esempio crea una toolchain utilizzando la risorsa ibm_cd_toolchain.

   data "ibm_resource_group" "group" {
     name = "default"
   }
   resource "ibm_cd_toolchain" "cd_toolchain" {
     name              = "my toolchain"
     resource_group_id = data.ibm_resource_group.group.id
   }
   

   Per ulteriori informazioni relative a ibm_cd_toolchain, consultare i dettagli di riferimento dell'argomento in Terraform Registry Documentation.

3. Inizializza la CLI Terraform.

   terraform init
   

4. Creare un piano di esecuzione Terraform. Questo piano riepiloga tutte le azioni che devono essere eseguite per creare una toolchain.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform prende tutte le azioni richieste per creare la toolchain.

   terraform apply