Événements de déploiement et configuration de l'CI

Coroid ne marque une version comme déployée que si votre CI/CD l'indique. Cette page explique comment un pipeline signale les déploiements, qu'il soit initié par Coroid ou qu'il s'exécute de manière autonome.

Tous les paramètres ci-dessous sont configurés par environnement dans les Paramètres du projet. Paramètres → Versions → Pipeline de déploiementCréez un jeton de signalement à cet endroit. Un Propriétaire ou un Administrateur le voit une seule fois. Enregistrez-le en tant que secret dans le pipeline CI de cet environnement. Coroid ne conserve que son hachage ; remplacer ce jeton révoque immédiatement l'ancien. Ce jeton ne peut signaler des données que pour son projet et son environnement. Ne l'inscrivez jamais dans un fichier de dépôt ni dans une requête navigateur.

Actions GitHub et GitLab CI/CD#

Si vous souhaitez que Déployer vers… le bouton sur la page de version, sélectionnez Coroid lance un workflow Actions GitHub ou Coroid lance un pipeline GitLab CI/CD dans les paramètres du pipeline de déploiement de l'environnement. Indiquez le nom exact du job de déploiement, la branche ou la référence de tag, ainsi que le nom du fichier de workflow GitHub le cas échéant. Cette référence doit pointer vers le commit de version au moment de la demande. Le workflow GitHub reçoit coroid_release_id, coroid_attempt_id, coroid_commit_sha, et coroid_environment en entrée. GitLab reçoit les variables équivalentes en majuscules COROID_* . Utilisez ces valeurs pour effectuer le déploiement et signaler le SHA et l'essai exacts.

Enregistrez le jeton de rappel d'environnement dans les secrets Actions GitHub ou les variables masquées GitLab CI/CD. Envoyez un running événement lorsque le job de déploiement démarre et un événement terminal succeeded, failed, ou cancelled événement lorsqu'il se termine. Coroid vérifie la exécution du fournisseur, le commit et le job nommé avant d'accepter le succès pour un pipeline configuré. L'URL de la exécution du fournisseur reste l'endroit où consulter les journaux. Le Workflow de production Coroid Contient un exemple concret d'Actions GitHub ; adaptez les noms de secrets et les tâches à votre dépôt.

Callback CI générique#

Une pipeline externe peut envoyer les mêmes événements sans activer la distribution. Authentifiez-vous avec le jeton porteur à portée de l'environnement. Le point de terminaison accepte JSON avec cette structure versionnée :

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"
}

Inclure releaseId et attemptId lors de la notification d'une exécution demandée par Coroid. failureReason peut décrire une exécution ayant échoué. Utilisez queued, running, succeeded, failed, ou cancelled pour status. Conservez-en un providerRunId pendant toute l'exécution et attribuez à chaque transition d'état un identifiant unique eventId. Une nouvelle tentative du même événement doit conserver son identifiant ; une nouvelle exécution CI nécessite un nouvel identifiant d'exécution. La date et l'heure de l'événement doivent être récentes. Coroid vérifie le dépôt, l'environnement, la validation, l'étendue des identifiants et l'état final avant de l'appliquer ; les événements en conflit sont mis en attente pour examen. Une déploiement valide sans version préparée peut générer une version observée, clairement distincte d'une candidature approuvée lors de la phase de pré-vérification.

Pour une pipeline sans rappels automatiques, un Propriétaire ou un Administrateur peut choisir Enregistrer le déploiement externe sur la page Versions de Coroid. Indiquez l'environnement, le commit correspondant, l'heure ainsi qu'un motif ou une URL vers des éléments probants. L'attestation manuelle ainsi créée consigne le résultat sans prétendre que Coroid a exécuté la CI ou validé une étape de contrôle.

Liés#

• Paramètres de version
• Versions
• Séries de versions et processus de déploiement