Control de despliegue (deploy gate)
Última actualización
Un control de despliegue decide si un cambio puede publicarse en un entorno. En qué se diferencia de un control de fusión, y los tres controles de despliegue que te da AI CodeOps.
Un control de despliegue es una comprobación que decide si un cambio puede publicarse en un entorno concreto, como staging o producción. Se ejecuta después de fusionar el código, o como parte del paso de publicación, y puede detener un despliegue que un control de fusión habría dejado pasar.
Qué es
Un control de fusión pregunta «¿este cambio es lo bastante bueno para la rama principal?». Un control de despliegue hace una pregunta más concreta: «¿puede este cambio ir ahora a este entorno?». Las condiciones habituales son reglas de entorno (nada de despliegues automáticos a producción), el orden de promoción (staging antes que producción) y una nueva revisión de las comprobaciones del cambio justo antes de publicar.
Por qué importa
La mayoría de los incidentes empiezan con un despliegue. Las reglas de promoción detectan la publicación que se saltó staging, y las reglas de entorno mantienen la automatización lejos de los lugares donde un error sale más caro. Con los agentes de IA produciendo más cambios, que el paso de publicación compruebe las mismas evidencias que el paso de fusión importa más, no menos.
En AI CodeOps
AI CodeOps no despliega en tu infraestructura. Somete el cambio a los controles, llama a tu webhook de despliegue y registra el despliegue. Hay tres controles de despliegue.
1. El control al fusionar. Cuando fusionas desde la consola el pull request de una sesión, primero se vuelve a ejecutar el control de calidad. Los hallazgos abiertos de gravedad alta o crítica, las pruebas fallidas o una revisión sin terminar detienen la fusión y, con ella, la llamada al webhook de despliegue.
2. Reglas de política por entorno. Una regla release.deploy de la política del espacio de trabajo se compara con el nombre del entorno. Esta detiene los despliegues automáticos a producción:
{ "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" }
Un despliegue denegado nunca se envía. Se registra como canceled, y la fila de Release → Deployments muestra "not deployed" con el motivo. Estas reglas solo pueden permitir o denegar; no pueden esperar a una aprobación.
3. Promoción desde la CI. Tu pipeline puede llamar a POST /api/release/check antes de desplegar, con "requireDeployedTo": "staging". La publicación se deniega salvo que el cambio ya tenga un despliegue correcto (succeeded) en staging:
Not yet deployed to "staging" — promote there before releasing
La respuesta incluye "priorEnvironmentMissing": { "required": "staging" }. Comprueba allowed y haz fallar el job cuando sea false.
Un despliegue enviado por webhook se queda en in progress, porque tu pipeline no puede comunicar su resultado. Para cumplir la comprobación de promoción, registra a mano el despliegue a staging terminado (Record deployment, estado succeeded, con su commit SHA) y llama a la comprobación con ese commitSHA.
Términos relacionados
- Rollback: lo que pasa después de un despliegue que no debería haber salido.
- Motor de políticas: donde viven las reglas de entorno.
- Humano en el bucle (human-in-the-loop): la aprobación que llega antes del pull request, no antes del despliegue.
Preguntas frecuentes
¿AI CodeOps despliega mi código?
No. Llama a un webhook de despliegue que configuras por proyecto, y tu propio pipeline hace el despliegue. AI CodeOps no guarda credenciales de tu infraestructura.
¿Puede un despliegue esperar a que una persona lo apruebe?
No como paso aparte. La aprobación ocurre antes, sobre el cambio, antes de que se abra su pull request. Las reglas de despliegue solo pueden permitir o denegar.
¿Cómo freno una publicación que se saltó staging?
Llama a la comprobación de publicación desde la CI con requireDeployedTo establecido en staging. Deniega un cambio que no tenga un despliegue correcto en staging.