az logicapp test
Note
此參考文獻是 Azure CLI(版本 2.67.0 或更高版本)的 logicapp 擴充套件的一部分。 這個擴充功能會在你第一次執行 az logicapp test 指令時自動安裝。 深入了解擴充功能。
架構、檢查並明確執行本地原生 SDK 測試專案。
Create 撰寫純原始碼原生 MSTest 支架;計畫仍為唯讀。 run 需要明確的 SDK 條款與專案信任確認,還原則需另行選擇加入。 原生測試程式碼與建置/還原目標可執行任意程式碼並聯絡服務。 不提供沙盒或網路隔離。 命名/啟用的本地情境提供專案預設值,從不提供雲端執行時目標或登入。
命令
| 名稱 | Description | 類型 | 狀態 |
|---|---|---|---|
| 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 測試專案的支架,無需還原套件或執行程式碼。
會寫一個新的 Tests/WORKFLOW 目錄,包含 net8.0 MSTest 專案、完全相同的 SDK 1.0.3/engine 1.165.50/MSTest 4.0.2 參考、.NET 8 選擇、審查來源的 NuGet 設定以及一個空的觸發夾具。 現有目錄被拒絕。 相對 --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
必要參數
一個明確的本地工作流程目錄名稱。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
命名的在地專案情境。 雲端情境無法提供本地測試專案。
新的測試目錄。 相對路徑使用所選專案;預設測試/工作流程。 現有目錄是拒絕,而非覆寫。 沒有還原或執行。
現有的本地標準專案。 預設是命名/活躍的本地上下文,然後是目前的目錄。 明確路徑會繞過隱含的主動上下文。
現有工作流程觸發模擬。 只有在存在多個觸發條件時才需要。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
az logicapp test plan
製作有界、有版本的本地預檢報告;永遠不要做測試。
檢查標準工作流程位元組、有限頂層結構及字面設定宣告。 明確的測試專案,或預設的測試創建專案(若存在)僅包含 XML 元資料。 輸出 notExecuted 標記,即使是有效的創作也一樣。 出口0代表成功規劃,從未通過測試。 ——嚴格出口4用於封鎖執行閘門。 其他退出:1 次撰寫,3 次輸入,5 次更改輸入,6 次發表錯誤。 --路徑會覆蓋來自命名或活躍本地情境的專案路徑;否則則使用目前的目錄。 雲端情境無法提供本地專案。 明確的 ---路徑會繞過主動上下文;即使有 --路徑,也會拒絕一個命名的雲端 --context。 CLI 的參數與上下文解析錯誤會在報告可用前發生。 預設標準;--report-path 會將經過淨化的報告寫入現有目錄。 相對報告路徑使用所選專案,而非殼層目前的目錄;絕對報告路徑不變。 全域輸出/查詢旗標會在診斷非零退出前運作。
az logicapp test plan --workflow
[--acquire-policy-token]
[--change-reference]
[--context]
[--force]
[--path]
[--report-path]
[--strict]
[--test-project]
範例
檢查一個工作流程而不更改檔案。
az logicapp test plan --path .\App --workflow Orders --output json
在不更改檔案的情況下,檢查一個工作流程在活躍的本地情境中。
az logicapp test plan --workflow Orders --output json
將報告儲存在指定本地專案現有的報告目錄下。
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
必要參數
一個明確的本地工作流程目錄名稱。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
命名的在地專案情境。 當 --path 被省略時,預設為主動上下文。 不執行執行時或雲端操作。
只替換現有的常規報告。 需要 --report-path;無法授權 SDK 還原或執行。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
現有的本地標準專案。 覆蓋本地上下文路徑;預設為命名/活躍的本地上下文,然後是目前目錄。 雲端情境無法提供本地專案。
可選 .json 報告。 相對路徑使用所選的本地專案;絕對路徑不變。 父母必須存在。 預設標準;不會建立目錄。
成功規劃後,出口4是被封鎖的執行閘門。 預設出口0表示計畫生成,而非通過測試;SDK 執行會被封鎖。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
可選的現有 .csproj 僅以 XML 形式檢查;否則,檢查預設測試,當存在時建立專案。 沒有 MSBuild/匯入評估或測試發現。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 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 設定,以及專案私有的 home/cache/config 目錄。 沒有安裝全域工具或依賴性。 僅允許在 --restore;現有的鎖定檔案則使用鎖定模式。 無論是建置還是測試,其他都使用無還原。 匯入/目標/測試程式碼仍可執行任意操作:這些控制並非安全沙盒。 預設專案是 Tests/WORKFLOW/Workflow.Tests.csproj,位於所選本地專案下。 明確的 --test-project 和 --nuget-config 輸入使用 shell CWD。 相對報告目的地則使用所選的在地專案。 現有報告被拒絕。 原始原生 stdout/stderr 會被丟棄,敏感的原始 TRX 則保留在測試專案的 .logicapp-test-state/runs/INVOCATION_ID/native.trx 中。 只有有界且一致的完成 TRX 計數才能產生 nativeTestsPassed。 空置/完全跳過的套房 出口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
必要參數
一個明確的本地工作流程目錄名稱。
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
在此調用時,請確認 Microsoft Logic Apps Tests SDK 1.0.3 的使用、資料收集及更新條款。 不授權再分配。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
自動取得 Azure 原則 令牌以進行此資源操作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
相關變更的 ID 是為此資源操作所參考的。
| 屬性 | 值 |
|---|---|
| 參數群組: | Global Policy Arguments |
命名的在地專案情境。 雲端情境無法提供本地測試專案。
檢視了僅使用 --restore 的 NuGet 設定。 顯式相對輸入使用 shell CWD;預設的 NuGet.Config 放在測試專案旁邊。 CLI 不會選擇繼承的使用者資料/憑證設定。
現有的本地標準專案。 預設是命名/活躍的本地上下文,然後是目前的目錄。 明確路徑會繞過隱含的主動上下文。
可選新增的消毒 .json 報告;相對路徑使用所選的本地專案。 父母必須存在。 現有的目的地則被拒絕。 原生的本地 TRX 不會被匯出。
明確允許原生 NuGet 還原到專案私有快取中。 現有的鎖檔使用鎖定模式。 沒有這個旗標,建置/測試時可以使用 ---no 還原。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
現有原生 MSTest .csproj。 明確的相對輸入使用 shell CWD。 預設為所選專案 Tests/WORKFLOW/Workflow.Tests.csproj。
整個原生工具鏈/還原/建置/測試的截止時間是 1-3600 秒。 身份檢查清理可能需要額外時間。
| 屬性 | 值 |
|---|---|
| 預設值: | 300 |
確認已審查專案、還原/建置目標及測試程式碼可執行任意程式碼並聯絡服務。 模擬和私人快取不是沙盒。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |