チームがテストの目標を達成できるように、mablにはプランを実行するための幅広いオプションが用意されています。この記事では、mablでプラン実行をトリガーできる、さまざまな方法について説明します。
注
この記事では、mabl クラウド内でプラン実行をトリガーする方法を説明します。
mabl CLI では、--from-plan-id オプションを使って、プラン内のすべてのテストをローカル実行としてトリガーすることもできます: mabl tests run --from-plan-id。ローカル実行は、クラウドでのプラン実行と同じではありません。同時実行、ステージ、データテーブルのシナリオ、共有変数、クレデンシャルの上書きなどのクラウド機能は、ローカルではサポートされません。詳しくは、mabl CLI からテストをトリガーする記事を参照してください。
プランをアドホックに実行する方法
プランのアドホック実行のトリガーは、すべてが期待どおりに動作していることを確認する場合に便利な方法です。プランのアドホック実行をトリガーするには、次の手順を実行します。
- 左側のナビゲーションメニューで [プラン] をクリックします。
- トリガーするプランを見つけます。
- 右端の列にある [実行] ボタンをクリックします。
または、そのプランのプラン詳細ページを開いて、[実行] ボタンをクリックします。プランが複数の環境で実行される場合は、[実行] ボタンをクリックすると、代わりに [プラン実行を構成] パネルが開き、実行する環境を選択できます。プラン実行を構成するを参照してください。
プラン詳細ページからのプラン実行
プラン実行を構成する
ブランチや環境など、1 回のアドホック実行の設定を変更するには、プラン実行を構成します。
- プラン詳細ページで、[実行] ボタンの横にある下矢印をクリックし、[プラン実行を構成] を選択します。複数の環境で実行されるプランでは、[実行] をクリックしても同じパネルが開きます。
- この実行の設定を選択します。
- ブランチ：プランを実行するブランチです。ブランチでの実行の詳細については、ブランチでのテストの実行に関する記事を参照してください。
- 環境：実行する環境にチェックを入れます。チェックを入れた各環境の下で、使用する Web URL、API URL、ビルドファイルを選択します。プラン内のすべての環境で実行するには、どの環境にもチェックを入れないでください。
- WebサイトURLの上書き と API URLの上書き：プランの環境に設定されていない URL に対して実行します。
- Androidモバイルアプリ ビルドファイル と iOSモバイルアプリ ビルドファイル：既存のビルドファイルを選択するか、新しいビルドファイルをアップロードします。
- Credentials override：この実行で別のログイン用クレデンシャルまたは HTTP ベーシック認証クレデンシャルを使用します。プランのクレデンシャルを使用するには、フィールドを空のままにします。パネルを離れずに新しいクレデンシャルを作成するには、[クレデンシャルの追加] をクリックします。
- 自分のコンピュータ経由でテストのトラフィックをルーティングする：個人Linkトンネルを実行している場合に使用できます。
- [今すぐ実行] ボタンをクリックします。
プラン設定で独自のテスト固有のクレデンシャルが設定されているテストは、実行にクレデンシャルの上書きが設定されている場合でも、そのクレデンシャルを引き続き使用します。
使用量がクレジットで測定されている場合、パネルの [今すぐ実行] の横に、その実行の推定クレジット数が表示されます。推定値は、環境や URL を変更すると更新されます。
[プラン実行を構成] パネルでの環境の選択
アドホックテスト実行
単一のテストのアドホック実行の詳細については、テストのアドホック実行に関する記事を参照してください。
スケジュールに基づいてプランを実行する方法
設定した間隔で、または指定した日時にプランを実行するには、プランを編集し、新しいプランのトリガーを追加します。詳細については、プランのスケジューリングに関する記事を参照してください。
プランのトリガーの追加
注
タイマーとスケジュールのトリガーは、ブランチのプラン実行ではサポートされません。プランのブランチバージョンで反復的なトリガーをセットアップする場合は、デプロイメントイベントを使用し、お使いのCI/CDツールのスケジューリング機能を確認してください。
デプロイメントイベントでプランを実行する方法
デプロイメントイベントを使用すると、ワークスペース内のプランのうち、環境、アプリケーション、プランラベルなど、特定の条件に一致するプランのグループをトリガーできます。特定のプランを実行するために、IDで指定することもできます。詳細については、デプロイメントイベントに関する記事を参照してください。
mabl CLIでは、mabl plans run-cloud を使ってプラン実行をトリガーすることもできます: mabl plans run-cloud --id {plan-id}。このコマンドは、指定したプランだけを実行するデプロイメントイベントを作成します。詳しくは、mabl CLIからテストをトリガーするを参照してください。
プラン内の個別のステージを実行する方法
トラブルシューティングのために単一のプランステージを実行するには、次の手順を実行します。
- 左側のナビゲーションメニューで [プラン] をクリックします。
- プランをクリックして、プランの詳細ページを開きます。
- 実行するステージのタイトルの横にある再生ボタンをクリックします。
個別のプランステージの実行
失敗したプラン実行を再実行する方法
自動リトライ
プラン実行がスケジュールまたはデプロイメントイベントによってトリガーされる場合、プラン編集ページの [詳細] セクションで失敗時に自動的に再実行するようにプランを設定できます。
手動リトライ
プラン実行が手動でトリガーされ、プラン実行に失敗したテストまたはスキップされたテストが1つ以上含まれる場合、プランの詳細ページでそのプラン実行の一部またはすべてを再実行できます。特定のプラン実行の横にある再実行ボタンをクリックし、次のオプションのいずれかを選択します。
- このプランに含まれるすべてのテストを再実行する
- このプランに含まれる失敗したテストのみを再実行する
- このプランに含まれる失敗したテストとスキップされたテストを再実行する
失敗したテストとスキップされたテストを含むプラン実行の再実行