Partilhar via


Casos de teste para arquivos de parâmetros

Este artigo descreve os testes que são 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 passam ou falham nos testes. Para obter mais informações sobre como executar testes ou como executar um teste específico, consulte Parâmetros de teste.

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

Usar uma versão válida de conteúdo

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 falha porque o contentVersion está faltando.

{
  "$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 passa.

{
  "$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 falha.

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

O exemplo a seguir passa.

{
  "$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 válida do esquema.

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 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 passa.

{
  "$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âmetros. 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 passa.

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

Próximos passos