Freigeben über


Testfälle für Parameterdateien

In diesem Artikel werden die Tests beschrieben, die mit dem Vorlagentesttoolkit für Parameterdateien ausgeführt werden. Eine Datei mit dem Namen azuredeploy.parameters.json. Die Beispiele umfassen die Testnamen und Codebeispiele, die die Tests bestehen (pass) oder nicht bestehen (fail). Weitere Informationen zum Ausführen von Tests oder zum Ausführen eines bestimmten Tests finden Sie unter "Testparameter".

Das Toolkit enthält Testfälle für Azure Resource Manager-Vorlagen (ARM-Vorlagen) und die Hauptvorlagendateien namens azuredeploy.json oder maintemplate.json.

Verwenden einer gültigen contentVersion

Testname: DeploymentParameters sollte ContentVersion aufweisen.

Sie contentVersion müssen eine Zeichenkette im Format 1.0.0.0 enthalten und dürfen nur Zahlen verwenden.

Im folgenden Beispiel tritt ein Fehler auf , da der contentVersion fehlt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Das folgende Beispiel schlägt fehl , da contentVersion es sich nicht um eine Zeichenfolge handelt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": {},
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Das folgende Beispiel besteht den Test.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Die Datei muss Parameter enthalten

Testname: DeploymentParameters sollte über Parameter verfügen

Eine Parameterdatei muss den parameters Abschnitt enthalten.

Das folgende Beispiel besteht den Test nicht.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
}

Das folgende Beispiel besteht den Test.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Verwenden einer gültigen Schemaversion

Testname: DeploymentParameters sollte das Schema haben

Die Parameterdatei muss eine gültige Schemaversion enthalten.

Es gibt zwei gültige Schemaversionen für Parameterdateien:

  • https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#
  • https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#

Das folgende Beispiel besteht den Test nicht.

{
  "$schema": "https://schema.management.azure.com/schemas/2021-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Das folgende Beispiel besteht den Test.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Parameter müssen Werte enthalten

Testname: DeploymentParameters sollte den Wert haben.

Ein Parameter muss ein oder value ein .reference Für Geheimnisse, wie z. B. ein Kennwort, verwendet ein Schlüsseltresor a reference in der Parameterdatei. Weitere Informationen finden Sie unter Verwenden von Azure Key Vault zum Übergeben eines sicheren Parameterwerts während der Bereitstellung.

Das folgende Beispiel schlägt fehl , da stgAcctName nicht über eine value.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {}
  }
}

Das folgende Beispiel besteht den Test.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stgAcctName": {
      "value": "demostorage01"
    }
  }
}

Nächste Schritte