Compartilhar via

Casos de teste para arquivos de parâmetro

  • Artigo

Este artigo descreve os testes que são executados com o kit de ferramentas de teste do modelo para arquivos de parâmetro. Por exemplo, um arquivo chamado azuredeploy.parameters.json. Os exemplos incluem os nomes de teste e exemplos de código que aprovam ou reprovam os testes. Para obter mais informações sobre como executar testes ou como executar um teste específico, confira Parâmetros de teste.

O kit de ferramentas inclui casos de teste para modelos do ARM (modelos do Azure Resource Manager) e os arquivos de modelo principais chamados azuredeploy.json ou maintemplate.json.

Usar contentVersion válido

Nome do teste: DeploymentParameters deve ter ContentVersion

O contentVersion deve conter uma cadeia de caracteres no formato 1.0.0.0 e usar apenas números.

O exemplo a seguir é reprovado porque o contentVersion está ausente.

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

O exemplo a seguir é reprovado porque o contentVersion não é uma cadeia de caracteres.

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

O exemplo a seguir é aprovado.

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

O arquivo deve incluir parâmetros

Nome do teste: DeploymentParameters deve ter Parameters

Um arquivo de parâmetro deve incluir a seção parameters.

O exemplo a seguir é reprovado.

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

O exemplo a seguir é aprovado.

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

Usar versão válida do esquema

Nome do teste: DeploymentParameters deve ter Schema

O arquivo de parâmetro deve incluir uma versão válida do esquema.

Há duas versões válidas do esquema para arquivos de parâmetro:

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

O exemplo a seguir é reprovado.

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

O exemplo a seguir é aprovado.

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

Os parâmetros devem conter valores

Nome do teste: DeploymentParameters deve ter Value

Um parâmetro deve conter um value ou um reference. Para segredos como uma senha, um cofre de chaves usa um reference no arquivo de parâmetro. Para saber mais, confira Usar o Azure Key Vault para passar um valor de parâmetro seguro durante a implantação.

O exemplo a seguir é reprovado porque o stgAcctName não tem um value.

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

O exemplo a seguir é aprovado.

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

Próximas etapas