- Inicio
- Plantillas
- App de Next.js: despliegue controlado en staging y después producción
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.
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
| Paso | Agente |
|---|---|
| UI plan | UI Designer |
| Implement | Builder |
| Code review | Reviewer |
| Behavior test | Tester |
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:
| Campo | Valor de ejemplo |
|---|---|
| Deploy webhook URL | https://deploy.example.com/hooks/web-staging |
| Environment | staging |
| Signing secret | una 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.
Relacionado
- Despliegues controlados de cambios de IA, con registros de rollback
- Despliegues controlados
- Hacer rollback de un despliegue
- PR de Next.js: tres revisiones, tus pruebas y una comprobación de publicación en la CI
- Plantilla de postmortem de incidente para un cambio escrito por IA
- Funcionalidad full-stack: de los requisitos a la documentación de usuario en una sesión
- Todas las plantillas