Deleting your DevOps Insights data

Deleting a DevOps Insights tool integration by using the console

1. Click the menu icon , and select DevOps.
2. On the Toolchains page, select your toolchain.
3. From your toolchain's Overview page, on the IBM Cloud tools card, click the Overflow icon on your DevOps Insights instance. Then, select Delete.

Deleting a DevOps Insights tool integration with the API

1. Obtain an IAM bearer token. Alternatively, if you are using an SDK, obtain an IAM API key and set the client options by using environment variables.

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

2. Determine the region and ID of the toolchain.

3. Determine the ID of the DevOps Insights tool integration.

   curl -X GET \
     {base_url}/toolchains/{toolchain_id}/tools \
     -H "Authorization: Bearer {token}" \
     -H "Accept: application/json"
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   ...
   const toolchainService = CdToolchainV2.newInstance(); 
   const tools = await toolchainService.listTools({
      toolchainId: {toolchain_id},
   });
   

   import (
       "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
    toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
    listToolsOptions := toolchainClient.NewListToolsOptions({toolchain_id})
    tools, response, err := toolchainClient.ListTools(listToolsOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   tools = toolchain_service.list_tools(
      toolchain_id = {toolchain_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();
   ListToolsOptions listToolsOptions = new ListToolsOptions.Builder()
      .toolchainId({toolchain_id})
      .build();
   Response<ToolchainToolCollection> response = toolchainService.listTools(listToolsOptions).execute();
   ToolchainToolCollection tools = response.getResult();
   

4. Delete the DevOps Insights tool integration from the toolchain.

   curl -X DELETE \
     {base_url}/toolchains/{toolchain_id}/tools/{tool_integration_id} \
     -H 'Authorization: Bearer {token}'
   

   const response = await toolchainService.deleteTool({
      toolchainId: {toolchain_id},
      toolId: {tool_integration_id}
   });
   

   deleteToolOptions := toolchainClient.NewDeleteToolOptions({toolchain_id}, {tool_integration_id})
   response, err := toolchainClient.DeleteTool(deleteToolOptions)
   

   response = toolchainService.delete_tool(
      toolchain_id = {toolchain_id},
      tool_id = {tool_integration_id}
   )
   

   DeleteToolOptions deleteToolOptions = new DeleteToolOptions.Builder()
      .toolchainId({toolchain_id})
      .toolId({tool_integration_id})
      .build();
   Response<Void> response = toolchainService.deleteTool(deleteToolOptions).execute();
   

The following table lists and describes each of the variables that are used in the previous steps.

For more information about the DevOps Insights tool integration, see Adding DevOps Insights.

Deleting a DevOps Insights tool integration with Terraform

1. Locate the Terraform file (for example, main.tf) that contains the resource block for the existing DevOps Insights tool integration.

   The resource blocks in the following example describe an existing toolchain and DevOps Insights tool integration.

   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
   }
   
   resource "ibm_cd_toolchain_tool_devopsinsights" "cd_toolchain_tool_insights" {
     toolchain_id = ibm_cd_toolchain.cd_toolchain.id
   }
   

2. Remove the resource "ibm_cd_toolchain_tool_devopsinsights" block from your Terraform file.

3. Initialize the Terraform CLI.

   terraform init
   

4. Create a Terraform execution plan. This plan summarizes all of the actions that must run to delete the DevOps Insights tool integration.

   terraform plan
   

5. Apply the Terraform execution plan. Terraform takes all of the required actions to delete the DevOps Insights tool integration.

   terraform apply
   

For more information about using Terraform with Continuous Delivery, see Setting up Terraform for Continuous Delivery.