Instrucciones de using y using none

Todos los archivos de parámetros de Bicep deben incluir una declaración using o using none.

Normalmente, un archivo de parámetros de Bicep usa una using instrucción para vincular el archivo a un archivo de Bicep, una plantilla de Azure Resource Manager JSON (plantilla de ARM), un módulo de Bicep o una especificación de plantilla. Esta vinculación permite que el servidor de lenguaje y el compilador de Bicep validen el archivo de parámetros comprobando los nombres, tipos y valores necesarios correctos en función de las entradas de la plantilla.

Por el contrario, la using none instrucción indica explícitamente que el archivo de parámetros no está vinculado a ninguna plantilla determinada en tiempo de compilación. Esta instrucción significa que los parámetros no se validan con una plantilla específica y, en su lugar, están diseñados para un uso más general, como ser consumidos por herramientas externas o servir como conjuntos de parámetros compartidos y reutilizables.

La instrucción using

Sintaxis de la using instrucción :

• Para usar archivos de Bicep:

  using '<path>/<file-name>.bicep'
  

• Para utilizar plantillas JSON de ARM:

  using '<path>/<file-name>.json'
  

• Para usar módulos públicos:

  using 'br/public:<file-path>:<tag>'
  

  Por ejemplo:

  using 'br/public:avm/res/storage/storage-account:0.9.0' 
  
  param name = 'mystorage'
  

• Para usar módulos privados:

  using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'
  

  Por ejemplo:

  using 'br:myacr.azurecr.io/bicep/modules/storage:v1'
  

  Para utilizar un módulo privado con un alias definido en un archivo bicepconfig.json:

  using 'br/<alias>:<file>:<tag>'
  

  Por ejemplo:

  using 'br/storageModule:storage:v1'
  

• Para usar especificaciones de plantilla:

  using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>
  

  Por ejemplo:

  using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
  

  Para usar una especificación de plantilla con un alias definido en un archivo bicepconfig.json:

  using 'ts/<alias>:<template-spec-name>:<tag>'
  

  Por ejemplo:

  using 'ts/myStorage:storageSpec:1.0'
  

Instrucciones para using none

Las instrucciones using none en un archivo de parámetros de Bicep (.bicepparam) indican que el archivo no está vinculado a una plantilla específica de Bicep durante la creación o compilación. Esta instrucción desacopla el archivo de parámetros de una plantilla determinada, lo que permite una mayor flexibilidad en la definición y uso de parámetros entre implementaciones.

Sintaxis de la using none instrucción :

using none

Coloque esta instrucción al principio de un archivo de parámetros de Bicep para indicar que no se hace referencia a ninguna plantilla específica.

La principal ventaja de using none en Bicep se encuentra en escenarios en los que los archivos de parámetros se generalizan, comparten o integran dinámicamente con plantillas. Entre los casos de uso comunes se incluyen:

• Repositorios de parámetros centralizados

  Las organizaciones suelen mantener valores de parámetro estándar, como regiones predeterminadas, convenciones de nomenclatura o etiquetas globales, que se usan en varias implementaciones de Bicep. Un archivo de parámetros de Bicep con using none puede actuar como almacén central para estos valores compartidos, lo que mejora la coherencia y minimiza la duplicación. Puede combinar mediante programación estos parámetros con valores específicos de plantilla en tiempo de implementación.

  Por ejemplo, un archivo de parámetros de Bicep compartido podría definir:

  using none
  
  param location = 'westus2'
  param environmentTag = 'production'
  param projectName = 'myApp'
  

  Además, puede ampliar este archivo de parámetros. Para obtener más información, consulte Extensión del archivo de parámetros.

• Generación dinámica e integración en tiempo de ejecución

  En canalizaciones de CI/CD o scripts de automatización, puede crear archivos de parámetros sobre la marcha o asociarlos a plantillas en tiempo de ejecución. Al omitir una referencia de plantilla fija, using none permite que estos archivos permanezcan flexibles y adaptables a diferentes contextos de implementación.

Al especificar using none en un archivo de parámetros de Bicep, el compilador no valida los parámetros contra una plantilla de Bicep específica. Esto significa que el compilador no genera ninguna advertencia en tiempo de compilación ni errores para nombres o tipos no coincidentes debido a la ausencia de una plantilla vinculada. Sin embargo, este desacoplamiento solo se aplica durante la fase de creación y compilación. En el momento de la implementación, Azure Resource Manager (ARM) todavía requiere una plantilla de Bicep y un archivo de parámetros. El motor de ARM realiza la validación durante la implementación mediante la resolución de los parámetros del archivo con los definidos en la plantilla de destino.

Pasos siguientes

• Obtenga información sobre los archivos de parámetros de Bicep en Creación de archivos de parámetros para la implementación de Bicep.
• Obtenga más información sobre la configuración de alias en los archivos bicepconfig.json en Configuración del entorno de Bicep.