CI locale

La boucle push–attente–croix rouge–correction–push gaspille dix minutes par aller-retour. Avec act, les mêmes workflows tournent dans des conteneurs Docker sur votre machine, et Gitcito les pilote : choisissez un workflow, appuyez sur Exécuter, regardez le même log que la CI imprimerait — avant que quoi que ce soit ne quitte votre machine.

Une intégration, pas un runtime embarqué

Gitcito ne fournit délibérément ni act ni Docker — une application qui traîne un runtime de conteneurs avec elle est le contraire d'un client git. C'est une intégration facultative : activez-la dans Réglages → Intégrations (ou dans la boîte de dialogue elle-même), et Gitcito détecte ce qui est installé et vous guide pour le reste — brew install act, un démon Docker en marche, terminé. Rien ne s'exécute tant que les trois conditions ne sont pas réunies : activée, act installé, Docker joignable.

Ce que ça fait

• Liste tous les workflows sous .github/workflows, par leur name:.
• Exécuter lance le workflow avec act contre votre arbre de travail — vos changements non commités inclus, et c'est exactement le but : tester avant de commiter, pas après avoir poussé.
• La sortie est diffusée en direct dans la boîte de dialogue ; Arrêter tue l'exécution. Un code de sortie 0 affiche Réussi, tout le reste Échec avec le code.

Verdicts par commit sur le graphe

Une exécution terminée épingle son résultat au commit qu'elle a testé : une petite fiole marque la ligne en vert ou rouge dans le graphe, pour voir d'un coup d'œil quels commits ont déjà survécu à la CI en local. Le verdict est stocké comme une note git sous refs/notes/gitcito-ci — local à votre machine, jamais poussé par défaut.

Règle d'honnêteté : le verdict n'est épinglé que si votre arbre de travail était propre. Une exécution sur des changements non commités a testé quelque chose qu'aucun commit ne contient : elle affiche donc son résultat dans la boîte de dialogue mais ne marque rien.

Tester un commit ou une plage — sans quitter votre branche

La section Tester un commit ou une plage de la boîte de dialogue exécute un workflow contre des commits sur lesquels vous n'êtes pas. Chaque commit est extrait en mode détaché dans un worktree jetable sous le répertoire temporaire du système, act s'y exécute, et le worktree est supprimé quelle que soit la fin de l'exécution — votre arbre de travail et votre branche ne bougent jamais. Comme cette extraction est impeccable par construction, le verdict s'épingle toujours au commit testé. Un clic droit sur un commit dans le graphe propose directement Lancer la CI locale sur ce commit.

Le coût est annoncé avant que quoi que ce soit ne s'exécute, pas découvert après : tapez une révision ou une plage (main..HEAD, HEAD~5.., un sha), appuyez sur Aperçu, et Gitcito montre combien de commits correspondent à la spécification et quels N plus récents — le budget explicite, plafonné à 50 — s'exécuteraient réellement. Un balayage les exécute séquentiellement (act plus Docker est assez lourd pour que des exécutions parallèles se disputent la machine), diffuse le log de chaque exécution, marque chaque commit réussi/échoué en direct, et Arrêter interrompt entre les commits tout en tuant celui en cours. Attendez-vous à de vraies minutes par commit.

Une limite de plus à connaître : le worktree jetable contient les fichiers du commit mais pas les checkouts de sous-modules de votre dépôt — un workflow qui dépend de sous-modules initialisés se comportera comme sur un clone tout frais sans eux.

Limites

• act est une très bonne imitation des runners de GitHub, pas une imitation parfaite : les actions qui ont besoin de services hébergés par GitHub, de secrets ou d'images de runner exotiques peuvent se comporter différemment. Un vert local est un indice solide, pas une garantie.
• Une exécution à la fois par dépôt ; en démarrer une autre annule la première.
• Exécutions au niveau du workflow uniquement — choisir des jobs individuels, des matrices ou des événements relève d'act ; lancez-le dans le Terminal intégré quand il vous faut des options.
• La première exécution télécharge les images de runner — attendez-vous à ce qu'elle soit lente une fois.

Voir aussi : Hébergement et pull requests · Terminal intégré