Les paramètres de version se trouvent aux côtés des autres paramètres du projet. Ouvrez le projet, choisissez Paramètres, puis développez Versions. Il existe trois écrans, et chacun répond à une question précise.
- Environnements
- Où va une version ? Ajoutez des points d'arrêt et ordonnez-les.
- Règles d'approbation
- Quelles conditions doivent être remplies au préalable ? Approbations, rôles, liste de contrôle et règles de correctif urgent par environnement.
- Pipeline de déploiement
- Qui déploie et comment Coroid reçoit-il les retours ? Votre pipeline ou Coroid le lance ; un jeton de rapport permet à CI/CD de confirmer le résultat.
Seuls les Propriétaires et les Administrateurs peuvent modifier les paramètres de version. Tous les autres utilisateurs peuvent uniquement les consulter. Connectez d'abord un dépôt, car chaque version pointe vers un commit dans celui-ci.
Environnements
Où est déployée une version, et dans quel ordre ?
Chaque projet démarre avec la production. Ajoutez les autres étapes de déploiement, comme la préproduction ou le contrôle qualité, via Ajouter un environnement. Donnez un nom à chacun. Coroid
suggère une clé à partir de ce nom, par exemple staging. Votre CI/CD utilise cette clé
lorsqu'il signale un déploiement ; conservez-la stable une fois que les pipelines l'utilisent.
Définissez l'ordre via Vient après. Une préproduction qui vient après rien et la production qui vient après la préproduction donnent le parcours Préproduction › Production. La page de version affiche ce chemin d'acheminement dans cet ordre, et les règles d'approbation peuvent exiger que l'étape précédente réussisse d'abord.
Règles d'approbation
Quelles conditions doivent être remplies avant qu'une version ne soit déployée ici ?
Sélectionnez l'environnement en haut. Les règles sont spécifiques à chaque environnement : la préproduction peut avoir des règles souples tandis que la production sera plus stricte.
- Approbations requises: nombre de personnes différentes nécessaires pour approuver. Zéro permet à une version d'être déployée dès que ses vérifications sont passées.
- Qui peut approuver: les rôles au sein de l'organisation autorisés à approuver.
- Séparer le demandeur et les approuveurs: la personne qui lance le déploiement ne peut pas non plus l'approuver, et celle qui modifie les notes de version ne peut pas les approuver non plus.
- Vérifications qualité réussies: toujours activé. Le graphique qualité du projet avec un
release_validationdéclencheur s'exécute sur le commit exact. Publiez ce graphique depuis les paramètres qualité du projet. - L'environnement précédent en premier: la version doit déjà être déployée dans l'environnement qui précède celui-ci.
- Notes de version approuvées: les notes actuelles nécessitent une approbation, et toute modification ultérieure requiert une nouvelle approbation.
- Liste de contrôle: étapes manuelles que quelqu'un confirme sur la page de version, comme « Migration de base de données vérifiée ». Marquez un élément comme obligatoire ou optionnel. Un élément obligatoire peut autoriser une exception temporaire. Un Propriétaire ou un Administrateur enregistre une raison et une date d'expiration maximale de 24 heures ; l'exception ne s'applique qu'à ce commit et à cet environnement.
- Règles de correctif urgent: règles plus souples pour les corrections urgentes : nombre d'approbations et présence ou non des exigences liées à l'environnement précédent et à l'approbation des notes. Les vérifications qualité et les éléments de liste de contrôle obligatoires s'appliquent toujours, et seuls les Propriétaires et les Administrateurs peuvent approuver les correctifs urgents.
Sélectionnez Publier les règles pour enregistrer. La publication crée une nouvelle version des règles. Les approbations accordées sous l'ancienne version deviennent obsolètes ; une version en cours de traitement demandera donc une nouvelle approbation. Un environnement sans règles publiées ne peut pas passer ses vérifications, et l'écran l'indique.
Pipeline de déploiement
Qui lance un déploiement, et comment Coroid prend-il connaissance du résultat ?
Sélectionnez l'environnement en haut, puis choisissez comment les déploiements démarrent :
- Mon pipeline se déploie automatiquement: conservez votre processus actuel. Coroid enregistre les déploiements lorsque votre CI/CD les signale, ou lorsqu'un Propriétaire ou un Administrateur signe un déploiement externe sur la page de version.
- Coroid lance un workflow Actions de GitHub ou Coroid lance un pipeline GitLab CI/CD: affiché lorsque le dépôt du projet est hébergé sur ce fournisseur. Indiquez la branche ou l'étiquette qui pointe vers le commit de la version, le fichier de workflow pour GitHub, et le nom exact du job chargé du déploiement. Coroid vérifie la référence avant de lancer l'exécution et le job nommé avant d'accepter le succès.
Sous Rapports de déploiement, créez un jeton de rapport pour l'environnement et stockez-le en tant que secret dans votre CI/CD. Coroid affiche le jeton une seule fois et ne conserve qu'un hachage de celui-ci. Remplacer le jeton désactive immédiatement l'ancien. Le même écran indique l'point d'accès, l'ID du projet et la clé d'environnement nécessaires à votre pipeline, ainsi que la présence ou non de rapports en cours de réception. Événements de déploiement et configuration CI présente le format d'événement et des exemples.
Transfert des paramètres entre organisations
L'exportation et l'importation des paramètres incluent les environnements, leur ordre, la configuration du pipeline et les règles publiées, y compris les règles de correctif urgent. Les jetons de rapport ne sont jamais exportés. Créez-en de nouveaux après un import.