DevOps / CI/CD

macOS 27 : déployer un Mac auto-hébergé pour Docker CI ? Guide 2026

macOS 27 : déployer un Mac auto-hébergé pour Docker CI ? Guide 2026

Le point décisif est une exigence de la documentation GitHub : les runners auto-hébergés qui exécutent des actions conteneur ou des conteneurs de service doivent utiliser Linux (conditions des runners auto-hébergés). Un Mac sous macOS 27 peut donc convenir à des étapes shell qui lancent un build Docker, mais il ne remplace pas un runner Linux pour toute la chaîne. Avant de le déployer, vérifiez la prise en charge de macOS par Docker Desktop, la licence de l’équipe et les permissions réelles de l’environnement.

Ce guide s’adresse aux ingénieurs DevOps qui ajoutent la construction d’images Docker à GitHub Actions, aux équipes combinant des étapes macOS et Docker, ainsi qu’aux responsables évaluant un Mac loué pour leur CI.

Dernière mise à jour : 4 octobre 2026. Les informations sont vérifiées à partir des documentations GitHub, Docker et Apple citées dans l’article ; la compatibilité de macOS 27 doit être revérifiée dans la documentation Docker au moment de l’installation.

Délimiter les tâches Mac avant de réserver un runner

Une chaîne « Docker CI » peut recouvrir des opérations différentes. Les traiter comme un seul bloc conduit souvent à choisir le mauvais runner. Distinguez les commandes shell exécutées sur l’hôte, la construction d’une image, les actions conteneur et les conteneurs de service utilisés par un travail.

Sur Mac, un script shell peut appeler le client Docker afin de construire une image, sous réserve que Docker Desktop et son moteur fonctionnent sur cette machine. Cela ne signifie pas que l’environnement Mac peut exécuter toutes les fonctionnalités conteneurisées de GitHub Actions. Les actions conteneur et les conteneurs de service ont leur propre exigence Linux. Une tâche qui en dépend doit être routée vers Linux, même si une commande docker buildx fonctionne sur le Mac.

Prenons le cas d’une équipe qui compile ou prépare un artefact dans un environnement macOS, puis crée une image à partir d’un répertoire de fichiers. Si la construction est déclenchée par un script shell sur l’hôte, le Mac peut être candidat. Si le même travail déclare un service de base de données ou appelle une action empaquetée en conteneur, il faut examiner ses dépendances et probablement séparer les étapes. Le nom du travail ou la présence de Docker CLI ne suffit pas à déterminer sa compatibilité.

Voici le premier tri à faire :

  • Shell sur macOS : conserver sur Mac les commandes qui requièrent réellement macOS.
  • Construction d’image depuis le shell : tester Docker Desktop sur le Mac visé avant d’y router des tâches récurrentes.
  • Action conteneur ou conteneur de service : utiliser un runner Linux pour le travail concerné, conformément aux exigences GitHub sur les runners auto-hébergés.
  • Flux mixte : scinder les tâches et transmettre les artefacts nécessaires entre les runners, plutôt que de supposer que le même runner convient à toutes les étapes.

Cette séparation évite une erreur coûteuse : enregistrer un Mac, y installer Docker, puis découvrir seulement après l’intégration que des jobs essentiels ne peuvent pas s’y exécuter.

Inscrire le runner et contrôler son routage

Le choix entre inscription au niveau d’un dépôt et de l’organisation dépend du périmètre d’utilisation et de la gouvernance de l’équipe. Un runner destiné à un seul dépôt peut rester limité à ce périmètre ; un runner partagé demande une politique claire sur les dépôts qui peuvent lui envoyer du travail. Suivez la procédure correspondant au périmètre retenu dans la documentation GitHub sur l’ajout d’un runner auto-hébergé. N’accordez pas à un runner partagé un accès plus large que nécessaire.

Pour l’inscription, préparez d’abord la machine cible et vérifiez qu’elle peut communiquer avec GitHub. La documentation des runners décrit les exigences de connexion, notamment le trafic HTTPS sortant sur le port 443. Cette donnée est utile pour contrôler un pare-feu d’entreprise ou une règle réseau de Mac loué. Elle ne garantit pas à elle seule que les autres services nécessaires au workflow sont accessibles.

Attribuez des étiquettes lisibles, puis utilisez-les pour sélectionner le runner dans le workflow. Les runners auto-hébergés reçoivent des étiquettes par défaut associées à self-hosted, au système d’exploitation et à l’architecture ; une tâche qui spécifie plusieurs étiquettes ne correspond qu’à un runner qui les possède toutes. Consultez les règles GitHub de routage par étiquettes et groupes avant de construire vos filtres.

Une configuration de principe pourrait cibler self-hosted et macOS, puis ajouter une étiquette d’usage interne comme docker-host-build. Cette étiquette doit désigner une capacité réellement testée, pas une promesse générale de compatibilité. Les noms et la syntaxe doivent correspondre aux étiquettes effectivement définies dans l’organisation.

Procédure de mise en place :

  1. Décidez si le runner appartient à un dépôt ou s’il doit être partagé au niveau de l’organisation.
  2. Vérifiez l’accès réseau sortant et préparez le compte système qui exécutera les tâches.
  3. Ajoutez le runner en suivant la procédure officielle adaptée au périmètre choisi.
  4. Confirmez son état en ligne et ses étiquettes dans l’interface GitHub.
  5. Créez un workflow de test dont les étiquettes correspondent exactement à celles du Mac.
  6. Vérifiez dans les journaux que le job s’est exécuté sur le runner attendu, puis retirez les étiquettes provisoires qui ne sont pas utiles.

Le routage doit refléter les besoins réels du job. Un filtre macOS ne transforme pas un runner Mac en environnement Linux ; une étiquette personnalisée ne change ni les capacités du système ni les limites de GitHub Actions.

Installer Docker Desktop sans présumer de la compatibilité

Avant d’installer Docker Desktop, consultez sa documentation officielle d’installation sur Mac. Elle précise les versions de macOS prises en charge et les conditions selon l’architecture. La compatibilité de macOS 27 n’est pas à déduire d’une version antérieure ni du fait que le Mac démarre correctement : vérifiez la liste publiée par Docker au moment du déploiement.

Cette vérification est particulièrement importante sur un environnement hébergé ou loué. La présence d’un système macOS ne prouve pas que la virtualisation requise par Docker Desktop est disponible, autorisée ou correctement configurée. Il faut effectuer l’installation et le premier démarrage sur la machine qui exécutera effectivement la CI. En cas de refus lié aux autorisations, demandez au fournisseur ou à l’administrateur quelle limite s’applique, plutôt que de contourner une restriction inconnue.

La licence constitue une vérification distincte. Docker publie les conditions d’utilisation de Docker Desktop et les situations qui nécessitent une souscription commerciale dans sa documentation sur les licences Docker Desktop. La décision dépend de l’entité, de son usage et des conditions en vigueur ; ne présumez ni que l’usage d’un runner CI est automatiquement gratuit, ni qu’une machine louée transfère la responsabilité de licence au fournisseur. Faites valider le cas par la personne responsable des achats ou de la conformité.

Les autorisations sont également à vérifier. Docker documente les permissions requises sur macOS. Sur un runner automatisé, le point concret est de savoir si le compte d’exécution peut démarrer et utiliser Docker après une reconnexion ou un redémarrage. Une installation qui marche uniquement dans une session interactive administrateur n’est pas une validation suffisante pour un agent de CI.

Vérification Mac auto-hébergé Runner Linux
Étape macOS indispensable Adapté si l’environnement et les outils sont pris en charge Ne remplace pas une étape qui requiert macOS
Build Docker lancé par une commande shell Possible après validation de Docker Desktop sur l’hôte Possible avec un moteur Docker adapté
Action GitHub exécutée en conteneur Ne convient pas à cette fonction selon l’exigence GitHub À utiliser si le job en dépend
Conteneur de service déclaré par le workflow Ne convient pas à cette fonction selon l’exigence GitHub À utiliser si le job en dépend
Conditions avant mise en production Compatibilité, licence, permissions et démarrage à vérifier sur la machine cible Vérifier l’environnement et le routage propres à l’équipe

Le tableau sert à répartir les responsabilités, pas à comparer des performances. Les résultats d’un build varient selon le projet, les dépendances, la configuration et le matériel. Aucun débit ni temps de construction ne peut être déduit de la seule étiquette « Mac ».

Valider un build hôte avec une image minimale

Une fois Docker Desktop installé, commencez par un job de test qui exécute les commandes sur l’hôte macOS. Le but est de prouver séparément que le runner accepte le job, que le client Docker est accessible, que le moteur répond et que le résultat attendu est produit. Évitez de commencer par le workflow de production complet : une erreur de permission ou de registre serait alors plus difficile à isoler.

Une première vérification peut afficher les versions disponibles, puis interroger le moteur avec une commande d’information Docker. Contrôlez le code de sortie et le contenu des journaux. La version du client seule ne prouve pas que le moteur est prêt : c’est la réponse du moteur qui confirme que la connexion fonctionne. Si le moteur n’est pas disponible, arrêtez le test et corrigez le démarrage ou les permissions avant d’essayer de construire.

Créez ensuite un répertoire temporaire avec un Dockerfile minimal et un petit fichier d’entrée. Lancez une construction via Buildx, en commençant par l’image locale et une configuration simple. La référence Buildx pour docker buildx build décrit les options de construction, de sortie et de cache. Utilisez uniquement les options nécessaires au test ; ajouter immédiatement des caches partagés ou une publication multi-plateforme multiplie les causes possibles d’échec.

À la fin de cette étape, contrôlez trois résultats distincts : la commande s’est achevée sans erreur, l’image ou la sortie demandée est présente, et le workflow a bien tourné sur le runner visé. Si la suite exige une publication, ajoutez-la dans un deuxième test avec un registre non critique et des secrets propres au dépôt. Ne placez pas de jeton dans le Dockerfile, dans les arguments visibles du shell ou dans les journaux.

La construction pour plusieurs architectures mérite un test séparé. Buildx propose des paramètres dédiés, mais la prise en charge effective dépend de l’environnement et de la méthode employée. La documentation Docker sur les constructions multi-plateformes décrit les options et leurs prérequis. Vérifiez chaque cible sur l’environnement réel ; la présence de --platform ne garantit pas à elle seule un résultat correct ni des performances prévisibles sur un Mac donné.

Pour un build qui doit publier une image, contrôlez aussi la sortie demandée par la tâche. Le résultat peut être une image exportée localement, une archive ou une image envoyée à un registre, selon la configuration choisie. Définissez précisément le résultat attendu dans le workflow, puis vérifiez-le après exécution. Un code de sortie positif ne valide ni le contenu de l’image ni les droits de publication : ajoutez des contrôles explicites adaptés au dépôt.

Répartir les jobs selon leurs dépendances réelles

Le routage vers Mac ou Linux doit suivre les fonctionnalités utilisées, et non l’étiquette générale « Docker ». Un workflow peut conserver sur Mac les tâches qui exigent macOS, puis envoyer un job indépendant de construction ou de test sur Linux. À l’inverse, si la construction appelle un outil disponible uniquement dans l’environnement macOS, la commande hôte peut rester sur Mac, mais les étapes utilisant une action conteneur ou un conteneur de service doivent être isolées sur Linux.

Avant de modifier le workflow, listez pour chaque job :

  • le système d’exploitation réellement nécessaire ;
  • les actions appelées et leur mode d’exécution ;
  • la présence de services ou de dépendances qui communiquent avec un conteneur ;
  • les fichiers, images et autres artefacts à transmettre au job suivant ;
  • les secrets nécessaires, leur portée et les dépôts autorisés à utiliser le runner.

Pour les jobs qui peuvent fonctionner sur les deux systèmes, gardez des étiquettes séparées et testez leur sélection. La documentation GitHub sur l’utilisation des runners dans un workflow décrit la sélection par étiquettes et les groupes. Un groupe permet de contrôler quels runners sont accessibles dans un contexte donné ; les étiquettes servent à sélectionner les capacités ou le système visés. Ces deux mécanismes ne remplacent pas une analyse des dépendances du job.

Décider où placer chaque étape

  • Si le job requiert macOS et n’utilise pas d’action conteneur ni de conteneur de service, routez-le vers le runner Mac, après validation de ses outils.
  • Si le job exige Docker Desktop pour une construction lancée depuis le shell, gardez-le sur Mac uniquement si l’installation, le moteur, les autorisations et la sortie ont été testés dans l’environnement cible.
  • Si le job dépend d’une action conteneur ou d’un conteneur de service, routez-le vers Linux.
  • Si le même job combine une étape macOS et une fonction réservée au runner Linux, scindez le workflow et transmettez les artefacts nécessaires.
  • Si une dépendance ou une permission reste incertaine, utilisez d’abord un runner de test, sans secrets de production, et ne routez pas encore les tâches critiques.

Cette décision conditionnelle réduit les échecs difficiles à diagnostiquer. Elle permet aussi de garder un Mac pour les étapes où son système est nécessaire, plutôt que d’y faire transiter artificiellement des opérations que Linux peut exécuter plus directement.

FAQ : inscription, compatibilité et location

Comment inscrire un runner Mac auto-hébergé dans GitHub Actions ?

Commencez par choisir le dépôt ou l’organisation qui doit gérer le runner, puis suivez la procédure officielle d’ajout correspondant à ce périmètre. Pendant l’inscription, attribuez des étiquettes décrivant le système, l’architecture et l’usage. Vérifiez ensuite avec un travail de test que la combinaison de runs-on cible bien ce Mac, sans envoyer d’autres tâches par erreur.

Un runner Mac peut-il exécuter les actions conteneur et les conteneurs de service ?

Non, pas comme substitut à un runner Linux pour ces fonctions. La documentation GitHub impose Linux aux runners auto-hébergés qui exécutent des actions conteneur ou des conteneurs de service. Un Mac peut toutefois lancer des commandes shell qui appellent Docker pour construire une image, si Docker Desktop est pris en charge et opérationnel dans l’environnement visé.

Comment valider la construction d’une image Docker sur un runner macOS ?

Commencez par un travail isolé exécutant des commandes shell sur l’hôte : vérifiez le chemin de Docker CLI, la connexion au moteur, puis construisez une image minimale avec Buildx. Contrôlez le code de retour et l’existence de l’image ou de l’artefact attendu. N’ajoutez le registre et les identifiants qu’après cette validation, puis testez l’envoi dans un dépôt de test.

Que vérifier avant de louer un Mac pour Docker CI ?

Confirmez d’abord que la version exacte de macOS figure dans les versions prises en charge par Docker Desktop, puis vérifiez l’architecture, les autorisations et la virtualisation disponibles sur la machine louée. Lisez les conditions de licence applicables à votre organisation. Enfin, installez et démarrez Docker dans l’environnement cible : ne déduisez pas sa compatibilité du seul fait qu’il s’agit d’un Mac distant.

Maintenir le runner sans exposer les secrets

Un runner auto-hébergé ajoute des tâches d’exploitation à l’équipe. Il faut surveiller sa disponibilité, limiter les dépôts qui peuvent lui envoyer des travaux, protéger les secrets, mettre à jour le logiciel runner et suivre les changements de macOS, Docker Desktop et du workflow. La gestion de l’agent ne retire pas à l’équipe le contrôle des accès à la machine.

Traitez les données temporaires comme une surface de risque. Les répertoires de travail, images locales et caches peuvent conserver des éléments d’une exécution antérieure. Définissez une politique de nettoyage, puis vérifiez-la avec un job sans données sensibles. Un cache partagé peut accélérer certains flux, mais il doit être limité et nettoyable ; il ne faut pas présumer que son contenu est isolé simplement parce que deux jobs ont des noms distincts.

Les identifiants de publication doivent rester dans le mécanisme de secrets prévu par GitHub et être accessibles uniquement aux jobs qui en ont besoin. Évitez les secrets de production dans le workflow de validation initial. Si un job peut être déclenché par du code externe ou non approuvé, examinez ses permissions avant de lui donner accès au Mac : un runner qui possède des identifiants ou des fichiers réutilisés peut exposer bien davantage que le seul résultat du build.

Déployez progressivement. D’abord un job non critique qui vérifie l’état du runner et la connexion au moteur. Ensuite un build minimal, puis un envoi vers un registre de test, enfin un essai de reprise après échec et de nettoyage. Gardez un historique des versions de macOS, Docker Desktop, du runner et des changements du workflow. Lorsqu’un build cesse de fonctionner, cet historique aide à distinguer une mise à jour de l’environnement d’une modification du code.

Pour une équipe qui compare cette approche à son environnement actuel, les solutions existantes peuvent imposer des limites différentes : un runner partagé offre moins de contrôle sur l’environnement, une machine Linux ne remplace pas les étapes qui exigent macOS, et un Mac acheté mobilise du matériel et de la maintenance même lorsque le besoin de CI varie. La location d’un Mac par ProxyMac peut être une piste pour évaluer un environnement temporaire, à condition de vérifier d’abord l’accès à la virtualisation, les permissions, la licence Docker Desktop et les responsabilités d’administration. Les modalités d’accès et les conditions applicables sont à examiner dans les informations d’aide de ProxyMac et ses conditions de service ; aucune compatibilité Docker ne doit être tenue pour acquise sans essai sur la machine concernée.

Offrez à vos pipelines CI un Mac dédié

Avec ProxyMac, louez un Mac mini M4 dédié sous macOS pour exécuter vos builds et vos tâches CI qui nécessitent un environnement Apple.
Accédez à votre machine par SSH et configurez un runner auto-hébergé adapté à votre chaîne d’intégration.