複数のソースのデータを 1 つのツールチェーンに集約する方法

DevOps Insights 2026年8月 31日にサービス終了となり、提供が中止されます。 この日付を過ぎると、本サービスはご利用いただけなくなります。 DevOps Insights の新しいツール連携は、今後作成できなくなりました。 詳細はこちら

デフォルトでは、パイプラインまたはその他のツールによって生成されたデータは、ツールが含まれているツールチェーンに集約されます。 IBM Cloud® DevOps Insights を使用すると、複数のソースから IBM Cloud® Continuous Delivery によって生成された品質データを 1 つのツールチェーンに集約できます。

単一のツールチェーンに注ぎ込まれた複数のソースの図
特定のポリシーを持つ中央ツールチェーンに集約されたデータ

開始前に

  1. ビルド、テスト、デプロイメントの各レコードを Continuous Delivery に送信するように DevOps Insights パイプラインを構成します。 ビルド・レコード、テスト・レコード、およびデプロイメント・レコードについて詳しくは、ビルド・レコードの公開デプロイメント・レコードの公開、および テスト結果の公開を参照してください。

  2. ゲート・レポートを集約するために使用する単一ツールチェーン内の ゲート・ポリシーを定義します。

ツールチェーン ID の識別

Jenkins、Travis CI、および他の継続的統合/継続的デリバリー (CI/CD) ツールを IBM Cloud® DevOps Insights と統合するには、ツールチェーン ID を把握しておく必要があります。 また、ツールチェーン ID を使用して、複数のソースからのデータを 1 つのツールチェーンに集約するように設定することもできます。

継続的インテグレーションおよび継続的デリバリーツールの DevOps Insights との統合に関する詳細については、 継続的インテグレーションおよび継続的デリバリーツールの DevOps Insights との統合を 参照してください。

ツールチェーン ID の検索

ツールチェーン ID は URL 内に示されています。 ツールチェーン ID を検索するには、以下の手順を実行します。

  1. IBM Cloud®コンソールから、メニューアイコンハンバーガーアイコン>Platform Automation>Toolchains をクリックします。
  2. 「ツールチェーン」ページで、ツールチェーンを選択します。
  3. ツールチェーンの「概要」ページの**「IBM Cloud ツール」カードで、「DevOps Insights」**をクリックします。
  4. URL で、ストリング内の ?toolchainId= より後の部分をすべてコピーします。 このストリングの長さは 36 文字で、英数字とダッシュで構成されます。

Jenkins のツールチェーン ID を検索する場合、ツールチェーンから DevOps Insights ではなく Jenkins を選択します。 同じ方法を使用して、URL 内のツールチェーン ID を検索することもできます。

例えば、https://cloud.ibm.com/devops/insights/overview?toolchainid=99c643c3-23d9-4030-9b1f-3aadfd7f9d09 です。 ツールチェーン ID は 99c643c3-23d9-4030-9b1f-3aadfd7f9d09 です。

IBM Cloud にログインするためにスクリプトで使用される API_KEY には、指定された新しい toolchain_id に対するアクセス権限が必要です。 API キーの作成および管理について詳しくは、ユーザーの API キーの管理を参照してください。

一元化されたターゲット・ツールチェーンに対するレコードの公開

データを単一のツールチェーンに公開するには、パイプライン・ステージのスクリプトを変更する必要がありますが、変更しなければならないステージは、データを公開するときに経由するステージです。 ステージを変更するのは、別のツールチェーンのデータを公開する場合のみです。 パイプラインが配置されている現在のツールチェーンにデータを公開する場合は変更しません。

一元化されたツールチェーンにレコードを公開するには、以下の手順を実行します。

  1. メニュー アイコン( ハンバーガーアイコン )をクリックし、「 リソース一覧 」を選択してください。
  2. ツールチェーンを選択します。
  3. ツールチェーンの「概要」ページの**「デリバリー・パイプライン」**カードで、使用するパイプラインをクリックします。
  4. 「設定」 アイコン 歯車アイコンおよび ステージの構成をクリックします。
  5. スクリプト・セクションを変更します。 ビルド、テスト、デプロイメントのレコードを送信するコマンドを呼び出した各ステージで、TOOLCHAIN_ID をツールチェーン ID の環境変数として設定します。 変数がコマンドを呼び出す前にツールチェーン ID をエクスポートします。
  6. ゲート決定用のコマンドを呼び出すか、ビルド、テスト、デプロイメントの各レコードを DevOps Insights に送信します。 詳細については、IBM Cloud® CLI を使用した一貫性のあるパラメーター値の設定を参照してください。

DevOps Insights CLI を使用するパイプラインのステージで TOOLCHAIN_ID を環境変数としてエクスポートします。

以下の例は、ビルド・レコードを別のツールチェーンの DevOps Insights に送信する方法を示しています。 このコマンドを呼び出してゲートを評価し、ビルド、テスト、またはデプロイメントの各レコードを公開する前に、ツールチェーン ID を上書きする必要があります。

#!/bin/bash
#install the latest version of the DevOps Insights plugin
ibmcloud plugin install -f doi
# Login to IBMCloud if you are not already logged in.  Assumes that $API_KEY environment variable has been set as a secured property in environment variable
ibmcloud login --apikey $API_KEY --no-region
# Overwrite the default TOOLCHAIN_ID with the Toolchain ID of the DevOps Insights instance you would like to send data to
export TOOLCHAIN_ID="$DEVOPS_INSIGHTS_TOOLCHAIN_ID"
# $GIT_BRANCH, $GIT_URL, $GIT_COMMIT are environment variables made available by the Continuous Delivery pipeline
# Assumes you have set $MY_APP_NAME and $MY_BUILD_NUMBER as described earlier
ibmcloud doi buildrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --branch $GIT_BRANCH --repositoryurl $GIT_URL --commitid $GIT_COMMIT --status pass

Insights品質ダッシュボードでのDevOpsデータ集約

品質ダッシュボードには、各アプリケーションの単体テスト、コード・カバレッジ、機能検証テスト、静的セキュリティー・スキャンなどの品質データ・セットが示されます。 「品質ダッシュボード」ページでは、IBM® Continuous Delivery Pipeline for IBM Cloud®、Jenkins、Travis、および他の継続的統合/継続的デリバリー (CI/CD) ツールを使用できます。 また、複数のクラウド環境またはオンプレミス環境で実行されているアプリケーションの品質データを IBM Cloud® DevOps Insights の 1 つのインスタンスに集約できます。 カテゴリーごとに具体的なテストに関する詳細が示され、傾向を分析できます。 ダッシュボードに表示するテストのタイプを指定できます。 データ・セットについて詳しくは、データ・セットの管理を参照してください。

配備リスク 品質ダッシュボード
図1. 品質ダッシュボード

「品質ダッシュボード (Quality Dashboard)」ページには、IBM Cloud® DevOps Insights に関連付けられている各アプリの情報行が表示されます。 アプリごとに各テストの成功と失敗に関するすべての情報が 1 つの画面で表示されます。 クオリティ・ダッシュボード」ページには、アップロード時に検査に関連付けられたタグも表示されます。 メニューからタグを選択することで、ページに表示される情報をそのタグに限定することができる。 デフォルトでは、テストに関連するすべてのタグが表示されます。

「品質ダッシュボード (Quality Dashboard)」ページは DevOps Insights ダッシュボードにあります。

  1. IBM Cloudコンソールから、メニューアイコンハンバーガーアイコン>Platform Automation>Toolchains をクリックします。
  2. 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。
  3. **「IBM Cloud ツール」**カードで、「DevOps Insights」ツール統合をクリックします。
  4. メニューから、**「品質ダッシュボード」**を選択します。