Instrucciones de using y using none

Una declaración using o una declaración using none debe estar presente en todos los archivos de parámetros de Bicep.

Un archivo de parámetros de Bicep normalmente usa una using instrucción para vincular el archivo a un archivo de Bicep, una plantilla json de Azure Resource Manager (plantilla de ARM), un módulo de Bicep o una especificación de plantilla. Esta vinculación permite que el compilador y el servidor del lenguaje Bicep validen la comprobación de archivos de parámetros para 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. Esto 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. Esto desacopla el archivo de parámetros de una plantilla determinada, lo que permite una mayor flexibilidad en cómo se definen y usan los parámetros en todas las implementaciones.

Sintaxis de la using none instrucción :

using none

Esta instrucción se coloca 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 el uso de 'none' puede actuar como un almacén central para estos valores compartidos, mejorando la coherencia y minimizando la duplicación. Estos parámetros se pueden combinar mediante programación 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'
  

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

  En canalizaciones de CI/CD o scripts de automatización, los archivos de parámetros se pueden crear sobre la marcha o asociarse con 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.

Cuando using none se especifica en un archivo de parámetros de Bicep, el compilador no valida los parámetros en una plantilla de Bicep específica, lo que significa que no se generan advertencias o errores en tiempo de compilación para nombres o tipos no coincidentes debido a la ausencia de una plantilla vinculada. Sin embargo, este desacoplamiento solo se aplica durante la creación y compilación; en el momento de la implementación, Azure Resource Manager (ARM) todavía requiere tanto una plantilla de Bicep como 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.