mabl CLIでは、テストをローカルマシンで実行したり、テスト実行を直接CI/CDプロセスに統合することができます。mabl CLIは実行環境ではなく、クラウドまたはローカル/CI環境でmablテストをトリガーするためのツールです。
次のコマンドはクラウドでのテスト実行をトリガーし、並列実行がサポートされています。
- mabl deployments create - デプロイメントエベントをトリガーし、mablクラウドで定義されたフィルターに一致するプランを実行します。
- mabl tests run-cloud - mabl クラウドで1つ以上のテストを実行します
ローカルおよびセルフホストCI環境は、順次実行のみをサポートしています。ローカルおよびCI環境でテストを実行するには、次のコマンドを使用してください。
- mabl tests run - ローカルマシンまたはCI環境で1つ以上のブラウザまたはAPIテストを実行します
- mabl tests run-mobile - あなたのローカルマシンで1つ以上のモバイルテストを実行します
mabl CLIからテストをトリガーする方法について詳しく知るには、続きをお読みください。
mabl deployments create
mabl deployments create コマンドを使用して、指定されたフィルターセットに一致するすべてのプランをmablクラウドで並行実行するようにトリガーします。フィルターには、アプリケーション、環境、およびプランラベルを含めることができます。
デプロイメントエベントは多くのテストを並行して実行できるため、このコマンドは大量のテストに対して堅牢な検証を行うのに最適です。
オプション
mabl deployments create コマンドは、オーバーライド、ブランチ、ブラウザ設定、出力などを構成するための多くのオプションをサポートしています。オプションの全リストを見るには、mabl deployments create -h を実行してください。
開始するには、以下のオプションを使用して実行するプランを指定してください：
| オプション | 説明 |
--application-id および/または --environment-id
|
実行したいプランを指定するには、これらのオプションのうち少なくとも1つを使用してください。 |
--plan-labels |
オプション: スペースで区切られたプランラベルのリスト内のいずれかのラベルに一致するプランを実行します。 |
出力
デフォルトでは、CLIはmablアプリでデプロイメントエベントの結果を表示するためのリンクを出力します。
例
# Trigger a deployment of all plans with a "regression" label mabl deployments create -e [environment-id] --labels regression # Use a URL override to run plans against a preview environment mabl deployments create -e [environment-id] --app-url [url-override]
mabl tests run-cloud
mabl tests run-cloud コマンドを使用して、mablクラウドで1つ以上のテストを並行して実行します。
クラウド実行はローカル実行やCI実行よりも詳細な診断情報を収集するため、このコマンドはテスト失敗をより詳しく調査するのに最適です。
オプション
すべてのオプションの一覧（ブラウザやブランチ設定を含む）については、mabl tests run-cloud -hを実行してください。最低限、以下のオプションのいずれかを使用して、実行するテストを指定してください：
| オプション | 説明 |
--id |
実行するテストのID |
--labels |
スペース区切りのラベルリストに一致するテストを実行する |
出力
mabl CLIは、アプリ内でテスト出力を表示するリンクを出力します。
例
# Trigger a cloud run of a test that failed locally mabl tests run-cloud --id [test-id] # Trigger cloud runs of tests that failed in a CI build mabl tests run-cloud --labels follow-up
mabl tests run
mabl tests run コマンドを使用して、ブラウザまたはAPIテストを1つ以上ローカルマシンまたはCI環境で実行します。mabl CLIは、クラウドクレジットを消費せずに迅速な成功/失敗のフィードバックを返します。
ローカル実行とCI実行は迅速なフィードバックを提供するため、このコマンドはパイプラインの開発段階で個々のテストの迅速な反復とデバッグに理想的です。シーケンシャル実行は、大規模なテストスイートにはこのコマンドの効率を低下させます。
オプション
このコマンドのオプションの全リストを表示するには、CLIでmabl tests run -hを実行してください。最低限、どのテストを実行するかを指定するために、次のオプションのいずれかを使用してください。
| オプション | 説明 |
--id |
実行するテストのID |
--run-id |
設定を取得するテスト実行のID |
--labels |
スペース区切りのラベルのリストに一致するテストを実行します。 |
--exclude-labels |
スペースで区切られたラベルのリストに一致するテストを除外します。--labelsオプションと併用してください。 |
--from-plan-id |
特定のプランに関連するテストを実行します。これはクラウドでのプラン実行とは異なることに注意してください：ステージ、ブラウザ設定、共有変数などの高度なプラン設定は適用されません。テストは mabl アプリのプラン詳細ページに表示される順序で順次実行されます。すべてのテストは、プランのアプリケーションと環境に関連付けられた URL を基本 URL として使用します。プランが複数の URL で構成されている場合、mabl CLI はそれらの URL の1つを使用します。--url オプションを含める場合、グループ内のすべてのテストはこの URL を使用します。 |
使用 --from-plan-id--from-plan-idオプションは高度なプラン設定や並列実行を適用しないため、ローカル実行用に単一ステージのみを含む指定されたプランを作成することをお勧めします。指定されたローカルプランのテストは、すべて同じ基本URLを使用するため、ブラウザまたはAPIのいずれか一種類のみであるべきです。
出力
デフォルトでは、mabl CLIは結果を直接ターミナルにのみ出力します。テスト出力の結果をmablアプリに公開するには、引数mablを指定して--reporterオプションを含めてください。
mabl tests run --id [test-id] --environment-id [env-id] --application-id [app-id] --reporter mabl
mablにローカル実行結果を公開する方法について詳しくは、統合レポーターに関する記事をご覧ください。
Examples
# Trigger a headless local run mabl tests run --id [test-id] --headless true # Trigger a local run for tests that match labels mabl tests run --labels smoke needs-review # Trigger local test runs associated with a plan mabl tests run --from-plan-id [plan-id]
ブラウザサポート
ブラウザテストの実行は、あなたのマシンにインストールされているChromeブラウザを使用します。
異なるChromiumブラウザを使用するには、コマンドmabl config set browser.path [path-to-browser]を使用してブラウザパスを更新してください。ブラウザパスの設定を誤ると、ローカルテストの実行ができなくなる可能性があることに注意してください。
mabl tests run-mobile
mabl tests run-mobileを使用して、ローカルマシンで1つ以上のモバイルテストを実行します。mabl CLIは、クラウドクレジットを消費せずに迅速な成功/失敗のフィードバックを出力します。
ローカル実行は迅速に実行されるため、このコマンドは開発中にモバイル固有の機能に関する素早いフィードバックを得るのに最適です。逐次実行のため、このコマンドは大規模なテストスイートには効率的ではありません。
セットアップ
mabl CLIからモバイルテストをローカルで実行するには、次のセットアップが必要です。
-
mabl config install mobile-toolsを実行して、AndroidおよびiOSアプリと連携するために必要なソフトウェアコンポーネントをダウンロードしてインストールします。 - モバイルビルドファイルをローカルマシンにダウンロードしてください。
オプション
オプションの全リストを表示するには、mabl tests run-mobile -hを実行してください。実行するモバイルテストを指定するには、次のオプションのいずれかを使用してください。
| オプション | 説明 |
--id |
このIDに一致するモバイルテストを実行してください |
--labels |
スペースで区切られたラベルのリストに一致するモバイルテストを実行します |
出力
mabl CLIはテストの出力を直接ターミナルに表示します。
Examples
# Run an Android test mabl tests run-mobile --id [test-id] --app-file [relative-path-to-file] --platform android # Run a set of iOS tests associated with the label "wip" mabl tests run-mobile --labels wip --app-file [relative-path-to-file] --platform ios