# Bicep

## Qué es

Bicep es un lenguaje de Microsoft para describir la infraestructura Azure como texto: qué recursos existen, cómo se llaman, cómo se configura cada uno y cómo se conectan entre sí. Un archivo Bicep no enumera pasos. Declara el resultado final, y Azure Resource Manager, la capa por la que pasan las solicitudes de gestión de Azure, calcula qué crear, cambiar o conservar para alcanzarlo. Quien pregunta qué es Bicep suele querer saber si sustituye a recorrer el portal Azure haciendo clic. Lo hace, y ahí reside la mayor parte de su valor.

Por debajo, Bicep es una forma más cómoda de escribir algo que Azure ya entendía. Resource Manager acepta desde hace tiempo plantillas de despliegue escritas en JSON, que son completas pero difíciles de leer y aún más de revisar. Durante un despliegue, la herramienta de línea de comandos de Bicep convierte un archivo `.bicep` en una de esas plantillas JSON, y Resource Manager la despliega exactamente como desplegaría una plantilla JSON escrita a mano. Microsoft afirma que Bicep admite todos los tipos de recursos y versiones API en cuanto los introduce un proveedor de recursos, incluidas las versiones preliminares, por lo que un servicio nuevo se puede utilizar sin esperar a que alguien actualice un plugin. Las plantillas JSON existentes pueden descompilarse a Bicep, lo que convierte trasladar un entorno antiguo en un trabajo mecánico en vez de una reescritura.

Un archivo pequeño muestra la estructura. Primero aparecen los parámetros y después los recursos, cada uno con un nombre simbólico al que puede referirse el resto del archivo:

```text
param env string
param location string = resourceGroup().location

resource store 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'st${env}${uniqueString(resourceGroup().id)}'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}
```

Cuando otro recurso menciona `store.id`, Bicep deduce que debe esperar a la cuenta de almacenamiento, de modo que nadie escribe el orden a mano, y Resource Manager despliega en paralelo todo lo que no depende de otra cosa. Un archivo puede llamar a otro como módulo, lo que permite describir una sola vez una base de datos con sus reglas de red y reutilizarla donde haga falta. Los valores que difieren según el entorno residen en un archivo `.bicepparam` separado para cada entorno. Microsoft declara expresamente que Bicep es gratuito, de código abierto y que no pretende ser un lenguaje de programación de propósito general: tiene bucles, condiciones y funciones, pero únicamente al servicio de describir recursos.

¿Cómo se compara Bicep con las alternativas? Frente a ARM JSON, es el mismo motor con un código fuente mucho más corto. Frente a Terraform, las principales diferencias son el alcance y el estado: Terraform cubre muchas nubes y mantiene un archivo de estado propio, mientras que el flujo de Azure Resource Manager de Bicep no mantiene un archivo de estado propio, porque Azure almacena el estado del despliegue. Las [extensiones](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension) de Bicep también admiten recursos ajenos a Resource Manager, incluidos Kubernetes y Microsoft Graph. Frente a Pulumi, que describe infraestructura en lenguajes de propósito general como TypeScript o Go, Bicep sacrifica flexibilidad a cambio de un lenguaje más pequeño que se lee con rapidez durante la revisión.

## Por qué importa

La infraestructura construida a mano no tiene historia. Un ajuste cambiado en el portal no deja detrás el motivo, nadie lo revisa antes de hacerlo y reconstruir el entorno después de un mal día depende de que alguien recuerde cada clic. En cuanto la infraestructura se convierte en un conjunto de archivos en el repositorio, obtiene lo que ya tiene el código de aplicación: una pull request, alguien que la revise, un historial y una forma de volver atrás.

La segunda ganancia es la uniformidad. Desarrollo, staging y producción, construidos desde los mismos archivos con parámetros distintos, solo difieren donde los parámetros dicen que deben hacerlo. Los despliegues Bicep son idempotentes, lo que, en palabras de Microsoft, significa que desplegar el mismo archivo muchas veces produce «los mismos tipos de recursos en el mismo estado». Por tanto, un despliegue puede repetirse con seguridad, y un entorno nuevo se obtiene con el mismo comando dirigido a otro grupo de recursos.

La tercera ganancia es la visibilidad antes del cambio. La operación what-if compara un archivo con lo que está en ejecución y enumera cada recurso que crearía, modificaría o eliminaría antes de tocar nada. Combinada con una pull request, esa vista previa convierte la creencia de que solo se cambia una regla del cortafuegos en algo que quien revisa puede comprobar.

Los costes merecen nombrarse. Los recursos admitidos dependen del flujo de despliegue y sus extensiones, por lo que el DNS de otro proveedor o los recursos de una segunda nube pueden seguir necesitando una herramienta aparte. En el flujo de Resource Manager, Bicep describe recursos de Azure; los paquetes y archivos dentro de una máquina virtual corresponden a la gestión de configuración, por ejemplo con Ansible. Y los valores predeterminados de Resource Manager para la eliminación y el redespliegue sorprenden a quienes esperan que una herramienta de estado deseado elimine lo que ya no menciona el archivo, como se explica en el cuarto apartado.

## Cómo se aplica en la práctica

Varios de los proyectos Azure de este sitio se apoyan en Bicep, y tres muestran lo que aporta a un equipo a lo largo del tiempo.

En una plataforma, toda la infraestructura Azure está escrita en Bicep. [Cada entorno sale de las mismas plantillas](/es/portfolio/provisioned-azure-infrastructure-as-code/): api y www como Azure Container Apps, un PostgreSQL Flexible Server, Redis para caché, Front Door con una política WAF delante y la red debajo —VNet, NSG y DNS privado—, con Log Analytics conectado para diagnóstico e imágenes obtenidas del Azure Container Registry del proyecto. Como todo está parametrizado, poner en marcha un entorno nuevo o cambiar uno existente es una pull request. La página describe el resultado como entornos que se volvieron reproducibles y revisables, y una desviación que dejó de ser un misterio porque el código es la fuente de verdad.

Las mismas plantillas sostienen la ruta de publicación. [Las versiones pasan de desarrollo a staging y de ahí a producción](/es/portfolio/owned-end-to-end-platform-deployments-to-azure/), y Bicep mantiene idéntica la infraestructura de destino de un entorno al siguiente, por lo que nunca se promociona una compilación a un lugar sutilmente distinto. La configuración que difiere por entorno se mantiene separada de los secretos, lo que permite que un único artefacto ya construido recorra todas las etapas sin volver a construirlo.

Bicep también contiene parte del plan de recuperación. [La retención de copias de seguridad se configura en Bicep junto a la base de datos que protege](/es/portfolio/implemented-backups-and-disaster-recovery-as-code/), de modo que restaurar a un instante determinado es una propiedad de la plantilla en vez de un ajuste que alguien seleccionó una vez con un clic. El entorno que rodea la base de datos también es código, algo importante porque restaurar datos en un entorno que debe reconstruirse de memoria apenas puede llamarse recuperación. La página enumera después lo que sigue pendiente: la georredundancia está desactivada y el objetivo de tiempo de recuperación es una propuesta, no una medición. Una plantilla muestra qué está configurado; solo un simulacro muestra cuánto tarda una restauración.

## Dónde surgen los problemas

La mayoría de los problemas con Bicep nace de esperar que se comporte como una herramienta que gobierna todo lo que hay en un grupo de recursos. De forma predeterminada solo gobierna lo que menciona el archivo, y únicamente de la forma que el archivo indica.

**Un ajuste cambiado en el portal desaparece en el siguiente despliegue.** Redesplegar un recurso reaplica todas sus propiedades, y cualquier propiedad que omita la plantilla se restablece a su valor predeterminado. Una corrección urgente hecha a mano durante un incidente se deshace en la siguiente publicación rutinaria. Trate el archivo como el estado final completo de cada recurso, escriba en él todos los valores distintos del predeterminado y haga los cambios urgentes mediante una pull request. Los ajustes de denegación de una pila de despliegue pueden bloquear por completo las ediciones ajenas al despliegue.

**Un recurso retirado de la plantilla sigue funcionando y costando dinero.** El modo de despliegue predeterminado es incremental: los recursos del grupo que no menciona el archivo se conservan. Eliminar una base de datos del código la deja en Azure. La respuesta de Microsoft son las pilas de despliegue. Una pila registra los recursos que gestiona, y su ajuste `actionOnUnmanage` decide si uno que desaparece del archivo se desvincula o se elimina. El modo completo también elimina lo que el archivo omite, pero Microsoft lo desaconseja y lo está retirando progresivamente.

**La vista previa what-if enumera cambios que nadie ha hecho.** Una propiedad que el archivo omite, pero que Azure rellena con un valor predeterminado durante el despliegue, puede aparecer como eliminada, y Microsoft llama a esto ruido. Cualquier propiedad cuyo valor proceda de la función `reference` aparece como modificada cada vez, y valores como `utcNow()` o un parámetro seguro solo existen durante el despliegue, por lo que what-if los muestra sin evaluar. Ejecútelo en cada pull request, léalo como un borrador y establezca explícitamente las propiedades ruidosas para que destaquen los cambios reales:

```sh
az deployment group what-if \
  --resource-group rg-staging \
  --template-file main.bicep \
  --parameters staging.bicepparam
```

**Una contraseña aparece en el historial de despliegues.** Un parámetro de cadena ordinario se registra con el despliegue, donde puede verlo cualquiera con acceso de lectura al historial de despliegues. Marque los parámetros secretos con el decorador `@secure()`, que excluye su valor del historial y de los registros, y conserve el secreto en Key Vault en vez de un archivo de parámetros del repositorio.

## Lecturas adicionales

- [Qué es Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview) — la descripción general de Microsoft: el lenguaje, sus ventajas y lo que no pretende ser.
- [Módulos Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/modules) — dividir un despliegue en archivos que se llaman entre sí.
- [Parámetros en archivos Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/parameters) — tipos, decoradores, valores predeterminados y lo que `@secure()` excluye del historial.
- [Modos de despliegue](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes) — modo incremental frente al completo y qué hace cada uno con los recursos que no menciona el archivo.
- [Operación what-if de despliegue Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deploy-what-if) — vista previa de un despliegue, tipos de cambio y fuentes de ruido conocidas.
- [Pilas de despliegue](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deployment-stacks) — gestión de recursos como una unidad, con ajustes de eliminación y denegación.

<https://engineer.company/es/glossary/bicep/>
