Accueil / Blog / Que faire si la CI échoue après le retrait de GitHub Actions macOS-14 ? 2026
ENGINEERING_BLOG · 2026.11.15

Que faire si la CI échoue après le retrait de GitHub Actions macOS-14 ? 2026

Au 15 novembre 2026, GitHub indique que trois étiquettes macOS-14 sont retirées : macos-14, macos-14-large et macos-14-xlarge (annonce officielle).

Symptôme → aucun Runner ne prend le travail, ou la compilation échoue après le changement d’image.
Correction rapide → remplacez l’étiquette retirée par un Runner actuellement pris en charge et compatible avec l’architecture du projet, puis validez séparément les outils, les tests et la signature. Changer runs-on ne prouve pas que la migration est terminée.

Cette procédure s’adresse à :
Aux responsables IT qui doivent mesurer l’impact du retrait et répartir le travail de correction.
Aux ingénieurs plateforme qui localisent une panne de planification, d’architecture ou d’outillage.
Aux responsables de publication qui doivent confirmer la reprise de la compilation jusqu’à la livraison.

Dernière vérification : 15 novembre 2026, à partir de l’annonce et de la documentation GitHub indiquées ci-dessous. Les étiquettes et le contenu des images pouvant évoluer, vérifiez-les de nouveau avant de modifier vos workflows.

SECTION 01Identifier d’abord le type de panne

Un message d’erreur isolé ne suffit pas à établir que le retrait de l’image est la cause. Commencez par relever le nom du workflow, le travail concerné, le commit, l’heure de la tâche et son état final. Dans l’historique d’exécution, distinguez une tâche qui reste en attente d’une tâche attribuée à un Runner et interrompue ensuite : ces deux symptômes ne conduisent pas au même diagnostic.

Ouvrez le fichier de workflow réellement utilisé par le travail concerné et examinez runs-on. Recherchez aussi les valeurs construites par expressions ou transmises par des paramètres : une référence à macos-14 peut ne pas apparaître dans la ligne la plus visible du fichier. Comparez la configuration avec l’annonce de retrait et la liste officielle des images Runner. L’annonce répertorie les trois étiquettes retirées ; elle ne permet pas, à elle seule, de conclure que toute erreur observée à la même date a cette origine.

Pour chaque incident, conservez un petit dossier de diagnostic : fichier de workflow, URL ou identifiant de l’exécution, commit concerné, extrait du journal de planification et message d’erreur complet. Ce dossier permet aux équipes plateforme et applicative de discuter à partir des mêmes éléments, plutôt que de déduire la cause d’une capture d’écran ou d’un seul message de file d’attente.

Si le travail est en attente, vérifiez d’abord la disponibilité et l’étiquette demandée. Si le Runner démarre, poursuivez avec son architecture et son environnement : modifier de nouveau runs-on risque alors de masquer le vrai problème.

Aucun Runner ne prend le travail

Quand une tâche reste en attente, vérifiez d’abord si runs-on demande encore une étiquette retirée, y compris dans une matrice ou une expression. Si votre organisation utilise des groupes de Runner, examinez également les conditions d’accès et les étiquettes exigées par le groupe : un Runner disponible ne peut pas nécessairement accepter un travail qui ne lui est pas destiné.

Comparez ensuite l’étiquette demandée aux noms actuellement documentés. Traitez macOS-15 Runner comme une possibilité à vérifier, et non comme une substitution à appliquer sans contrôle. La documentation des étiquettes et l’état des images peuvent changer ; la référence officielle des étiquettes Runner est le point de contrôle, tandis que le journal de l’exécution indique ce que votre workflow a effectivement demandé.

Si l’étiquette semble correcte, suivez les indications de la documentation GitHub sur le dépannage des workflows. Vérifiez le statut de l’exécution, les dépendances du travail et les éventuelles conditions de concurrence ou de déclenchement. Une tâche qui ne démarre jamais ne peut pas révéler un problème Xcode : ne commencez pas par modifier le projet iOS quand aucun environnement ne lui a encore été attribué.

Preuve à conserver : l’étiquette résolue au moment de l’exécution, l’état d’attribution et la configuration effective du travail. Si ces éléments montrent que le workflow demande encore une image retirée, corrigez cette référence ; s’ils montrent une demande prise en charge, recherchez plutôt une condition d’accès, de groupe ou de planification.

Architecture et dépendances binaires

Une nouvelle image peut démarrer correctement tout en exécutant une architecture différente de celle que supposent vos outils. Pour répondre au cas « macOS-14 remplacé par macOS-15, mais la compilation iOS échoue », ne confondez donc pas changement d’étiquette et migration d’architecture. Une commande peut trouver une dépendance, puis échouer à l’exécuter parce que le binaire ou un outil secondaire ne correspond pas à l’environnement.

Au début du travail, consignez les propriétés réellement exposées par le contexte runner, notamment runner.os, runner.arch et runner.name (référence des contextes GitHub Actions). Ces champs vous aident à distinguer l’environnement attribué de celui que vous supposiez recevoir. Archivez leur valeur avec le journal de dépendances, sans déduire l’architecture du seul nom de l’étiquette.

Rejouez ensuite une tâche qui utilise une dépendance native représentative : outil de génération, compilateur auxiliaire, bibliothèque binaire ou commande appelée par un script de construction. Relevez la commande exacte, le chemin de l’exécutable, son résultat et l’étape où l’échec apparaît. Si la dépendance est téléchargée ou construite pendant le travail, vérifiez également les paramètres qui sélectionnent son architecture.

Le manifeste de l’image macOS-15 décrit les logiciels présents sur cette image. Il ne certifie pas que les binaires propres à votre projet sont compatibles, ni que votre workflow les sélectionne correctement. Si votre équipe dépend d’un outil Intel, validez explicitement sa disponibilité et son exécution dans l’environnement de remplacement avant de déclarer la compilation réparée.

Preuve à conserver : architecture observée, journal d’installation des dépendances, résultat d’exécution du binaire et commit testé. Une erreur reproduite sur une seule commande ciblée est plus utile qu’une modification générale de scripts sans trace de ce qui a changé.

Xcode, SDK et simulateurs

Le fichier de workflow indique l’étiquette demandée, pas nécessairement la version de Xcode ou le SDK utilisés par chaque commande. Une nouvelle image peut contenir un autre ensemble d’outils ; un script de sélection peut aussi pointer vers une version absente ou ne pas être appelé dans le contexte du travail. Pour vérifier le Xcode effectivement choisi par un macOS-15 Runner, inscrivez les chemins et versions rapportés par les commandes exécutées dans le travail, puis comparez-les à la liste des logiciels de l’image macOS-15.

Inspectez séparément les commandes qui sélectionnent Xcode et celles qui lancent la compilation. Vérifiez le chemin actif, la disponibilité de l’outil en ligne de commande et le SDK rapporté pendant le travail. La documentation Apple sur l’installation des outils en ligne de commande Xcode permet de contrôler ce composant ; elle ne garantit pas que le workflow sélectionne le Xcode attendu.

Le simulateur ajoute une autre dépendance : une compilation peut réussir alors que le runtime utilisé par les tests n’est plus celui que le projet attend. Relevez le nom du simulateur, le runtime effectivement disponible et la commande qui l’a sélectionné. Consultez l’inventaire de l’image plutôt que de vous fier à une valeur conservée dans un ancien journal ou à une supposition fondée sur la version de macOS.

Pour séparer un changement d’environnement d’une régression de code, rejouez le même commit sur l’image de remplacement et conservez les sorties de compilation, de sélection Xcode et de tests. Si seule la sélection d’outil diffère, corrigez ou rendez explicite cette sélection avant de toucher au code applicatif. Une erreur de compilation apparue après le changement d’image ne prouve pas, à elle seule, que l’application est en cause.

Tests et artefacts de livraison

Traitez le passage au vert comme une série de contrôles distincts, et non comme un résultat unique. Réexécutez la compilation, les tests unitaires, les tests sur simulateur et la production de l’archive. Notez la première étape qui échoue : elle réduit le périmètre à examiner et évite de déboguer la signature alors que l’archive n’est jamais créée.

Comparez les journaux avant et après le changement d’image pour les variables d’environnement, les options de compilation, les chemins d’outils et les hypothèses du projet. Vérifiez notamment si un script repose sur une valeur par défaut qui n’est plus identique, sur un outil installé implicitement ou sur un runtime de simulateur indisponible. Rattachez chaque essai au même commit lorsque vous comparez les résultats ; sinon, une modification du code peut être confondue avec une modification du Runner.

Contrôlez enfin l’artefact lui-même : sa présence, son nom, son type et les éléments attendus par l’étape de publication. Le simple succès de la commande de compilation ne confirme ni que le bon produit a été archivé, ni que les tests requis ont tourné, ni que l’étape suivante reçoit le fichier attendu.

Pour un projet de création audio ou vidéo, cette séparation est également utile quand la CI produit des outils internes, des extensions ou des composants destinés à une chaîne de production : un rendu ou une compilation réussie ne démontre pas automatiquement que l’artefact a été généré dans le format et avec les ressources attendus. Définissez le contrôle d’acceptation à partir du livrable réel, puis conservez les journaux et artefacts liés à l’exécution.

Signature et publication

Une publication qui échoue après une compilation réussie exige un diagnostic distinct. Vérifiez l’identité de signature, le profil de provisionnement, le trousseau utilisé par le travail et les informations d’accès consommées par les étapes de publication. Confirmez que ces éléments sont disponibles dans l’environnement de remplacement et que les commandes les recherchent au bon endroit.

Ne réinitialisez pas toutes les informations sensibles au premier échec. Comparez plutôt la dernière étape réussie et la première étape en erreur, puis déterminez si l’échec porte sur la création de l’archive, la signature, la vérification ou l’envoi. Cette distinction évite d’attribuer à l’image un secret absent, une configuration de compte incorrecte ou un profil arrivé à expiration.

Une compilation réussie ne valide pas la chaîne de signature. Faites un essai contrôlé qui exécute les mêmes étapes de signature et de publication que le flux réel, avec les règles d’accès habituelles. Le résultat à examiner comprend l’archive signée et les journaux de validation, pas uniquement l’état « réussi » d’un travail de compilation.

Ne considérez pas la publication comme rétablie tant qu’un essai n’a pas confirmé la disponibilité des justificatifs, la signature attendue et l’acceptation de l’artefact par l’étape qui suit. Un succès partiel peut laisser la chaîne de livraison inutilisable.

Comparer les options d’hébergement

Si les journaux montrent une contrainte que les images hébergées disponibles ne satisfont pas, comparez les solutions sur la base de vos tâches réelles, et non d’une préférence générale pour un type de Runner. En particulier, ne passez pas immédiatement à un Mac autogéré : établissez d’abord quelle exigence est bloquante et si elle est reproductible.

Option À retenir lorsque… Points à vérifier Limites à intégrer
Runner macOS hébergé L’image disponible satisfait les besoins du travail Étiquette actuelle, architecture, outils, tests et signature Votre marge de contrôle dépend de l’image et des possibilités de configuration documentées
Runner Mac autogéré Une dépendance ou une exigence réseau impose un environnement maîtrisé Installation et mise à jour, accès réseau, secrets, isolation et responsabilité d’exploitation Votre équipe prend en charge la maintenance, la sécurité et la disponibilité de l’hôte
Mac distant administré Vous avez besoin d’un hôte macOS contrôlable sans acheter immédiatement un poste pour chaque usage Accès, livraison, durée de location, emplacement et procédures de reprise réellement proposés Vérifiez les conditions publiées et la compatibilité de vos tâches ; ne supposez pas une capacité ou un délai non documenté

Dans le tableau, la solution autogérée est l’option nommée par GitHub dans sa documentation sur l’utilisation des Runner autogérés dans un workflow. La documentation décrit le mécanisme d’utilisation ; elle ne décide pas si cette charge d’exploitation convient à votre équipe. Évaluez notamment qui met à jour l’image, qui contrôle les secrets, comment les accès sont limités et qui prend en charge l’hôte en cas de panne.

Pour un essai macOS-26 Runner, vérifiez d’abord que l’étiquette est prise en charge au moment du test, que l’image contient les outils nécessaires et que l’architecture correspond aux dépendances. Le nom de version seul n’établit ni la disponibilité ni la compatibilité. Conservez les résultats des tâches représentatives avant de déplacer les travaux de publication ou d’élargir le routage.

Procédure de reprise et décision

Appliquez la procédure suivante dans l’ordre, en conservant les preuves à chaque étape :

  • Repérez le travail touché. Notez le commit, le workflow, le travail en échec et son état : en attente, interrompu ou terminé avec une erreur.
  • Résolvez l’étiquette réellement demandée. Examinez runs-on, les expressions, les matrices et les groupes de Runner ; comparez le résultat à l’annonce et aux étiquettes officielles à jour.
  • Confirmez l’environnement attribué. Enregistrez les propriétés runner visibles dans les journaux et comparez l’architecture observée à celle attendue par vos dépendances.
  • Vérifiez la chaîne d’outils. Relevez Xcode, le SDK, les outils en ligne de commande et le runtime de simulateur effectivement sélectionnés ; confrontez-les au manifeste de l’image.
  • Localisez la première étape défaillante. Rejouez séparément compilation, tests, archive et publication sur le même commit, en conservant les journaux et les artefacts.
  • Validez la signature indépendamment. Contrôlez l’identité, le profil, le trousseau et les justificatifs dans l’environnement utilisé par le flux de publication.
  • Comparez les solutions d’hébergement seulement si nécessaire. Documentez la contrainte non satisfaite et testez-la sur un travail réel avant de choisir un Runner autogéré ou un Mac distant.

Règle de décision : si le Runner attribué satisfait les exigences d’architecture et d’outillage, corrigez la configuration ou le workflow, puis validez toute la chaîne de livraison. Si une contrainte récurrente est démontrée par des journaux et que les images disponibles ne la satisfont pas, comparez l’exploitation d’un Runner autogéré à celle d’un Mac distant. Si vous ne pouvez pas isoler la contrainte, ne migrez pas encore l’ensemble des travaux : produisez d’abord un essai minimal reproductible.

Un plan de reprise doit aussi identifier le propriétaire de chaque action : plateforme pour l’image et l’attribution, équipe applicative pour les dépendances et les tests, responsable de publication pour les justificatifs et l’acceptation des artefacts. Fixez les critères de retour au routage normal avant l’essai : mêmes contrôles requis, mêmes conditions de signature et éléments de preuve conservés. Cela réduit le risque qu’une correction temporaire soit prise pour une restauration complète.

Choisir un hôte à partir des preuves

Si vous restez sur un Runner hébergé compatible, vous évitez d’introduire une responsabilité d’exploitation supplémentaire, mais vous devez accepter que les images et leurs logiciels évoluent selon leur documentation. Un Mac autogéré permet de contrôler davantage l’environnement, au prix de la maintenance, de la sécurisation et de la disponibilité de l’hôte. Un Mac distant peut être pertinent quand le besoin porte sur un environnement macOS contrôlable sans achat immédiat, mais vous devez vérifier l’accès, la livraison, la durée de location et les conditions de reprise sur les pages réellement disponibles.

Pour comparer les modalités commerciales sans présumer d’un tarif ou d’une configuration, consultez les informations de tarification publiées par MACNOX, puis confrontez-les à votre charge réelle : fréquence des compilations, tâches de publication et exigences d’accès. N’en déduisez pas une capacité, une disponibilité ou un délai de récupération qui ne serait pas explicitement indiqué.

Un Runner hébergé peut ne pas convenir si le projet exige un outil ou un accès réseau absent de l’image ; un Mac autogéré peut être disproportionné si personne ne peut en assurer les mises à jour et la sécurité. La location d’un Mac n’est pas automatiquement la bonne réponse non plus : elle ne remplace pas la validation des dépendances et de la signature, et ne convient pas à une équipe qui doit absolument administrer elle-même chaque composant ou disposer d’une interface physique particulière. Si vos preuves montrent qu’un hôte macOS contrôlable répond à un besoin temporaire ou à un pilote de charge, examinez les conditions publiées par MACNOX sur la page consacrée aux Mac disponibles, puis validez le parcours avec votre propre workflow avant d’y déplacer une publication critique.

SECTION 02Pour aller plus loin