このリポジトリのコードは、Azure Resource Manager テンプレートの分析とテストに使用できます。テストでは、コーディングのベスト プラクティスについて 1 つまたは複数のテンプレートをチェックします。単純な構文エラーのチェックがいくつかありますが、その目的は、プラットフォーム (/validate API など) によって提供されるテストやチェックを再実装することではありません。
注: 0.10 リリース以降、Bicep には TTK に含まれるすべてのdeploymentTemplate テスト ケースが含まれるようになりました。新しいテストへの投資を Bicep リンターに移し始める予定です。 TTK は、利用可能な JSON および createUiDefinition シナリオをサポートするために引き続き利用できます。
arm-ttk の使用方法の詳細については、この Readme を参照してください。詳細については、ドキュメントを参照してください。
arm-ttk のガイド付きチュートリアルについては、この MS LEARN モジュールをチェックしてください。
テストについて少し説明します。これらは、Azure QuickStart Repo と Azure Marketplace のテンプレートを検証するために使用されるテストです。その目的は、テンプレート言語を使用した専門知識の開発を容易にする (読みやすく、書きやすく、デバッグしやすい) コーディング プラクティスの標準または一貫したセットを確保することです。
テストでチェックする必要があるテストの種類、数、性質については、次のカテゴリにあります (思いついたらさらに追加してください:))
すべてが普遍的なテスト セットに適しているわけではなく、すべてのテストがすべてのシナリオに適用されるわけではないため、フレームワークを使用すると、テストを簡単に拡張して個別に選択できます。
テストは PowerShell で直接実行することも、ラッパー スクリプトを使用してコマンド ラインから実行することもできます。
. arm-ttk.tests.ps1 を使用して、すべての単体テストを実行できます。
これにより、テスト json ファイルに対して単体テストの完全なスイートが実行されます。
使用:
# set your location in the project directory:
Set-Location -Path "$(YourGithubProjectFolder)arm-ttkunit-tests"
# import the module from the current branch, use -Force to make sure you have imported any code changes
Import-Module ..arm-ttkarm-ttk.psd1 -Force
# These are the same tests that run in the pipeline when doing a commit or a pull request (PR).
.arm-ttk.tests.ps1
このプロジェクトは貢献と提案を歓迎します。ほとんどの投稿では、投稿を使用する権利をお客様が有しており、実際に当社に付与することを宣言する投稿者ライセンス契約 (CLA) に同意する必要があります。詳細については、https://cla.opensource.microsoft.com をご覧ください。
プル リクエストを送信すると、CLA ボットが CLA を提供する必要があるかどうかを自動的に判断し、PR を適切に装飾します (ステータス チェック、コメントなど)。ボットが提供する指示に従ってください。 CLA を使用するすべてのリポジトリでこれを 1 回行うだけで済みます。
このプロジェクトはマイクロソフトのオープンソース行動規範を採用しています。
詳細については、「行動規範に関するよくある質問」を参照するか、追加の質問やコメントがあれば [email protected] までお問い合わせください。