Testfall för parameterfiler

  • Artikel

Den här artikeln beskriver de tester som körs med malltestverktyget för parameterfiler. Till exempel en fil med namnet azuredeploy.parameters.json. Exemplen innehåller testnamn och kodexempel som klarar eller misslyckas med testerna. Mer information om hur du kör tester eller hur du kör ett visst test finns i Testparametrar.

Verktygslådan innehåller testfall för Azure Resource Manager-mallar (ARM-mallar) och huvudmallfilerna med namnet azuredeploy.json eller maintemplate.json.

Använda giltig contentVersion

Testnamn: DistributionParametrar ska ha ContentVersion

contentVersion Måste innehålla en sträng i formatet 1.0.0.0 och endast använda tal.

Följande exempel misslyckas eftersom saknas contentVersion .

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

Följande exempel misslyckas eftersom contentVersion det inte är en sträng.

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

Följande exempel godkänns.

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

Filen måste innehålla parametrar

Testnamn: DistributionParametrar ska ha parametrar

En parameterfil måste innehålla avsnittet parameters .

Följande exempel misslyckas.

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

Följande exempel godkänns.

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

Använda giltig schemaversion

Testnamn: DeploymentParameters bör ha schema

Parameterfilen måste innehålla en giltig schemaversion.

Det finns två giltiga schemaversioner för parameterfiler:

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

Följande exempel misslyckas.

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

Följande exempel godkänns.

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

Parametrar måste innehålla värden

Testnamn: DeploymentParameters bör ha värde

En parameter måste innehålla en value eller en reference. För hemligheter som ett lösenord använder ett nyckelvalv en reference i parameterfilen. Mer information finns i Använda Azure Key Vault för att skicka säkert parametervärde under distributionen.

Följande exempel misslyckas eftersom stgAcctName inte har en value.

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

Följande exempel godkänns.

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

Nästa steg