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 despliegue como realizado cuando lo indica tu CI/CD. Esta página muestra cómo informa una canalización 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 Se ejecuta y luego tiene éxito o falla, junto con la versión que se desplegó.
  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 Configuración → Lanzamientos → Canalización de despliegue. Cree allí un token de informes. Un Propietario o Administrador lo verá una sola vez. Guárdelo como secreto en la canalización de CI de ese entorno. Coroid solo conserva un hash, y reemplazar el token revoca inmediatamente el anterior. El token solo puede generar informes para su proyecto y entorno. Nunca lo incluya en un archivo del repositorio ni en una solicitud del navegador.

GitHub Actions y GitLab CI/CD

Si desea el Desplegar en… botón en la página de Lanzamientos, seleccione Coroid inicia un flujo de trabajo de GitHub Actions o Coroid inicia una canalización de GitLab CI/CD en la configuración de la canalización de despliegue del entorno. Introduzca 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, además de coroid_version, coroid_build_number y coroid_release_name cuando la canalización los declare. GitLab recibe las variables en mayúsculas equivalentes COROID_* variables. Utilice estos valores para desplegar e informar el SHA y el intento exactos. Incluya la versión en su compilación muestra cómo incorporar la versión en la compilación.

Guarde el token de devolución de llamada del entorno en los secretos de GitHub Actions o en las variables enmascaradas de GitLab CI/CD. Envíe 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 para inspeccionar los registros. El Flujo de trabajo de producción de Coroid contiene un ejemplo concreto de GitHub Actions; adapte sus nombres de secretos y trabajos a su repositorio.

Devolución de llamada de CI genérica

Una canalización externa puede enviar los mismos eventos sin necesidad de habilitar el envío. Autentíquese con el token portador con alcance del entorno. El punto de conexión 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"
}

Incluya releaseId y attemptId al informar una ejecución solicitada por Coroid. Agregue version y buildNumber para registrar lo que se ha desplegado. Para un proyecto alojado en Coroid, repository es el ID del proyecto. failureReason puede explicar una ejecución fallida. Utilice queued, running, succeeded, failed, o cancelled para status. Mantenga uno providerRunId durante toda una ejecución y asigne a cada transición de estado un ID único 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 de tiempo del evento debe ser reciente. Coroid verifica el repositorio, el entorno, el commit, el alcance de las credenciales y el estado terminal antes de aplicarlo; los eventos conflictivos se retienen para revisión. Un despliegue válido sin un lanzamiento preparado puede crear un lanzamiento observado, claramente separado de un candidato aprobado previamente.

Para una canalización sin devoluciones de llamada, un Propietario o Administrador puede seleccionar Registrar despliegue externo en la página de Lanzamientos. Indique el entorno, el commit coincidente, 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 compuerta.