Projets de prévisualisation et de test temporaire

Deux concepts liés qui servent tous deux à isoler le travail expérimental du travail essentiel.

Projets éphémères#

Un projet éphémère est un projet normal que vous prévoyez d'abandonner. Utilisez-en un pour tester Coroid sur un code-base inconnu, valider un changement de politique avant son déploiement généralisé, ou explorer une approche à laquelle vous n'êtes pas encore engagé.

L'avantage réside dans l'isolement. Les expériences menées dans un projet éphémère ne viennent pas altérer l'historique des tâches, les métriques ou le contexte d'un projet dont votre équipe dépend.

Supprimez-les lorsque vous avez terminé. Un projet éphémère qui persiste six mois est devenu discrètement un projet réel, sans bénéficier des configurations nécessaires à ce statut.

Environnements de prévisualisation#

Une prévisualisation correspond à votre application modifiée en fonctionnement, générée à partir de la branche issue d'une tâche.

C'est essentiel car certains aspects ne peuvent être évalués uniquement via une comparaison de codes. Que la page s'affiche correctement, qu'un flux fonctionne de bout en bout ou qu'un changement soit visuellement satisfaisant : tout cela nécessite l'exécution effective du logiciel.

Les prévisualisations sont ce contre quoi les tests navigateur sont exécutés, et ce que les réviseurs ouvrent lorsqu'une capture d'écran ne suffit pas à trancher.

Prévisualiser l'évolution d'une tâche#

Dans l'Usine, ouvrez une tâche en attente de révision. Sous Quels changements ?, le Prévisualisation fenêtre lance la branche de la tâche en un clic.

• Démarrage: les dépendances de la branche s'installent et l'application démarre. La première exécution peut prendre quelques minutes.
• Prêt: l'application en cours d'exécution apparaît dans la fenêtre. Ouvrir l'affiche dans un nouvel onglet, et la fenêtre indique le temps restant avant la fin de la prévisualisation.
• Arrêter la termine prématurément. Une prévisualisation exécutée dans Coroid s'arrête automatiquement après une heure.

Si la compilation échoue, Réessayer la relance et Afficher les journaux montre ce qui s'est passé d'anormal. Pour un changement ne générant aucune page web, comme un changement côté serveur ou bibliothèque, on affiche Rien à afficher dans un navigateur au lieu d'un bouton.

Lancer une prévisualisation déjà en cours ou en démarrage ouvre la même prévisualisation, afin que deux réviseurs ne lancent pas deux instances distinctes.

Où s'exécute une prévisualisation#

Vous ne choisissez pas l'emplacement où s'exécute une prévisualisation :

• Sandbox Coroid: c'est l'option par défaut. Coroid compile la branche de la tâche dans un conteneur isolé qui ne contient aucun de vos secrets. Il n'a besoin ni de pull request ni d'un push, ce qui permet également son utilisation pour les dépôts restant au sein de Coroid.
• Vercel: lorsque le projet est connecté à Vercel pour un déploiement direct (paramètres du projet → Intégrations → Preuve de révision), Vercel compile la branche et la diffuse à une adresse de prévisualisation Vercel. Les protections de déploiement propres à Vercel s'appliquent, donc la prévisualisation s'ouvre dans un nouvel onglet plutôt que dans la fenêtre.

Un dépôt en mode local-only ne quitte jamais Coroid et utilise toujours la sandbox Coroid pour les prévisualisations.

Une adresse de prévisualisation est longue et difficile à deviner, mais toute personne la possédant peut ouvrir la prévisualisation pendant son exécution. Traitez-la comme tout lien vers un travail non publié.

Comment les prévisualisations arrivent dans votre pull request#

Le lien pull request Coroid d'une tâche pointe vers sa prévisualisation : Prévisualiser ce changement dans Coroid ouvre la révision de la tâche et lance la prévisualisation. Le lien nécessite une connexion à Coroid ; l'adresse de la prévisualisation n'est pas publiée sur la demande de fusion.

Si vous disposez déjà de déploiements d'aperçu — via l'application Git de votre fournisseur d'hébergement ou votre CI — Coroid les associe également en tant que preuves de révision, afin que le lien apparaisse aux côtés du changement plutôt que dans un endroit où vous devriez le chercher.

L'objectif est que les preuves de vérification et le code qu'elles valident arrivent ensemble.

Quand utiliser l'un ou l'autre#

• Pour tester Coroid ou une approche que vous pourriez abandonner → projet éphémère
• Pour vérifier que un changement spécifique se comporte correctement → prévisualisation

Ils sont complémentaires : un projet éphémère peut disposer de prévisualisations comme tout autre projet.

Articles associés#

• Créer et configurer un projet
• Preuves de révision
• Fournisseurs de preuves de révision