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

必須パラメーター

--workflow

1 つの明示的なローカル ワークフロー ディレクトリ名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--context

名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは、ローカル テスト プロジェクトを提供できません。

--output-path

新しいテスト ディレクトリ。 相対パスでは、選択したプロジェクトが使用されます。既定のテスト/ワークフロー。 既存のディレクトリは拒否され、上書きされません。 復元または実行なし。

--path

既存のローカル標準プロジェクト。 既定では、名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリが使用されます。 明示的なパスは、暗黙的なアクティブ コンテキストをバイパスします。

--trigger

モックする既存のワークフロー トリガー。 複数のトリガーが存在する場合にのみ必要です。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須パラメーター

--workflow

1 つの明示的なローカル ワークフロー ディレクトリ名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--context

名前付きローカル プロジェクト コンテキスト。 --path を省略すると、既定でアクティブ なコンテキストが使用されます。 ランタイムまたはクラウド操作は実行されません。

--force

既存の標準レポートのみを置き換えます。 --report-path が必要です。SDK の復元または実行を承認できません。

プロパティ 値
規定値: False
--path

既存のローカル標準プロジェクト。 ローカル コンテキスト パスをオーバーライドします。は、既定で名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリに設定されます。 クラウド コンテキストは、ローカル プロジェクトを提供できません。

--report-path

省略可能な .json レポート。 相対パスでは、選択したローカル プロジェクトが使用されます。絶対パスは変更されません。 親が存在する必要があります。 既定の stdout のみ。ディレクトリは作成されません。

--strict

計画が正常に完了した後にブロックされた実行ゲートの場合は、4 を終了します。 既定の出口 0 は、テストに合格せず、プランが生成されたことを意味します。SDK の実行はブロックされたままです。

プロパティ 値
規定値: False
--test-project

XML としてのみ検査するオプションの既存の .csproj。それ以外の場合は、既定のテスト作成プロジェクトが存在する場合に検査します。 MSBuild/インポートの評価またはテストの検出はありません。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須パラメーター

--workflow

1 つの明示的なローカル ワークフロー ディレクトリ名。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--accept-sdk-terms

Microsoft Logic Apps Tests SDK 1.0.3 の使用、データ収集、およびこの呼び出しの更新条件を確認します。 再配布を承認しません。

プロパティ 値
規定値: False
--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--context

名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは、ローカル テスト プロジェクトを提供できません。

--nuget-config

--restore でのみ使用される NuGet 構成を確認しました。 明示的な相対入力ではシェル CWD が使用されます。テスト プロジェクトの横にある既定の NuGet.Config。 CLI では、継承されたユーザー フィード/資格情報の構成は選択されません。

--path

既存のローカル標準プロジェクト。 既定では、名前付き/アクティブなローカル コンテキスト、次に現在のディレクトリが使用されます。 明示的なパスは、暗黙的なアクティブ コンテキストをバイパスします。

--report-path

省略可能な新しいサニタイズされた .json レポート。相対パスでは、選択したローカル プロジェクトが使用されます。 親が存在する必要があります。 既存の宛先は拒否されます。 生のローカル TRX はエクスポートされません。

--restore

プロジェクトプライベート キャッシュへのネイティブ NuGet の復元を明示的に許可します。 既存のロックファイルはロックモードを使用します。 このフラグがない場合は、--no-restore を使用してビルド/テストを実行します。

プロパティ 値
規定値: False
--test-project

既存のネイティブ MSTest .csproj。 明示的な相対入力ではシェル CWD が使用されます。 既定では、選択したプロジェクト Tests/WORKFLOW/Workflow.Tests.csproj が使用されます。

--timeout

ネイティブ ツールチェーン/復元/ビルド/テスト期限の合計(1 ~ 3600 秒)。 ID チェックのクリーンアップには、追加の時間がかかる場合があります。

プロパティ 値
規定値: 300
--trust-project

レビューされたプロジェクト、復元/ビルド ターゲット、テスト コードで任意のコードと連絡先サービスを実行できることを確認します。 モックキャッシュとプライベート キャッシュはサンドボックスではありません。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False