Casos de prueba para archivos de parámetros

En este artículo se describen las pruebas que se ejecutan con el kit de herramientas de pruebas de plantillas para los archivos de parámetros. Por ejemplo, un archivo denominado azuredeploy.parameters.json. En los ejemplos se incluyen los nombres de las pruebas y los ejemplos de código que pasan o no pasan las pruebas. Para más información sobre cómo ejecutar pruebas o sobre la ejecución de una prueba específica, consulte Parámetros de prueba.

El kit de herramientas incluye casos de prueba para plantillas de Azure Resource Manager (plantillas de ARM) y los archivos principales de plantilla denominados azuredeploy.json o maintemplate.json.

Utiliza la versión válida de contentVersion

Nombre de prueba: DeploymentParameters debe tener ContentVersion

contentVersion debe contener una cadena en el formato 1.0.0.0 y usar solo números.

En el ejemplo siguiente se produce un error porque falta .contentVersion

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

En el ejemplo siguiente se produce un error porque contentVersion no es una cadena.

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

El ejemplo siguiente supera la prueba.

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

El archivo debe incluir parámetros

Nombre de prueba: DeploymentParameters debe tener parámetros

Un archivo de parámetros debe incluir la parameters sección .

El ejemplo siguiente no supera la prueba.

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

El ejemplo siguiente supera la prueba.

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

Uso de la versión de esquema válida

Nombre de prueba: DeploymentParameters debe tener esquema

El archivo de parámetros debe incluir una versión de esquema válida.

Hay dos versiones de esquema válidas para los archivos de parámetros:

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

El ejemplo siguiente no supera la prueba.

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

El ejemplo siguiente supera la prueba.

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

Los parámetros deben contener valores

Nombre de prueba: DeploymentParameters debe tener valor

Un parámetro debe contener un value o un reference. Para secretos como una contraseña, un almacén de claves utiliza un reference en el archivo de parámetros. Para más información, consulte Uso de Azure Key Vault para pasar el valor de parámetro seguro durante la implementación.

El ejemplo siguiente no pasa la prueba porque stgAcctName no contiene un elemento value.

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

El ejemplo siguiente supera la prueba.

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

Pasos siguientes

• Para más información sobre el kit de herramientas para pruebas, consulte Uso del kit de herramientas para pruebas de plantillas de ARM.
• Para las pruebas de plantillas de ARM, consulte Casos de prueba para plantillas de ARM.
• Para las pruebas de createUiDefinition, consulte Casos de prueba para createUiDefinition.json.
• Para información sobre las pruebas de todos los archivos, vea Casos de prueba para todos los archivos.