UIスクリプトを使用してTestRailからJenkinsビルドをトリガーする

Diogo Rede著

この記事は、「TestRailで実現する円滑なテスト自動化」と題したシリーズ記事の一部です。このシリーズでは、次の図のように、自動テストの結果をTestRailに集約する方法を詳しく説明します。

自動テストとTestRailを統合しているチームの多くは、TestRailの外で（たとえば継続的インテグレーションシステムの一部として）自動テストをトリガーし、実行してから、TestRailのAPIを使用してテスト結果をサブミットしています。

いっぽうで、日々のテストアクティビティをTestRailに集約し、複数のシステム間の移動を最小限にしたい場合は、UIスクリプトを使用してTestRailから直接Jenkinsのテスト実行をトリガーする仕組みを実装することもできます。このブログシリーズの最終回となる当記事では、TestRail Customizations GitHub repositoryのUIスクリプトサンプルを使用して、その方法を詳しく説明します。このUIスクリプトは、TestRailの [テストランと結果] ページにJenkinsビルドウィジェットを統合します。この手順を完了すると、TestRailを離れることなく自動テストを実行し、結果を取得することができるようになり、全体像が完成します。

Jenkinsの設定
UIスクリプトの設定
UIスクリプトの動作
最終結果
関連する製品
- テスト管理ツール TestRail
  - ■ TestRailの特長 ■
- テストの生産性向上をTestRailでお試しください

Jenkinsの設定

TestRail UIから直接Jenkinsのインスタンスにリクエストを送信するには、Jenkins側でCross-origin resource sharing (CORS)を許可する必要があります。通常、これはセキュリティリスクとみなされますが、適切な注意を払えば、この仕組みを利用して、リスクを増加させることなくTestRailにJenkinsジョブデータへのアクセスを許可できます。それには、次の手順に従って、信頼されたTestRailドメインにCORSを許可します。

1.[Manage Jenkins] >[Plugin Manager] に移動し、CORS support for Jenkins pluginを検索してインストールします。

2.[Manage Jenkins] >[Configure System]に移動します。

3.ページ下部の [CORS Filter] セクションに必要なパラメーターを挿入します。

4.[Save] をクリックして変更を確定します。

UIスクリプトの設定

TestRail Customizations GitHubからJenkins Builds UI Scriptをダウンロードします。UIスクリプトを追加するには、TestRailの管理エリアにある[管理]>[カスタマイズ]>[UI スクリプト] タブに移動し、[UI スクリプトの追加] ボタンを押下後、[設定] テキストボックスにUIスクリプト全体をコピー&ペーストします。以下の説明では、用意されたUIスクリプトサンプルを使用しますが、カスタムスクリプトの開発方法やサンプルのカスタマイズ方法を知りたい場合はUI スクリプトのドキュメントを参照してください。

スクリプトで2つの値を変更するだけで、適切にJenkinsインスタンスと接続し、目的のジョブからデータを取得するよう設定できます。まず、host変数にJenkinsのURLを設定します。次に、サンプルのjobs変数を変更します。ジョブはいくつでも設定できます。ジョブの名前は、トリガーボタンに表示したい任意の値を設定できます。パスは、ジョブへの相対パスであり、Jenkinsでジョブに移動してブラウザーから値をコピーできます。

/* CONFIG */

const host = "https://INSTANCE.testrail.io";
const username = null;               // Enter username and key only if you fully trust your organization members as this may pose a security risk
const key = null;                    // Generate an API key on your Jenkins user account
const requestInterval = 10000;       // Time between requests to Jenkins
const project = "PROJECT NAME";      // Name of the project to load the triggers for (use value null to enable for all projects)
const jobs = [
  {
    "name": "Run Automated Tests",
    "path": "job/Automated%20Tests%20Project"
  }
];

注意: 組織のすべてのTestRailユーザーを全面的に信頼しているのであれば、Jenkinsのユーザー名とキーを入力できますが、UIスクリプト（および認証情報）はブラウザー上にプレーンテキストとして表示されるため、セキュリティリスクとなることに注意してください。これらの変数はnullのままにし、ユーザーにUIから認証情報を入力させるようにすることを推奨します。

UIスクリプトの動作

前にも説明したとおり、UIスクリプトは右側のパネルにJenkinsとの統合セクションを追加します。このセクションには、自動テストのジョブ（またはその他の任意のジョブ）を表示するよう設定できます。パネルには、Automated Test Triggersという新しいセクションがあり、UIスクリプトで設定したジョブが表示されています。ジョブごとにトリガーボタンがあり、新規ビルドを開始できるほか、最近の3回のビルドへのリンクが表示され、色分けによってビルドのステータスがわかります。赤は失敗、緑は成功、青はまだ実行中であることを示します。

[Run Automated Tests]をクリックすると、JenkinsのAPI経由でジョブがトリガーされます。新しいジョブビルドは、実行中は青色でトリガーボタンの下のリストに表示され、その後、最終的なビルド結果に応じて赤色か緑色で表示されます。ビルドのリストはリンクになっているので、より詳細にビルドの結果を確認したい場合、簡単にJenkinsに移動できます。