AI CodeOps

App de Next.js: despliegue controlado en staging y después producción

Última actualización

Desarrolla un cambio de interfaz de Next.js con UI Implementation, fusiónalo a través del control, llama a tu webhook de despliegue en staging y publica en producción solo después de staging.

Usar esta plantilla

Una página de precios es un cambio que quieres que la gente pruebe antes que los clientes. Esta plantilla desarrolla un cambio de interfaz de Next.js, lo envía a staging a través de tu propio pipeline en cuanto se fusiona y frena producción hasta que staging lo tiene.

Qué agentes se ejecutan

PasoAgente
UI planUI Designer
ImplementBuilder
Code reviewReviewer
Behavior testTester

El UI Designer planifica el diseño, los estados y la accesibilidad (el orden del foco, las etiquetas, el estado pulsado del interruptor). Después del paso Implement, la pasada de código escribe el cambio y el script de pruebas de tu package.json se ejecuta en un sandbox sin conexión. Los pasos Code review y Behavior test leen después el cambio escrito y el resultado de las pruebas, y la revisión de hallazgos lee el diff. Los hallazgos abiertos de gravedad alta o crítica y las pruebas fallidas bloquean, y una persona distinta de la que empezó la sesión aprueba antes de que se abra el pull request, cuando el espacio de trabajo tiene otro aprobador.

Envía las fusiones a staging

Abre Release → Deployments, elige Deploy targets e introduce para el proyecto:

CampoValor de ejemplo
Deploy webhook URLhttps://deploy.example.com/hooks/web-staging
Environmentstaging
Signing secretuna cadena aleatoria que tu pipeline también conoce

Cuando fusionas el pull request desde la consola, primero se vuelve a ejecutar el control de calidad. Después, AI CodeOps envía un POST pr_merged, firmado con X-CodeOps-Signature, y registra un despliegue en curso. Tu pipeline compila y despliega en staging. Una llamada fallida al webhook abre un incidente.

Promociona a producción solo desde staging

Tu pipeline no puede devolver el resultado final, así que, cuando staging esté sano, elige Record deployment: entorno staging, estado succeeded y el Commit SHA que desplegaste. Después, el job de producción pregunta al control:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"commitSHA\":\"$COMMIT_SHA\",\"requireDeployedTo\":\"staging\"}" \
  | jq -e '.allowed == true'

La URL del pull request encuentra la sesión; el SHA de commit tiene que coincidir con el registro de staging. Sin ese registro, la respuesta se deniega: «Not yet deployed to "staging" — promote there before releasing». Consulta despliegues controlados.

Si producción falla, haz el rollback en tu pipeline y marca el despliegue como rolled back, como en rollback. Para la parte de revisión de la misma aplicación, empieza con la plantilla de revisión de PR de Next.js.

Preguntas frecuentes

¿AI CodeOps aloja un entorno de vista previa o de staging?

No. Llama al webhook de despliegue que configuras, y despliega tu propio pipeline. AI CodeOps no guarda credenciales de tu infraestructura.

¿Por qué la comprobación de producción dice que el cambio todavía no está en staging?

Un despliegue por webhook se queda en curso, porque tu pipeline no puede devolver el resultado. Registra el despliegue en staging como correcto, con su SHA de commit, antes de publicar.