Test case per i file di parametri

Questo articolo descrive i test eseguiti con il toolkit di test dei modelli per file di parametri. Ad esempio, un file denominato azuredeploy.parameters.json. Gli esempi includono i nomi di test e i codici esempio che superano o falliscono i test. Per ulteriori informazioni su come eseguire i test o su come eseguire un test specifico, consultare Parametri di test.

Il toolkit include test case per modelli di Azure Resource Manager (modelli di ARM) e file di modello principali denominati azuredeploy.json o maintemplate.json.

Usare contentVersion valido

Nome test: DeploymentParameters deve avere ContentVersion

contentVersion deve contenere una stringa nel formato 1.0.0.0 e utilizzare solo numeri.

Il seguente esempio ha esito negativo perché contentVersion è mancante.

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

Il seguente esempio ha esito negativo perché contentVersion non è una stringa.

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

Il seguente esempio ha esito positivo.

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

Il file deve includere parametri

Nome test: DeploymentParameters deve avere parametri

Un file di parametri deve includere la sezione parameters.

Il seguente esempio ha esito negativo.

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

Il seguente esempio ha esito positivo.

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

Usare la versione valida dello schema

Nome test: DeploymentParameters deve avere uno schema

Il file di parametri deve includere una versione dello schema valida.

Esistono due versioni dello schema valide per file di parametri:

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

Il seguente esempio ha esito negativo.

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

Il seguente esempio ha esito positivo.

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

I parametri devono contenere valori

Nome test: DeploymentParameters deve avere valore

Un parametro deve contenere un value o un reference. Per segreti, ad esempio password, un insieme di credenziali delle chiavi usa un reference nel file dei parametri. Per altre informazioni, vedere Usare Azure Key Vault per passare valori di parametro protetti durante la distribuzione.

Il seguente esempio ha esito negativo perché stgAcctName non dispone di un value.

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

Il seguente esempio ha esito positivo.

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

Passaggi successivi