ツールチェーンへの DevOps Insights の追加

コンソールを使ったDevOps Insightsの統合

ツール統合カタログから選択することにより、任意のツールチェーンに DevOps Insights を追加することができます。

1. IBM Cloudコンソールから、メニューアイコンの >Platform Automation>Toolchains をクリックします。
2. ツールチェーンを選択します。
3. **「ツールの追加」**をクリックします。
4. DevOps Insights タイルを選択します。
5. 「統合の作成」 をクリックします。
6. ツールチェーンの「概要」ページの**「IBM Cloud ツール」カードで、「DevOps Insights」**をクリックして「DevOps Insights」ダッシュボードを表示します。

APIとDevOps Insightsの統合

1. IAMベアラートークンを取得する。 あるいは、SDKを使用している場合は、IAM APIキーを取得し、環境変数を使用してクライアント・オプションを設定する。

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

2. DevOps Insightsツール統合を追加したい ツールチェーンのリージョンとIDを決定する。

3. DevOps Insights ツール統合をツールチェーンに追加します。

   curl -X POST \
     {base_url}/toolchains/{toolchain_id}/tools \
     -H 'Authorization: Bearer {token}' \
     -H 'Accept: application/json` \
     -H 'Content-Type: application/json' \
       -d '{
       "tool_type_id": "draservicebroker",
       "name": "{tool_integration_name}"
     }'
   

   const CdToolchainV2 = require('@ibm-cloud/continuous-delivery/cd-toolchain/v2');
   ...
   (async () => {
      const toolchainService = CdToolchainV2.newInstance();
      const draPrototypeModel = {
         toolchainId: {toolchain_id},
         toolTypeId: 'draservicebroker',
         name: {tool_integration_name}
      };
      const draTool = await toolchainService.createTool(draPrototypeModel);
   })();
   

   import (
   	   "github.com/IBM/continuous-delivery-go-sdk/cdtoolchainv2"
   )
   ...
   toolchainClientOptions := &cdtoolchainv2.CdToolchainV2Options{}
   toolchainClient, err := cdtoolchainv2.NewCdToolchainV2UsingExternalConfig(toolchainClientOptions)
   createDraToolOptions := toolchainClient.NewCreateToolOptions({toolchain_id}, "draservicebroker")
   createDraToolOptions.SetName({tool_integration_name})
   draTool, response, err := toolchainClient.CreateTool(createDraToolOptions)
   

   from ibm_continuous_delivery.cd_toolchain_v2 import CdToolchainV2
   ...
   toolchain_service = CdToolchainV2.new_instance()
   dra_tool = toolchain_service.create_tool(
      name = {tool_integration_name},
      toolchain_id = {toolchain_id},
      tool_type_id = "draservicebroker"
   )
   

   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 createDraToolOptions = new CreateToolOptions.Builder()
      .name({tool_integration_name})
      .toolchainId({toolchain_id})
      .toolTypeId("draservicebroker")
      .build();
   Response<ToolchainToolPost> response = toolchainService.createTool(createDraToolOptions).execute();
   ToolchainToolPost draTool = response.getResult();
   

以下の表は、前のステップで使用された各変数の一覧と説明です。

DevOps Insightsツール統合の詳細については、DevOps Insightsの追加 を参照してください。

DevOps InsightsとTerraformの統合

1. Terraform CLI をインストールし、Terraform 用の IBM Cloud Provider プラグインを構成するために、Terraform on IBM Cloud 入門のチュートリアルに従ってください。

2. DevOps Insightsツール統合を追加したいツールチェーンのリソースブロックを含むTerraformファイル（例えば、main.tf を見つける。 このファイルに、ツール統合を作成するための設定を追加する。

   以下の例では、ツールチェーンが存在しない場合は作成し、ibm_cd_toolchain_tool_devopsinsights リソースを使用してDevOps Insightsツール統合を追加します。

   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
   }
   

   ibm_cd_toolchain_tool_devopsinsights、Terraform Registry Documentationの引数リファレンスの詳細を参照。

3. Terraform CLI を初期設定します。

   terraform init
   

4. Terraform 実行プランを作成します。 この計画は、DevOps Insightsツール統合をツールチェーンに追加するために実行しなければならないすべてのアクションをまとめたものである。

   terraform plan
   

5. Terraformの実行計画を適用する。 TerraformはDevOps Insightsツール統合をツールチェーンに追加するために必要なすべてのアクションを実行します。

   terraform apply
   

TerraformとContinuous Deliveryの併用については、Continuous Delivery用のTerraformの設定 を参照してください。