Compartilhar via


Casos de teste para arquivos de parâmetro

Este artigo descreve os testes executados com o kit de ferramentas de teste de 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

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

O exemplo a seguir falha 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 falha porque 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 parâmetros

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

O exemplo a seguir apresenta falha.

{
  "$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 esquema

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

Há duas versões de esquema válidas 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 apresenta falha.

{
  "$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 valor

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 obter mais informações, consulte Usar o Azure Key Vault para passar o valor do parâmetro seguro durante a implantação.

O exemplo a seguir falha porque 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