パラメーター ファイルのテスト ケース

この記事では、パラメーター ファイル用のテンプレート テスト ツールキットで実行されるテストについて説明します。 たとえば、 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"
    }
  }
}

次のステップ