CoroidSu AI software factory
Documentación

Eventos de despliegue y configuración de CI

Conecte GitHub Actions, GitLab CI/CD u otro sistema de CI al historial de despliegues de Lanzamientos.

Coroid solo marca un lanzamiento como desplegado cuando así lo indica tu CI/CD. Esta página muestra cómo una canalización informa sobre los despliegues, ya sea que Coroid los inicie o se ejecuten por sí solos.

Coroid

Tu CI/CD

Entorno

  1. 1.Iniciar para el commit exacto
  2. 2.Implementar el commit fijado
  3. 3.Informe en ejecución, luego exitoso o fallido
  4. 4.Supervisar estado de funcionamiento con la comprobación canaria
Un despliegue solo cuenta después de que tu pipeline informe éxito. El paso 1 se omite cuando tu pipeline se inicia por sí mismo.

Todo lo que se indica a continuación se configura por entorno en la sección de Configuración → Lanzamientos → Canalización de despliegue. Allí crea un token de informe. Un Propietario o Administrador lo verá una única vez. Guárdalo como secreto en la canalización de CI de ese entorno. Coroid solo conserva un hash, y al reemplazar el token se revoca el anterior de forma inmediata. El token solo puede informar sobre su proyecto y entorno. Nunca lo incluyas en un archivo del repositorio ni en una solicitud del navegador.

Acciones de GitHub y GitLab CI/CD

Si deseas que Desplegar en… el botón de la página de lanzamientos, selecciona Coroid inicia un flujo de trabajo de Acciones de GitHub o Coroid inicia una canalización de GitLab CI/CD en la configuración de la canalización de despliegue del entorno. Introduce el nombre exacto del trabajo de despliegue, la referencia de rama o etiqueta y el nombre del archivo de flujo de trabajo de GitHub cuando corresponda. Esa referencia debe apuntar al commit de lanzamiento en el momento de la solicitud. El flujo de trabajo de GitHub recibe coroid_release_id, coroid_attempt_id, coroid_commit_sha, y coroid_environment entradas. GitLab recibe las variables equivalentes en mayúsculas COROID_* . Utiliza estos valores para realizar el despliegue e informar sobre el SHA y el intento exactos.

Guarda el token de devolución de llamada del entorno en los secretos de Acciones de GitHub o en las variables enmascaradas de GitLab CI/CD. Envía un running evento cuando comience el trabajo de despliegue y un evento terminal succeeded, failed, o cancelled evento cuando finalice. Coroid verifica la ejecución del proveedor, el commit y el trabajo denominado antes de aceptar el éxito para una canalización configurada. La URL de ejecución del proveedor sigue siendo el lugar donde inspeccionar los registros. El flujo de trabajo de producción de Coroid Flujo de trabajo de producción de Coroid Incluye un ejemplo concreto de Acciones de GitHub; adapta los nombres de los secretos y el trabajo al repositorio de tu proyecto.

Devolución de llamada genérica de CI

Una canalización externa puede enviar los mismos eventos sin necesidad de habilitar la distribución. Autentícate con el token portador con alcance del entorno. El punto de enlace acepta JSON con esta estructura versionada:

POST /api/v1/release-deployment-events
Authorization: Bearer <environment-callback-token>
Content-Type: application/json
{
  "schemaVersion": 1,
  "eventId": "ci:run-812:production:succeeded",
  "providerRunId": "run-812",
  "projectId": "<project-uuid>",
  "environmentKey": "production",
  "repository": "owner/repository",
  "commitSha": "0123456789abcdef0123456789abcdef01234567",
  "status": "succeeded",
  "occurredAt": "2026-09-24T12:00:00Z",
  "runUrl": "https://ci.example.com/runs/812"
}

Incluir releaseId y attemptId al registrar una ejecución solicitada por Coroid. failureReason puede explicar una ejecución fallida. Usa queued, running, succeeded, failed, o cancelled para status. Mantén uno providerRunId durante toda la ejecución y asigna un identificador único a cada transición de estado. eventId. Una reintentación del mismo evento debe conservar su ID; una nueva ejecución de CI requiere un nuevo ID de ejecución. La marca temporal del evento debe ser reciente. Coroid verifica el repositorio, el entorno, el commit, el alcance de las credenciales y el estado final antes de aplicarlo; los eventos conflictivos se ponen en espera para su revisión. Una implementación válida sin un lanzamiento preparado puede generar un lanzamiento observado, claramente diferenciado de un candidato aprobado previamente.

En el caso de una canalización sin devoluciones de llamada, el Propietario o Administrador puede seleccionar Registrar implementación externa en la página de lanzamientos. Indica el entorno, el commit correspondiente, la hora y una razón o URL de evidencia. La certificación manual resultante registra el resultado sin afirmar que Coroid haya ejecutado la CI o superado una comprobación.