Aggiunta di un'integrazione dello strumento utilizzando la console

Puoi aggiungere integrazioni dello strumento alla tua toolchain utilizzando la console.

1. Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains.
2. Nella pagina Toolchains, fai clic su una toolchain per aprirne la pagina di panoramica. In alternativa, nella pagina App details nella tua applicazione, fai clic sul nome della toolchain.
3. Per visualizzare l'elenco delle integrazioni degli strumenti da aggiungere, fare clic su Aggiungi.
4. Fai clic sull'integrazione dello strumento che desideri aggiungere.
5. Immetti tutte le informazioni necessarie per configurare l'integrazione dello strumento.
6. Fai clic su Create Integration per aggiungere l'integrazione dello strumento alla tua toolchain.

Aggiunta di un'integrazione dello strumento con l'API

Puoi aggiungere integrazioni dello strumento alla tua toolchain con 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 della toolchain in cui vuoi creare la tua integrazione dello strumento.

3. Cerca il tool_type_id valore che corrisponde all'integrazione dello strumento che vuoi aggiungere.

4. Aggiungi l'integrazione dello strumento nella toolchain di destinazione.

   curl -X POST --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data '{ "name": "{tool_name}", "tool_type_id": "{tool_type_id}", "parameters": {tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: {tool_type_id},
         name: {tool_name},
         parameters: {tool_parameters}
      };
      const response = await toolchainService.createTool(toolPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, {tool_type_id})
   createToolOptions.SetName({tool_name})
   createToolOptions.SetParameters({tool_parameters})
   tool, response, err := toolchainClient.CreateTool(createToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.create_tool(
      name = {tool_name},
      toolchain_id = {toolchain_id},
      tool_type_id = {tool_type_id},
      parameters = {tool_parameters}
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   CreateToolOptions createToolOptions = new CreateToolOptions.Builder()
      .name({tool_name})
      .parameters({tool_parameters})
      .toolchainId({toolchain_id})
      .toolTypeId({tool_type_id})
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createToolOptions).execute();
   ToolchainToolPost tool = response.getResult();
   

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

Aggiunta di un'integrazione dello strumento con Terraform

Puoi aggiungere integrazioni dello strumento alla tua 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 questo file, aggiungere la configurazione per creare le istanze di risorsa utilizzando l'HCL (Configuration Language) HashiCorp. Per ulteriori informazioni sull'utilizzo di questa lingua di configurazione, consultare la documentazione Terraform.

   Il seguente esempio crea un'integrazione dello strumento Delivery Pipeline utilizzando la risorsa ibm_cd_toolchain_tool_pipeline, dove toolchain_id è un GUID che rappresenta la toolchain in cui creare l'integrazione dello strumento.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myPipeline"
     }
   }
   

   Per ulteriori informazioni sulle risorse di integrazione dello strumento, vedi l'elenco completo delle risorse di integrazione dello strumento supportate in IBM Cloud Terraform Registry.

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 l'integrazione dello strumento.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform prende tutte le azioni richieste per creare l'integrazione dello strumento.

   terraform apply
   

Aggiornamento di un'integrazione dello strumento utilizzando la console

Se, durante la creazione di una toolchain, hai rimandato la configurazione dell'integrazione di uno strumento, sulla relativa scheda viene visualizzato il pulsante "Configura". Se hai configurato l'integrazione di uno strumento al momento della creazione della catena di strumenti, puoi aggiornare le impostazioni di configurazione tramite la console.

1. Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains.
2. Nella pagina "Toolchains", fare clic sulla toolchain che contiene l'integrazione dello strumento che si desidera aggiornare per aprire la relativa pagina "Panoramica". In alternativa, nella pagina App details nella tua applicazione, fai clic sul nome della toolchain.
3. Se hai bisogno di configurare un'integrazione dello strumento per la prima volta, nella sua scheda, fai clic su Configure.
4. Quando hai terminato la configurazione dell'integrazione dello strumento, fai clic su Save Integration.
5. Se devi aggiornare la configurazione di un'integrazione dello strumento, fai clic sull'icona Azioni > Configura.
6. Quando hai terminato di aggiornare le impostazioni, fai clic su Save Integration.

Aggiornamento dell'integrazione di uno strumento con l'API

Se hai configurato l'integrazione di uno strumento al momento della creazione di una toolchain, puoi aggiornare le impostazioni di configurazione 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. Ricerca l'ID della toolchain in cui esiste l'integrazione dello strumento.

3. Utilizzando l'ID della toolchain, cerca l'ID dell'integrazione dello strumento.

4. Aggiorna l'integrazione dello strumento nella toolchain di destinazione.

   curl -X PATCH --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/merge-patch+json" \
     --data '{ "name": "{new_tool_name}", "parameters": {new_tool_parameters} }' \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const toolPatchModel = {
         toolchainId: {toolchain_id},
         toolId: {tool_id},
         name: {new_tool_name},
         parameters: {new_tool_parameters}
      };
      const response = await toolchainService.updateTool(toolPatchModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   toolPatchModel := map[string]interface{}{
      "name": {new_tool_name},
      "parameters": {new_tool_parameters},
   }
   updateToolOptions := toolchainClient.NewUpdateToolOptions({toolchain_id}, {tool_id}, toolPatchModel)
   tool, response, err := toolchainClient.UpdateTool(updateToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tool = toolchain_service.update_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_id},
      toolchain_tool_prototype_patch = {
         "name": {new_tool_name},
         "parameters": {new_tool_parameters}
      }
   )
   

   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.CdToolchain;
   import com.ibm.cloud.continuous_delivery.cd_toolchain.v2.model.*;
   ...
   CdToolchain toolchainService = CdToolchain.newInstance();
   HashMap<String,Object> toolchainToolPrototypePatch = new HashMap<>();
   toolchainToolPrototypePatch.put("name", {new_tool_name});
   toolchainToolPrototypePatch.put("parameters", {new_tool_parameters});
   UpdateToolOptions updateToolOptions = new UpdateToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .toolchainToolPrototypePatch(toolchainToolPrototypePatch)
      .build();
   Response<ToolchainToolPatch> response = toolchainService.updateTool(updateToolOptions).execute();
   ToolchainToolPatch tool = response.getResult();
   

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

Aggiornamento di un'integrazione dello strumento con Terraform

Se hai configurato l'integrazione di uno strumento al momento della creazione di una toolchain, puoi aggiornare le impostazioni di configurazione tramite Terraform.

1. Installa la CLI Terraform e configura il plug-in del provider IBM Cloud per Terraform seguendo l'esercitazione per Introduzione a Terraform su IBM Cloud.

2. Utilizza il file di configurazione Terraform che hai usato per creare l'integrazione dello strumento. Se la tua integrazione dello strumento non è stata creata con Terraform, esegui terraform import per evitare di crearne un'altra. Per ulteriori informazioni sull'utilizzo di questa lingua di configurazione, consultare la documentazione Terraform.

   Il seguente esempio aggiorna il nome di un'integrazione dello strumento Delivery Pipeline esistente utilizzando la risorsa ibm_cd_toolchain_tool_pipeline, dove toolchain_id è un GUID che rappresenta la toolchain in cui è presente l'integrazione dello strumento.

   data "ibm_cd_toolchain" "cd_toolchain" {
     toolchain_id = {toolchain_id}
   }
   resource "ibm_cd_toolchain_tool_pipeline" "cd_pipeline" {
     toolchain_id = data.ibm_cd_toolchain.cd_toolchain.id
     parameters {
       name = "myUpdatedPipelineName"
     }
   }
   

   Per ulteriori informazioni sulle risorse di integrazione dello strumento, vedi l'elenco completo delle risorse di integrazione dello strumento supportate in IBM Cloud Terraform Registry.

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 modificare l'integrazione dello strumento.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform intraprende tutte le azioni richieste per modificare l'integrazione dello strumento.

   terraform apply
   

Eliminazione di un'integrazione dello strumento utilizzando la console

Puoi eliminare le integrazioni dello strumento dalla tua toolchain utilizzando la console. Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata.

1. Dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Toolchains.
2. Nella pagina Toolchains, fai clic su una toolchain per aprirne la pagina di panoramica. In alternativa, nella pagina App details nella tua applicazione, fai clic sul nome della toolchain.
3. Sull'integrazione dello strumento che vuoi eliminare, fai clic sull'icona Azioni > Elimina.
4. Conferma facendo clic su Delete.

Eliminazione di un'integrazione dello strumento con l'API

Puoi eliminare le integrazioni dello strumento dalla tua toolchain con l'API. Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata.

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. Ricerca l'ID della toolchain in cui esiste l'integrazione dello strumento.

3. Utilizzando l'ID della toolchain, cerca l'ID dell'integrazione dello strumento.

4. Elimina l'integrazione dello strumento nella toolchain di destinazione.

   curl -X DELETE --location --header "Authorization: Bearer {iam_token}" \
     "{base_url}/toolchains/{toolchain_id}/tools/{tool_id}"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   const toolchainService = CdToolchainV2.newInstance();
   ...
   (async() => {
      const response = await toolchainService.deleteTool({
         toolchainId: {toolchain_id},
         toolId: {tool_id}
      });
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   deleteToolOptions := toolchainClient.NewDeleteToolOptions({toolchain_id}, {tool_id})
   response, err := toolchainClient.DeleteTool(deleteToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   response = toolchain_service.delete_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_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();
   DeleteToolOptions deleteToolOptions = new DeleteToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_id})
      .build();
   Response<Void> response = toolchainService.deleteTool(deleteToolOptions).execute();
   

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

Eliminazione di un'integrazione dello strumento con Terraform

Puoi eliminare le integrazione dello strumento dalla tua toolchain con Terraform. Se elimini un'integrazione dello strumento dalla tua toolchain, l'eliminazione non può essere annullata.

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. Utilizza il file di configurazione Terraform che hai usato per creare l'integrazione dello strumento. Commentare o rimuovere la risorsa di integrazione dello strumento dal file di configurazione.

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 eliminare l'integrazione dello strumento.

   terraform plan
   

5. Applicare il piano di esecuzione di Terraform. Terraform intraprende tutte le azioni richieste per eliminare l'integrazione dello strumento.

   terraform apply