IBM Cloud Docs
Configuring a custom tool (Other Tool)

Configuring a custom tool (Other Tool)

If your team uses a tool that isn't included in the toolchains integrations list, you can integrate a custom tool.

Configure a custom tool so that it works with other tools in your toolchain and is available to your team:

  1. If you have a toolchain and are adding this tool integration to it, from the IBM Cloud console, click the menu icon hamburger icon and select DevOps. On the Toolchains page, click the toolchain to open its Overview page. Alternatively, on your app's Overview page, on the Continuous delivery card, click View toolchain. Then, click Overview.

    a. Click Add tool.

    b. In the Tool Integrations section, click Other Tool.

  2. Type the tool name.

  3. Select the lifecycle phase that is most closely associated with the tool. This selection determines which category your tool is listed under on the Overview page.

  4. Add an icon URL. The icon is shown on your tool integration's card.

  5. Add a documentation URL.

  6. Specify a tool instance name. For example, My Team Tool.

  7. Add a tool instance URL. This URL opens whenever the tool integration's card is clicked.

  8. Add a description of your tool.

  9. (Advanced) Add more properties as needed. For example, list any information or attributes that are required for your tool to integrate with other tools in the toolchain.

  10. Click Create Integration.

Configuring a custom tool (Other Tool) by using the API

The custom tool (Other Tool) tool integration supports the following configuration parameters that you can use with the Toolchain HTTP API and SDKs when you create, read, and update tool integrations.

You must specify the tool_type_id property in the request body with the customtool value.

Table 1. Custom tool (Other Tool) tool integration parameters
Parameter Usage Type Terraform argument Description
additional-properties optional, updatable String additional_properties Specifies any information that is required to integrate with other tools in the toolchain.
dashboard_url required, updatable String dashboard_url The URL of the dashboard for this tool integration. In the graphical UI, the browser goes to this dashboard when you click the Other Tool tool integration card.
description optional, updatable String description A description that outlines the function of this tool integration.
documentationUrl optional, updatable String documentation_url The URL of this tool integration's documentation.
imageUrl optional, updatable String image_url The URL of the icon that is displayed on the tool integration card in the graphical UI.
lifecyclePhase required, updatable String lifecycle_phase The lifecycle phase of the IBM Cloud Garage Method that is the most closely associated with this tool integration.
name required, updatable String name The name of this tool integration.
type required, updatable String type The type of tool that this custom tool is integrating with.