AWX en producción: encuestas y aprobaciones para plantillas de trabajo
Introducción: el desafío de operar AWX en producción
Cuando un equipo de operaciones adopta Ansible AWX (la versión comunitaria del anterior Ansible Tower), el primer impulso es crear plantillas de trabajo (Job Templates) que ejecuten playbooks directamente. Esto funciona en laboratorio, pero en producción surge una necesidad crítica: controlar qué se ejecuta, con qué parámetros y quién lo autoriza. Las encuestas (surveys) y las aprobaciones (approvals) son las dos herramientas nativas de AWX que resuelven exactamente este problema.
Este artículo no es un tutorial paso a paso, sino un análisis técnico profundo de cómo usar estas funcionalidades para construir un flujo de trabajo robusto, trazable y seguro. Vamos a explorar la sintaxis de las variables, la lógica de las encuestas y la configuración de nodos de aprobación en plantillas de trabajo, incluyendo ejemplos reales de awx-cli y consideraciones de diseño para entornos productivos.
¿Qué es una encuesta en AWX y cuándo usarla?
Una encuesta es un formulario dinámico que AWX presenta al usuario antes de lanzar una plantilla. En lugar de permitir que el operador edite el extra_vars de forma libre (lo cual es peligroso y propenso a errores), la encuesta define campos con tipos, valores por defecto, validaciones y restricciones. Cada campo de la encuesta se traduce en una variable que se inyecta en el playbook.
En producción, las encuestas son indispensables cuando:
- Deseas restringir los valores posibles de una variable (por ejemplo, solo entornos
dev,stagingoprod). - Necesitas que el operador introduzca datos sensibles (como contraseñas) sin que queden expuestos en el historial de ejecuciones.
- Quieres forzar la entrada de ciertos campos obligatorios antes de cualquier despliegue.
La definición de una encuesta se hace desde la interfaz web o mediante API. Un ejemplo de variable para seleccionar entorno sería un campo de tipo "Multiple Choice" con las opciones dev, staging y prod, y con un valor por defecto de dev. En el playbook, esa variable se referencia como entorno.
Importante: AWX almacena las respuestas de las encuestas en formato JSON dentro de extra_vars. Si defines una encuesta con un campo llamado region, el playbook debe contener la lógica para manejar esa variable, por ejemplo:
# playbook.yml
---
- hosts: "{{ region }}"
vars:
servicio: "{{ nombre_servicio | default('app') }}"
tasks:
- name: Desplegar aplicación
ansible.builtin.debug:
msg: "Desplegando {{ servicio }} en {{ region }}"
En este caso, la encuesta tendría dos campos: region (selección) y nombre_servicio (texto libre). La combinación de ambos permite flexibilidad sin abrir la puerta a una inyección arbitraria de variables.
Aprobaciones: el control de cambios humano en el flujo
Las aprobaciones en AWX son nodos especiales dentro de una Workflow Template (plantilla de flujo de trabajo). A diferencia de una plantilla simple, un workflow puede contener múltiples pasos, condiciones y, crucialmente, un nodo de aprobación que pausa la ejecución hasta que un usuario con permisos específicos la acepte o la rechace.
Este mecanismo es esencial para producción porque introduce un gate humano entre la ejecución de un playbook que modifica sistemas y el impacto real. Por ejemplo, un workflow típico de despliegue podría ser:
- Ejecutar playbook de backup.
- Nodo de aprobación: "Revisar backup y autorizar despliegue".
- Ejecutar playbook de despliegue.
La configuración del nodo de aprobación requiere especificar una descripción y un tiempo de espera (timeout). Si el revisor no responde antes del timeout, la ejecución se cancela o falla según la configuración. En la interfaz, el usuario ve una lista de aprobaciones pendientes en su panel de control.
Para crear un workflow y su nodo de aprobación desde la línea de comandos, se utiliza awx-cli. Primero, definimos la plantilla de trabajo base:
# Crear plantilla de trabajo para despliegue
awx job_templates create \
--name "Desplegar App" \
--job_type run \
--inventory "Prod Inventory" \
--project "Proyecto App" \
--playbook "deploy.yml" \
--ask-vars-on-launch true
Luego, creamos el workflow y añadimos nodos. El nodo de aprobación se crea con el tipo approval. Un ejemplo simplificado usando la API:
# Crear workflow awx workflow_job_templates create --name "Deploy con aprobacion"Crear nodo de aprobacion (se necesita el ID del workflow)
awx workflow_job_template_nodes create
—workflow_job_template “Deploy con aprobacion”
—identifier “aprobacion_1”
—approval_name “Autorizar deploy”
—approval_description “Revisar cambios y aprobar”
—timeout 900
Aquí, el parámetro --timeout 900 establece un límite de 15 minutos. Si no se aprueba en ese tiempo, la ejecución se aborta. En producción, es recomendable usar timeouts generosos (30–60 minutos) para permitir la revisión en horarios de guardia.
Combinando encuestas y aprobaciones: un flujo de despliegue completo
La potencia real surge al combinar ambas características. Una plantilla de trabajo con encuesta captura los parámetros, y el workflow usa esos parámetros para decidir si se necesita una aprobación adicional. Por ejemplo, podrías tener una encuesta en la plantilla de despliegue que pida el entorno (dev, prod). Si el entorno es prod, el workflow debe incluir un nodo de aprobación; si es dev, se omite.
Esto se logra mediante condiciones en los nodos del workflow. AWX permite evaluar expresiones Jinja sobre las variables del job. El nodo de aprobación se configura con una condición como:
{{ job_extra_vars.entorno == 'prod' }}
De esta manera, el nodo de aprobación solo se ejecuta si la variable entorno es igual a prod. El resto de nodos (despliegue, pruebas) se ejecutan si la condición es verdadera o falsa según se defina. Un esquema de workflow en producción sería:
[Backup] -> [Aprobación si entorno == prod] -> [Despliegue] -> [Verificación]
Para configurar la condición desde awx-cli, se debe editar el nodo y añadir el campo when. Ejemplo:
awx workflow_job_template_nodes update \
--id <node_id> \
--when "{{ job_extra_vars.entorno == 'prod' }}"
Es fundamental entender que job_extra_vars contiene todas las variables de la encuesta y las definidas en el lanzamiento. Si la encuesta no define un valor por defecto para entorno, la expresión podría fallar. Por eso, siempre se debe definir un valor por defecto o validar la existencia de la variable en el playbook.
Buenas prácticas para producción
La experiencia en entornos productivos revela varios patrones que evitan incidentes. Primero, nunca uses encuestas para recoger contraseñas si el objetivo es mantenerlas fuera de los logs. Aunque AWX enmascara las respuestas en la interfaz, el historial de ejecuciones puede exponerlas si no se configura correctamente. La solución es usar el sistema de credenciales de AWX (Credential Types) y hacer referencia a ellas en el playbook, no en la encuesta.
Segundo, define tiempos de espera razonables en las aprobaciones. Un timeout demasiado corto (5 minutos) puede provocar que una revisión legítima no se complete, mientras que uno demasiado largo (24 horas) deja la ejecución en un estado "pendiente" que preocupa al equipo. En producción, recomiendo entre 30 y 60 minutos para despliegues y 1–2 horas para cambios de infraestructura.
Tercero, documenta cada aprobación. AWX permite añadir una descripción al nodo de aprobación. Utilízala para indicar qué se debe revisar, quién es el responsable y qué comandos de verificación son útiles. Esto reduce la fricción y mejora la trazabilidad.
Cuarto, integra las aprobaciones con sistemas externos mediante la