次の方法で共有


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

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

次のステップ