テスト結果の公開
DevOps Insights 2026年8月 31日にサービス終了となり、提供が中止されます。 この日付を過ぎると、本サービスはご利用いただけなくなります。 DevOps Insights の新しいツール連携は、今後作成できなくなりました。 詳細はこちら
IBM Cloud® と統合するために、他の継続的統合と継続的デリバリー (CI/CD) ツールを IBM Cloud® DevOps Insights コマンド・ライン・インターフェース (CLI) で使用して、テスト結果を公開できます。 テスト結果は、ビルド・プロセスで実行されたテストについて DevOps Insights に通知します。 それらのテストでは、必ず何らかの JSON または XML ベースのファイルが生成されます。
生成されたテスト・ファイルが、テスト・レコードとして公開されます。 テスト・ファイルに加えて、このレコードには、アプリケーション名、ビルド番号、テストのタイプなどのフィールドが含まれます。 テスト・レコードのアプリケーション名およびビルド ID は、特定のビルドのビルド・レコードで使用されているアプリケーション名およびビルド ID と一致する必要があります。 CI/CD ツールでテストを実行した後、DevOps Insights に結果をアップロードできます。
開始前に
テスト結果を公開する前に、デプロイメント・レコードを公開する必要があります。 詳しくは、他の CI/CD ツールを使用したデプロイメント・レコードの公開を参照してください。
テスト結果の公開
testrecord-publish コマンドを使用して、テスト・レコードをアップロードします。 次のスクリプト例は、機能検証テスト (FVT) の結果を DevOps Insights にアップロードします。
# Run tests and generate a test results file here.
#install the DevOps Insights plugin
ibmcloud plugin install -f doi
# Log in to IBM Cloud if you are not already logged in. Assumes that $API_KEY environment variable has been set as a secured property
ibmcloud login --apikey $API_KEY --no-region
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation fvttest.json --type fvt
スクリプト例の testrecord-publish コマンドは、そのコマンドによってテスト・レコードがアップロードされることを指定します。 --filelocation フラグは、ジョブのルート・ディレクトリーを基準とするテスト結果ファイルの相対位置を示しています。 --type フラグは、テスト結果のタイプを示しています。
以下のスクリプト例は、テストを実行してから、Mocha の結果を DevOps Insightsにアップロードします。
# Run tests and generate a test results file here.
istanbul cover --report lcov --report json-summary _mocha -- -R xunit -O output=./test/results/mocha.xml 'test/**/*.js'
#install the DevOps Insights plugin
ibmcloud plugin install -f doi
# Log in to IBM Cloud if you are not already logged in. Assumes that $API_KEY environment variable has been set as a secured property
ibmcloud login --apikey $API_KEY --no-region
#Publish test results. Assumes that MY_APP_NAME and MY_BUILD_NUMBER environment variables are already set
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation /test/results/mocha.xml --type unittest
ibmcloud doi testrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --filelocation ./coverage/coverage-summary.json --type code
このコマンドでは、以下の type 値がサポートされます。
| タイプ | 説明 |
|---|---|
unittest |
単体テストの結果 |
fvt |
機能検証テストの結果 |
code |
コード・カバレッジの結果 |
sonarqube |
SonarQube スキャンの結果 |
staticsecurityscan |
IBM Application Security on Cloud の静的セキュリティー・スキャンの結果 |
dynamicsecurityscan |
IBM Application Security on Cloud の動的セキュリティー・スキャンの結果 |
テスト・レコードでは、以下のいずれかのサポートされている形式でデータを提供する必要があります。
| テスト・タイプ | サポートされる形式 |
|---|---|
| 機能検証テスト | Mocha、xUnit、Karma/Mocha |
| 単体テスト | Mocha、xUnit、Karma/Mocha |
| コード・カバレッジ | コベルチュラ, lcov,JaCoCo |
| 静的アプリ・スキャン | IBM Application Security on Cloud で提供される静的アプリ・スキャン |
| 動的アプリ・スキャン | IBM Application Security on Cloud で提供される動的アプリ・スキャン |
| SonarQube | SonarQube スキャンで提供されるスキャン・データ |
テスト結果の表示
CI/CD ツールが実行されると、テスト結果データが DevOps Insights に公開されます。 DevOps Insights でテスト結果データを表示するには、「品質ダッシュボード (Quality Dashboard)」ページに移動します。 詳しくは、DevOps データ集約を参照してください。
次のステップ
他の CI/CD ツールを使用してゲートを評価します。