Cette semaine, relevez le champ Runner Image Version dans le journal Set up job de chaque job, puis reproduisez séparément l’écart d’image et l’erreur du projet. Ne relancez pas le workflow en boucle en espérant obtenir une image plus récente : une relance ne constitue pas une réparation fiable. Si votre production exige un environnement macOS contrôlable, évaluez un hôte dédié avec un vrai workflow avant de migrer.
Cet article s’adresse aux responsables de CI macOS qui constatent des images ou des résultats différents entre jobs.
Il aide les ingénieurs iOS et macOS à vérifier une piste d’environnement sans modifier prématurément le code.
Les responsables de plateforme y trouveront des critères pour comparer runner hébergé et hôte macOS maîtrisé.
Dernière mise à jour : 2 novembre 2026. Les informations sur la disponibilité et les images ont été vérifiées dans l’annonce de GitHub et les publications de runner-images ; le signalement communautaire a été contrôlé séparément de ces sources officielles (annonce macOS 26, publications des images, issue 15208). Pour votre diagnostic, les journaux du job restent la preuve de l’environnement réellement reçu.
Où vérifier le Runner Image Version d’un job macOS 26 ?
Ouvrez les journaux de l’exécution concernée, puis développez Set up job. Relevez la valeur Runner Image Version pour chaque job, y compris ceux qui ont réussi. Enregistrez l’identifiant de l’exécution, le commit, le nom du job et l’heure de démarrage avec cette valeur. Les instructions de GitHub expliquent comment consulter les journaux d’une exécution (documentation des journaux de workflow).
Ne déduisez pas l’image réelle du seul libellé macos-26 dans runs-on. Ce libellé choisit un type de runner ; il ne prouve pas que deux jobs ont utilisé la même révision d’image. GitHub a annoncé la disponibilité générale des runners macOS 26 le 26 février 2026 et publié les informations de version correspondantes dans ses sources officielles. Pour les étiquettes et les images disponibles, consultez l’annonce officielle de macOS 26 et les publications de runner-images.
Pour comparer les environnements, relevez aussi les éléments qui influencent réellement la compilation : version de macOS, architecture, Xcode sélectionné, SDK, outils installés et variables déterminantes. La source à privilégier pour ces valeurs est le journal de chaque job ; les publications d’images servent à interpréter ce qui y apparaît, pas à remplacer l’observation de l’exécution.
Une différence entre versions d’image ne démontre pas à elle seule qu’elle a provoqué l’échec. Elle indique une piste à tester. À l’inverse, deux jobs qui affichent le même tag de runner ne sont pas nécessairement comparables si leurs étapes, dépendances ou entrées divergent.
Pourquoi des jobs d’un même workflow reçoivent-ils des images différentes ?
Le tag de runner décrit une cible de sélection, tandis que l’image installée est l’environnement effectivement provisionné. Il faut donc comparer les observations des jobs, et non supposer que le workflow garantit une identité complète entre eux. La documentation de GitHub décrit les critères permettant de choisir le runner d’un job, mais c’est le journal qui montre les détails de l’exécution (choix du runner).
Le 1er novembre 2026, l’issue 15208 du dépôt runner-images a signalé que des jobs macOS 26 arm64 d’un même workflow pouvaient recevoir des versions d’image différentes. Au moment de la vérification, ce signalement était une issue utilisateur en attente de triage, pas une confirmation officielle d’un défaut généralisé ni une annonce de correctif. Il justifie une comparaison précise des journaux, mais ne permet pas de conclure que tous les projets macOS 26 sont touchés (issue 15208).
Une différence apparente peut également venir de facteurs propres au projet. Un job peut utiliser un autre Xcode, restaurer un cache différent ou installer une dépendance non verrouillée. La concurrence entre étapes, la configuration des secrets et les paramètres du schéma de compilation peuvent aussi produire un résultat différent sans que l’image soit la cause. Pour un pipeline de création, de traitement audio ou d’export vidéo, comparez notamment les outils de signature, les plug-ins et les ressources générées : un échec d’export n’a pas forcément la même origine qu’un échec de compilation.
Pour examiner un désaccord entre jobs, construisez une fiche par exécution plutôt qu’un relevé global du workflow. Notez le job, le commit, l’heure, l’image, l’architecture, Xcode, le résultat et la première erreur significative. Si une valeur manque dans le journal, signalez-la comme inconnue au lieu de la reconstituer à partir d’un ancien run ou d’une configuration supposée.
Comment isoler un ancien runner d’un défaut du projet ?
Le diagnostic d’une image du runner macOS 26 de GitHub Actions doit distinguer une corrélation d’une causalité. Un job en échec sur une image plus ancienne et un job réussi sur une image récente constituent un indice, pas une preuve : d’autres entrées peuvent avoir changé entre les deux exécutions.
Pour effectuer une comparaison exploitable, choisissez un commit fixe, les mêmes fichiers de workflow et les mêmes paramètres d’entrée. Comparez un job réussi et un job en échec, puis consignez leurs versions d’image et leur environnement. Si le workflow appelle des actions tierces, des scripts d’installation ou des dépendances résolues à la volée, notez également leur révision ou leur version effective. Sans ces contrôles, vous risquez d’attribuer à l’image une différence qui vient d’un téléchargement ou d’une modification du projet.
Analysez ensuite le premier échec déterminant, et non uniquement le résumé rouge du workflow. Une erreur de compilation, une erreur de signature, un test instable et un échec de téléchargement ont des causes possibles différentes. Examinez la commande concernée, son entrée, sa sortie et les étapes immédiatement précédentes. Vérifiez si le problème se reproduit avec les mêmes entrées dans un job comparable. N’élargissez pas un message d’erreur isolé à tous les projets macOS 26 arm64 : l’issue signalée ne prouve pas une cause commune.
Cette distinction est importante lorsque l’équipe est pressée de livrer. Une modification de code pour contourner un environnement temporairement différent peut masquer une régression réelle. Mais ignorer une incompatibilité d’outil parce qu’elle apparaît sur une seule image peut aussi laisser un problème de production sans réponse. Conservez les exécutions qui passent et celles qui échouent, avec leurs journaux complets, avant d’appliquer un contournement.
Une nouvelle exécution est utile pour collecter une autre observation, pas pour forcer une version d’image. Les consignes de GitHub sur la relance décrivent comment relancer un workflow ou un job ; elles ne promettent pas l’attribution d’une image donnée (relancer des workflows et des jobs).
Comment confirmer qu’une nouvelle image est utilisée par le job ?
La publication d’une nouvelle image dans runner-images et son utilisation effective par votre job sont deux événements distincts à vérifier. Consultez d’abord la publication officielle pour identifier les changements annoncés, puis comparez sa date avec l’heure d’exécution. Enfin, inspectez la valeur Runner Image Version dans Set up job. Cette dernière confirme l’image observée dans votre exécution ; la date de publication, seule, ne le fait pas.
Tenez compte de l’éventuel décalage entre la publication d’une image et ce que reçoit un job donné. Ne supposez ni qu’une étiquette a changé de façon instantanée ni qu’une relance sélectionnera la nouvelle version. Le signalement de l’issue 15208 concerne précisément une différence possible entre les images rapportées ; il ne décrit pas une commande permettant de vider ou de purger un pool hébergé.
Lorsqu’une image plus récente semble correspondre à votre correction, adoptez une vérification de bout en bout : lancez le workflow sur le commit concerné, relevez l’image réellement utilisée, confirmez les versions d’outils, puis validez les tests et les étapes de livraison. Si votre équipe ne peut pas contraindre l’image sur le runner hébergé, documentez cette limite et utilisez un mécanisme de retour que vous avez testé, plutôt que d’inscrire dans la procédure une garantie que la plateforme ne donne pas.
Liste de vérification avant de modifier la CI
- [ ] Ouvrir les journaux de chaque job, y compris ceux qui ont réussi, et relever Runner Image Version dans Set up job.
- [ ] Associer chaque observation au commit, au nom du job et à l’heure de l’exécution.
- [ ] Comparer macOS, architecture, Xcode, SDK et outils avec les journaux et les publications officielles d’images.
- [ ] Garder le même commit, les mêmes entrées et le même workflow pour tester si l’échec suit la version d’image.
- [ ] Identifier la première erreur déterminante et examiner ses entrées avant de modifier le code.
- [ ] Vérifier l’état de l’issue 15208 et des publications de
runner-images, sans traiter un signalement utilisateur comme une annonce officielle. - [ ] Après une publication, lancer un job de validation et confirmer la version réelle dans ses journaux.
- [ ] Définir une procédure de repli vérifiable ; ne pas compter sur des relances répétées pour obtenir une image plus récente.
Comparer le runner hébergé, un runner autogéré et un Mac distant
Le choix dépend du degré de contrôle nécessaire et du travail d’exploitation que votre équipe peut réellement assumer. Voici une comparaison qualitative ; les appréciations portent sur la maîtrise de l’environnement, pas sur une mesure de performance.
- Runner hébergé : maîtrise faible à moyenne. Vous déléguez l’administration de l’hôte et gardez une configuration de workflow familière. En revanche, si les journaux montrent des versions d’image différentes, vous devez traiter cette variation comme un fait observé et vérifier les mises à jour dans chaque job. Cette option convient si les variations restent acceptables et si votre pipeline vérifie ses dépendances.
- Runner autogéré : maîtrise forte, responsabilité forte. Vous contrôlez davantage l’installation et la politique de mise à jour, mais vous devez gérer les correctifs, les accès, le nettoyage, les journaux et l’isolation des tâches. Un runner persistant mal nettoyé peut conserver des fichiers, des identifiants ou des artefacts d’un job précédent. La maîtrise supplémentaire n’est donc utile que si l’équipe peut assurer cette maintenance.
- Mac distant dédié : maîtrise forte, exploitation à organiser. Il peut fournir un environnement macOS auquel l’équipe accède à distance et dont elle vérifie la chaîne d’outils. Il faut toutefois valider le workflow réel, les droits, la gestion des secrets, la disponibilité et la remise en état de l’hôte. Ce choix n’élimine pas automatiquement les problèmes de dépendances, de signature ou de scripts.
Pour le contrôle d’accès, ne confondez pas l’accès administrateur à une machine et une isolation complète des builds. Définissez qui peut ouvrir une session, où les secrets sont conservés et comment les données temporaires sont supprimées. Un Mac utilisé par plusieurs pipelines ou utilisateurs demande des règles explicites de séparation et de nettoyage. Pour examiner les modalités d’accès à un environnement Mac distant, consultez la présentation du bureau à distance et, si un point de configuration reste incertain, le centre d’aide.
Avant toute migration, faites une répétition avec votre workflow de production. Vérifiez le checkout, les dépendances, le choix de Xcode, la signature, les tests et la publication des artefacts. Comparez aussi la façon dont les journaux sont conservés et comment l’équipe revient à son runner précédent. Si une étape requiert une interface graphique, des périphériques physiques ou une action manuelle, incluez-la dans l’essai : une compilation en ligne de commande seule ne valide pas tout le processus.
La décision est simple à formuler : si les écarts d’image ne perturbent pas vos livraisons et que vous pouvez diagnostiquer les jobs grâce aux journaux, commencez par améliorer la collecte et la reproductibilité sur le runner hébergé. Si votre projet exige une chaîne d’outils maîtrisée, des exécutions répétables et une politique d’environnement que vous pouvez vérifier, testez un runner autogéré ou un Mac distant. Si personne ne peut assurer les mises à jour, les secrets et le nettoyage, le surcroît de contrôle risque de devenir une nouvelle source d’incidents.
Pertinence d’un hôte macOS maîtrisé
Un hôte dédié devient pertinent lorsque l’écart de configuration bloque régulièrement les livraisons, que l’équipe a besoin de vérifier précisément sa chaîne d’outils et qu’elle peut prendre en charge l’exploitation. Il n’est pas une correction garantie à une différence d’image signalée sur des runners hébergés. Il ne corrige pas non plus un défaut dans le code, une dépendance non verrouillée ou une procédure de signature incomplète.
Comparez votre solution actuelle à un Mac distant en listant les limites constatées dans vos propres journaux : versions d’image qui ne correspondent pas entre jobs, impossibilité de piloter l’image hébergée comme vous le souhaitez, et relances qui n’offrent aucune garantie de sélection d’une image précise. Ces constats justifient une évaluation, pas une migration automatique. Un hôte contrôlé peut améliorer la visibilité sur votre environnement, à condition que vous validiez la configuration réelle et assumiez son entretien.
Si vous avez besoin d’un environnement macOS temporaire pour éprouver votre workflow, comparer une chaîne d’outils ou valider une migration avant de changer votre CI, vous pouvez examiner les offres VPSPush. Vérifiez d’abord la compatibilité avec vos tâches, vos besoins d’accès et vos exigences de sécurité. Pour une production durable, choisissez seulement après avoir exécuté le workflow complet et défini qui maintiendra l’hôte ; la location d’un Mac n’est pas une garantie contre les défauts de votre projet.
Pour aller plus loin
- Comparer une chaîne CI automatisée à un environnement macOS interactif pour tester et compiler vos projets
- Diagnostiquer un échec de compilation Mac Catalyst en isolant la version de l’outil, le SDK et la destination
- Vérifier les avertissements du compilateur après une modification ciblée de votre code Swift
Reprenez la maîtrise de vos builds macOS
Avec VPSPush, utilisez à distance un Mac mini M4 physique dédié plutôt qu’un environnement partagé.
