AI CodeOps

Despliegues controlados

Última actualización

Cómo entrega AI CodeOps un cambio fusionado a tu pipeline: el control de calidad antes de fusionar, los webhooks de despliegue, las reglas de política por entorno y los registros de despliegue.

AI CodeOps no despliega código en tu infraestructura. Somete el cambio a sus controles antes de que se fusione, llama a tu pipeline de despliegue cuando se fusiona y conserva un registro de cada despliegue. Tu propio pipeline hace el build y la publicación.

El camino hasta un despliegue

  1. El cambio de una sesión supera sus pruebas y la revisión con IA, y una persona lo aprueba. Consulta Controles de calidad.
  2. AI CodeOps abre el pull request.
  3. Lo fusionas desde la consola. Antes se ejecuta otra vez el control de calidad: los hallazgos abiertos de gravedad high o critical, las pruebas que fallan o una revisión sin terminar detienen la fusión.
  4. Si el proyecto del cambio tiene un destino de despliegue, AI CodeOps llama a su webhook y registra un despliegue.

Fusionar requiere un rol que pueda gestionar despliegues: Owner, Admin, Developer, Member y DevOps Admin. Si la comprobación del control no se puede ejecutar, la fusión no se realiza: "The release check couldn't run just now. Try again in a moment."

El control en la fusión se aplica a los pull requests que AI CodeOps abrió para una sesión. Un pull request que alguien escribió a mano no tiene sesión, así que el control no tiene hallazgos ni pruebas con los que juzgarlo.

Configurar un destino de despliegue

  1. Abre Release → Deployments y elige Deploy targets.
  2. Para cada proyecto, introduce la Deploy webhook URL. Debe ser una dirección https:// pública.
  3. Introduce el Environment en el que despliega. El valor por defecto es production.
  4. Si quieres, introduce un Signing secret.
  5. Elige Save.

Deja la URL en blanco para desactivar los despliegues automáticos de ese proyecto. Configurar destinos de despliegue requiere un rol que pueda gestionar proyectos.

Qué recibe tu webhook

Cuando un cambio se fusiona desde la consola, AI CodeOps envía un POST con este cuerpo:

{
  "event": "pr_merged",
  "workspaceID": "wrk_…",
  "projectID": "billing-api",
  "repo": "acme/billing-api",
  "prNumber": 42,
  "prUrl": "https://github.com/acme/billing-api/pull/42"
}

Con un secreto de firma, la petición lleva X-CodeOps-Signature: sha256=<hex>: un HMAC-SHA256 del cuerpo sin procesar, con tu secreto como clave. Compruébalo antes de desplegar.

La llamada agota el tiempo a los 10 segundos y no sigue redirecciones. Una respuesta 2xx registra el despliegue como in progress. Cualquier otra cosa lo registra como failed, con "The deploy webhook answered HTTP …", y abre un incidente. Elige Retry delivery en la fila para enviarlo de nuevo; cada reintento es un registro nuevo.

Tu pipeline no puede comunicar el resultado final a AI CodeOps, así que un despliegue enviado por webhook se queda como in progress en el historial. Para anotar un despliegue terminado con su resultado, regístralo a mano (más abajo).

Permitir o denegar los despliegues automáticos

Los despliegues automáticos siguen las reglas release.deploy de la política de tu espacio de trabajo, que se comparan con el nombre del entorno. Por ejemplo, esta regla 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 muestra "not deployed" con el motivo. Si la política no se puede cargar, el despliegue se cancela de la misma forma. Estas reglas solo pueden permitir o denegar; no pueden esperar una aprobación. Cuando una persona elige Retry delivery, lo que rige es su rol, no estas reglas. Consulta Aprobaciones y políticas.

Registrar un despliegue a mano

Para los despliegues que ocurren fuera de AI CodeOps:

  1. Abre Release → Deployments y elige Record deployment.
  2. Elige el Project e introduce el Environment.
  3. Fija el Status: succeeded, in progress, queued o failed.
  4. Si quieres, añade una Version y un Commit SHA (7 caracteres como mínimo).
  5. Elige Record deployment.

Registros de despliegue

Cada registro tiene el proyecto, el entorno y un número de secuencia por entorno, el commit o la versión, el estado, las horas de inicio y de fin, y la sesión que produjo el cambio. Los estados son queued, in progress, succeeded, failed, rolled back y canceled.

Un despliegue que tiene éxito para el cambio de una sesión marca el cambio como deployed en Develop → Changes. Los registros alimentan las métricas de entrega del panel y el paquete de evidencias del cambio.

Comprobar una publicación desde CI

Tu pipeline puede preguntar al control de publicación antes de desplegar. Llama a POST /api/release/check con una clave de API del espacio de trabajo, la URL del pull request o el SHA del commit, y opciones como requireDeployedTo. Con "requireDeployedTo": "staging", la publicación se deniega salvo que el cambio ya tenga un despliegue en estado succeeded en staging: "Not yet deployed to "staging" — promote there before releasing". Comprueba allowed en la respuesta. Los campos están en la página de la API, y El control de publicación en CI tiene jobs de pipeline para copiar.

Puedes ejecutar la misma comprobación a mano en Review & Gate → Release gate: introduce la URL de un pull request o el SHA de un commit y elige Evaluate gate.

Siguientes pasos

Preguntas frecuentes

¿AI CodeOps despliega en mis servidores?

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 una política detener los despliegues automáticos a producción?

Sí. Una regla release.deploy puede denegar los despliegues automáticos por entorno. Un despliegue denegado se registra como canceled, con el motivo, y no se envía nada.

¿Puede un despliegue esperar una aprobación humana?

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.

¿Te resultó útil esta página?