この記事では、パラメーター ファイル用のテンプレート テスト ツールキットで実行されるテストについて説明します。 たとえば、 azuredeploy.parameters.jsonという名前のファイルです。 例には、テストに合格する、または不合格になるテスト名とコード サンプルが含まれています。 テストを実行する方法、または特定のテストを実行する方法の詳細については、「テスト パラメーター」を参照してください。
このツールキットには、Azure Resource Manager テンプレート (ARM テンプレート) のテスト ケースと、azuredeploy.json または maintemplate.json という名前のメイン テンプレート ファイルが含まれています。
有効な contentVersion を使用する
テスト名: DeploymentParameters に ContentVersion が必要
contentVersionには、1.0.0.0形式の文字列を含め、数値のみを使用する必要があります。
次の例では、が見つからないためcontentVersion。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
が文字列でないため、次の例はcontentVersion。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": {},
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
次の例は合格します。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
ファイルにはパラメーターを含める必要があります
テスト名: DeploymentParameters にはパラメーターが必要です
パラメーター ファイルには、 parameters セクションを含める必要があります。
次の例は不合格になります。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
}
次の例は合格します。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
有効なスキーマ バージョンを使用する
テスト名: DeploymentParameters にスキーマが必要
パラメーター ファイルには、有効なスキーマ バージョンが含まれている必要があります。
パラメーター ファイルには、次の 2 つの有効なスキーマ バージョンがあります。
https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#
次の例は不合格になります。
{
"$schema": "https://schema.management.azure.com/schemas/2021-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
次の例は合格します。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
パラメーターには値を含む必要があります
テスト名: DeploymentParameters に値が必要
パラメーターには、 value または referenceが含まれている必要があります。 パスワードなどのシークレットの場合、キー コンテナーはパラメーター ファイル内の reference を使用します。 詳細については、「 デプロイ時に Azure Key Vault を使用してセキュリティで保護されたパラメーター値を渡す」を参照してください。
次の例は、にstgAcctNameがないためvalue。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {}
}
}
次の例は合格します。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
次のステップ
- テスト ツールキットについては、「ARM テンプレート テスト ツールキットを使用する」を参照してください。
- ARM テンプレート テストについては、 ARM テンプレートのテスト ケースに関するページを参照してください。
- createUiDefinition のテストについては、「createUiDefinition.json のテスト ケース」を参照してください。
- すべてのファイルのテストについては、「すべてのファイルのテスト ケース」を参照してください。