Vercel

La integración de Vercel vigila tus despliegues de Vercel. Cuando un despliegue está listo, Autonomy ejecuta un caso de prueba o un plan de pruebas de un proyecto contra su URL e informa del resultado como un check en el despliegue. Si el repositorio también está vinculado, el mismo resultado aparece como un check de GitHub en el commit.

Qué hace

• Inicia ejecuciones cuando un despliegue de Vercel está listo, filtradas por tipo de despliegue (preview, production, branch) y por rama.
• Prueba la URL del propio despliegue, en un entorno del proyecto que elegiste.
• Publica un check de despliegue de Vercel llamado Autonomy QA y puede retener la promoción a producción hasta que concluya.
• Inicia una ejecución nueva cuando alguien pulsa Re-run en el check desde Vercel.

Configuración

1. Abre Organization → Integrations → Vercel y pulsa Connect. Vercel te pide que elijas un equipo o una cuenta y que apruebes los permisos solicitados, incluidos los checks de despliegue.
2. Pulsa Link project y elige el proyecto de Vercel que quieres probar. Su definición de check se crea automáticamente.
3. En Project, elige el proyecto de Autonomy cuyas pruebas ejecutan estos despliegues. Si lo cambias más adelante, se borran los valores predeterminados de abajo.
4. En Default test case or plan, elige qué se ejecuta en cada despliegue. Solo aparecen los casos de prueba y planes de pruebas del proyecto.
5. En Default environment, elige el entorno del proyecto. Las ejecuciones usan sus valores e inicios de sesión, con la URL del despliegue como objetivo web. Sin un entorno, los despliegues se omiten.
6. En Trigger on, elige los tipos de despliegue que inician una ejecución, normalmente Preview. Añade Branch filters como main o release/* para limitarlo a algunas ramas.
7. Activa Post a Vercel deployment check. Activa Block deployment promotion until check completes si un check fallido debe retener la promoción.
8. Haz push de un commit y comprueba que se inicia una ejecución cuando la previsualización está lista.

Cómo se inicia una ejecución

Cuando un despliegue está listo, Autonomy:

1. Busca el proyecto de Vercel vinculado y su proyecto de Autonomy. No se ejecuta nada si ese proyecto está archivado.
2. Compara el tipo de despliegue con Trigger on y la rama con Branch filters.
3. Inicia el caso de prueba o el plan de pruebas predeterminado en el entorno predeterminado, contra la URL del despliegue.

Cada despliegue se ejecuta una sola vez. Un webhook que Vercel envía dos veces no inicia una segunda ejecución.

El check

El check se llama Autonomy QA y muestra un enlace a cada ejecución. Concluye como:

Una ejecución fallida hace fallar el check de despliegue, tanto si no se alcanzó su resultado esperado como si el agente no pudo demostrar que se alcanzó. El resumen da el motivo.

Hacer que el check falle por incidencias

Las incidencias nunca cambian el resultado de una ejecución, así que una ejecución superada supera el check aunque haya notificado una incidencia. Para que los bugs también hagan fallar el check de despliegue, activa Fail the check on issues en Settings → Integrations → Pull requests del proyecto. Está desactivado por defecto. Cuando está activado, un Bug abierto que una de las ejecuciones del check encontró o reabrió deja el check en failed: "Failed: a bug was found". Los riesgos y los bugs que resolviste o ignoraste no cuentan. Consulta Pruebas de pull requests.

Bloquear la promoción

Con Block deployment promotion until check completes activado, Vercel no promociona el despliegue a producción hasta que el check concluye. El check expira a los 15 minutos. Una ejecución puede terminar en Autonomy después, pero el check de Vercel ya no cambia.

Volver a ejecutar

Pulsar Re-run en el check desde Vercel inicia ejecuciones nuevas contra el mismo despliegue, con los ajustes actuales del vínculo.

Previsualizaciones protegidas

Si Vercel Deployment Protection está activado, el runner no puede abrir la previsualización sin un bypass:

1. En Vercel, abre Settings → Deployment Protection del proyecto y copia el secreto Protection Bypass for Automation.
2. En Autonomy, abre el proyecto de Vercel vinculado y pégalo en Preview access secret.

Autonomy lo envía en cada petición a las previsualizaciones de ese proyecto. Se guarda como secreto y no se vuelve a mostrar.

Varios proyectos de Vercel

Vincula cada proyecto de Vercel por separado. Cada vínculo tiene su propio proyecto de Autonomy, plan de pruebas, entorno, tipos de disparador y filtros de rama, así que un monorepo con una app web, documentación y un panel de administración puede ejecutar un plan distinto para cada uno.

Solución de problemas

No se inicia ninguna ejecución cuando se despliega una previsualización

Abre el proyecto de Vercel vinculado en Autonomy y revisa los despliegues recientes. Un despliegue omitido indica el motivo:

• project disabled: el vínculo está desactivado.
• context <x> not enabled: el tipo de despliegue no está en Trigger on.
• branch <x> filtered: la rama no coincide con Branch filters.
• no default test target: elige un Default test case or plan.
• "Choose an environment for this deploy link in Autonomy.": elige un Default environment.
• project archived, o un valor predeterminado archivado o de otro proyecto: restaura el proyecto o elige valores predeterminados nuevos.
• no preview URL: Vercel no envió ninguna URL para el despliegue.

Comprueba también que Vercel aparece como Active en Autonomy.

La ejecución no llega a la previsualización

Deployment Protection la está bloqueando. Añade o renueva el Preview access secret.

El check falló pero todas las ejecuciones se superaron

Fail the check on issues está activado y una ejecución encontró un bug. Abre Issues found en la ejecución.

El check muestra neutral

Una ejecución no pudo empezar, por ejemplo porque la previsualización no abrió o bloqueó el navegador de prueba como si fuera un bot. Abre la ejecución para ver el motivo, corrígelo y pulsa Re-run en Vercel.