az logicapp test
Note
このリファレンスは、Azure CLI (バージョン 2.67.0 以降) の logicapp 拡張機能の一部です。 拡張機能は、 az logicapp test コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
ローカル ネイティブ SDK テスト プロジェクトをスキャフォールディング、検査、および明示的に実行します。
ソースのみのネイティブ MSTest スキャフォールディングを作成します。プランは読み取り専用のままです。 run には、明示的な SDK 用語とプロジェクト信頼の確認が必要です。復元は個別にオプトインされます。 ネイティブ テスト コードとビルド/復元ターゲットは、任意のコードと連絡先サービスを実行できます。 サンドボックスまたはネットワークの分離は提供されません。 名前付き/アクティブなローカル コンテキストでは、プロジェクトの既定値が提供され、クラウド ランタイムターゲットやログインは提供されません。
コマンド
| Name | 説明 | 型 | 状態 |
|---|---|---|---|
| az logicapp test create |
パッケージを復元したり、コードを実行したりせずに、ネイティブ SDK テスト プロジェクトをスキャフォールディングします。 |
Extension | GA |
| az logicapp test plan |
境界付きのバージョン管理されたローカル プレフライト レポートを生成する。テストを実行しないでください。 |
Extension | GA |
| az logicapp test results |
保存されたプレフライトまたはサニタイズされたネイティブ テスト レポートを検査します。 |
Extension | GA |
| az logicapp test results show |
テストを再実行したり、埋め込みパスに従ったりせずに、保存された JSON テスト レポートを検査します。 |
Extension | GA |
| az logicapp test run |
期限を指定して、レビューされたネイティブ SDK/MSTest テストを明示的にビルドして実行します。 |
Extension | GA |
az logicapp test create
パッケージを復元したり、コードを実行したりせずに、ネイティブ SDK テスト プロジェクトをスキャフォールディングします。
net8.0 MSTest プロジェクト、SDK 1.0.3/engine 1.165.50/MSTest 4.0.2 参照、.NET 8 選択、reviewed-source NuGet 構成、空のトリガー フィクスチャを含む新しい Tests/WORKFLOW ディレクトリを書き込みます。 既存のディレクトリは拒否されます。 相対 --output-path では、選択したローカル プロジェクトが使用されます。 SDK バイナリ、資格情報、またはプロジェクト設定はコピーされません。 スターターは無視され、作成者がフィクスチャをレビューし、外部操作をモックして実際のビジネス アサーションを書き込むまで、不確定として保護されます。
az logicapp test create --workflow
[--acquire-policy-token]
[--change-reference]
[--context]
[--output-path]
[--path]
[--trigger]
例
アクティブなローカル プロジェクトのワークフローのスキャフォールディング テスト。
az logicapp test create --workflow Orders
パッケージを復元せずに、新しいプロジェクト相対ディレクトリにスキャフォールディングします。
az logicapp test create --path .\App --workflow Orders --output-path .\Tests\Orders
必須パラメーター
1 つの明示的なローカル ワークフロー ディレクトリ名。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは、ローカル テスト プロジェクトを提供できません。
新しいテスト ディレクトリ。 相対パスでは、選択したプロジェクトが使用されます。既定のテスト/ワークフロー。 既存のディレクトリは拒否され、上書きされません。 復元または実行なし。
既存のローカル標準プロジェクト。 既定では、名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリが使用されます。 明示的なパスは、暗黙的なアクティブ コンテキストをバイパスします。
モックする既存のワークフロー トリガー。 複数のトリガーが存在する場合にのみ必要です。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az logicapp test plan
境界付きのバージョン管理されたローカル プレフライト レポートを生成する。テストを実行しないでください。
標準ワークフロー バイト、制限付き最上位レベルの構造体、およびリテラル構成宣言を検査します。 明示的なテスト プロジェクト(存在する場合は既定のテスト作成プロジェクト)は XML メタデータのみです。 有効なオーサリングの場合でも、notExecuted マーカーを出力します。 終了 0 は、計画が成功したことを意味し、テストに合格することはありません。 --strict は、ブロックされた実行ゲートに対して 4 を終了します。 その他の出口: 1 つのオーサリング、3 つの入力、5 つの変更された入力、6 つのパブリケーション・エラー。 --path は、名前付きまたはアクティブなローカル コンテキストからプロジェクト パスをオーバーライドします。それ以外の場合は、現在のディレクトリが使用されます。 クラウド コンテキストは、ローカル プロジェクトを提供できません。 明示的な --path は、アクティブなコンテキストをバイパスします。--path を使用しても、名前付きクラウド --context は拒否されます。 CLI 引数とコンテキスト解決エラーは、レポートを使用できるようになる前に発生します。 既定の stdout のみ。--report-path は、サニタイズされたレポートを既存のディレクトリに書き込みます。 相対レポート パスでは、シェルの現在のディレクトリではなく、選択したプロジェクトが使用されます。絶対レポート パスは変更されません。 グローバル出力/クエリ フラグは、診断 0 以外の終了前に機能します。
az logicapp test plan --workflow
[--acquire-policy-token]
[--change-reference]
[--context]
[--force]
[--path]
[--report-path]
[--strict]
[--test-project]
例
ファイルを変更せずに、1 つのワークフローを検査します。
az logicapp test plan --path .\App --workflow Orders --output json
ファイルを変更せずに、アクティブなローカル コンテキスト内の 1 つのワークフローを検査します。
az logicapp test plan --workflow Orders --output json
名前付きローカル プロジェクトの既存の Reports ディレクトリにレポートを保存します。
az logicapp test plan --context development --workflow Orders --report-path .\Reports\plan.json
宣言されたテスト メタデータを検査し、プレフライト レポートを保存します。
az logicapp test plan --path .\App --workflow Orders --test-project .\Tests\App.csproj --report-path .\Reports\plan.json
プレフライト レポートを生成し、実行ゲートがブロックされたままの場合は呼び出しに失敗します。
az logicapp test plan --path .\App --workflow Orders --strict --output json
必須パラメーター
1 つの明示的なローカル ワークフロー ディレクトリ名。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
名前付きローカル プロジェクト コンテキスト。 --path を省略すると、既定でアクティブ なコンテキストが使用されます。 ランタイムまたはクラウド操作は実行されません。
既存の標準レポートのみを置き換えます。 --report-path が必要です。SDK の復元または実行を承認できません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
既存のローカル標準プロジェクト。 ローカル コンテキスト パスをオーバーライドします。は、既定で名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリに設定されます。 クラウド コンテキストは、ローカル プロジェクトを提供できません。
省略可能な .json レポート。 相対パスでは、選択したローカル プロジェクトが使用されます。絶対パスは変更されません。 親が存在する必要があります。 既定の stdout のみ。ディレクトリは作成されません。
計画が正常に完了した後にブロックされた実行ゲートの場合は、4 を終了します。 既定の出口 0 は、テストに合格せず、プランが生成されたことを意味します。SDK の実行はブロックされたままです。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
XML としてのみ検査するオプションの既存の .csproj。それ以外の場合は、既定のテスト作成プロジェクトが存在する場合に検査します。 MSBuild/インポートの評価またはテストの検出はありません。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az logicapp test run
期限を指定して、レビューされたネイティブ SDK/MSTest テストを明示的にビルドして実行します。
毎回 --accept-sdk-terms と --trust-project が必要です。 使用、再配布、データ収集、更新の制限を含む https://www.nuget.org/packages/Microsoft.Azure.Workflows.WebJobs.Tests.Extension/1.0.3/License を確認します。 CLI テレメトリのオプトアウトでは、SDK テレメトリが無効であることが確立されません。 .NET 8 SDK、レビューされた明示的な NuGet 構成、およびプロジェクト プライベート ホーム/キャッシュ/構成ディレクトリを使用します。 グローバル ツールまたは依存関係はインストールされていません。 復元は --restore でのみ許可されます。既存のロックファイルはロックモードを使用します。 ビルドとテストの両方で、それ以外の場合は --no-restore を使用します。 Imports/targets/test コードは引き続き任意の操作を実行できます。これらのコントロールはセキュリティ サンドボックスではありません。 既定のプロジェクトは、選択したローカル プロジェクトの下にある Tests/WORKFLOW/Workflow.Tests.csproj です。 明示的な --test-project 入力と --nuget-config 入力ではシェル CWD が使用されます。 相対レポート変換先では、選択したローカル プロジェクトが使用されます。 既存のレポートは拒否されます。 生のネイティブ stdout/stderr は破棄され、機密性の高い生の TRX はテスト プロジェクトの .logicapp-test-state/runs/INVOCATION_ID/native.trx に残ります。 nativeTestsPassed を生成できるのは、有界で一貫性のある完了した TRX カウントのみです。 空または完全にスキップされたスイートは 7 を終了し、期限の有効期限は 8、クリーンアップは保留中の 9 です。 その他の出口: 1 つのネイティブ テスト失敗、2 つのランナー/依存関係エラー、3 つのローカル入力、4 つの欠落した受信確認、5 つの観察された入力ドリフト、6 つのパブリケーション、130 の中断。 カウントは、SDK と呼ばれる任意のテスト コード、または選択したワークフローをカバーしていることを証明しません。 モック作成は、エグレスの実行またはコネクタの認定を拒否されません。
az logicapp test run --workflow
[--accept-sdk-terms]
[--acquire-policy-token]
[--change-reference]
[--context]
[--nuget-config]
[--path]
[--report-path]
[--restore]
[--test-project]
[--timeout]
[--trust-project]
例
SDK の用語を確認した後、作成されたレビュー済みの合成テスト プロジェクトを復元して実行します。
az logicapp test run --path .\App --workflow Orders --accept-sdk-terms --trust-project --restore
以前に復元したプロジェクトを実行し、新しいサニタイズされたレポートを保存します。
az logicapp test run --workflow Orders --accept-sdk-terms --trust-project --report-path .\Reports\native.json
必須パラメーター
1 つの明示的なローカル ワークフロー ディレクトリ名。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
Microsoft Logic Apps Tests SDK 1.0.3 の使用、データ収集、およびこの呼び出しの更新条件を確認します。 再配布を承認しません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは、ローカル テスト プロジェクトを提供できません。
--restore でのみ使用される NuGet 構成を確認しました。 明示的な相対入力ではシェル CWD が使用されます。テスト プロジェクトの横にある既定の NuGet.Config。 CLI では、継承されたユーザー フィード/資格情報の構成は選択されません。
既存のローカル標準プロジェクト。 既定では、名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリが使用されます。 明示的なパスは、暗黙的なアクティブ コンテキストをバイパスします。
省略可能な新しいサニタイズされた .json レポート。相対パスでは、選択したローカル プロジェクトが使用されます。 親が存在する必要があります。 既存の宛先は拒否されます。 生のローカル TRX はエクスポートされません。
プロジェクトプライベート キャッシュへのネイティブ NuGet の復元を明示的に許可します。 既存のロックファイルはロックモードを使用します。 このフラグがない場合は、--no-restore を使用してビルド/テストを実行します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
既存のネイティブ MSTest .csproj。 明示的な相対入力ではシェル CWD が使用されます。 既定では、選択したプロジェクト Tests/WORKFLOW/Workflow.Tests.csproj が使用されます。
ネイティブ ツールチェーン/復元/ビルド/テスト期限の合計(1 ~ 3600 秒)。 ID チェックのクリーンアップには、追加の時間がかかる場合があります。
| プロパティ | 値 |
|---|---|
| 規定値: | 300 |
レビューされたプロジェクト、復元/ビルド ターゲット、テスト コードで任意のコードと連絡先サービスを実行できることを確認します。 モックキャッシュとプライベート キャッシュはサンドボックスではありません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |