DevOps / CI/CD

Comment isoler GitLab Runner macOS : guide de déploiement 2026 en entreprise

Un Shell executor GitLab exécute les tâches avec les permissions de l’utilisateur qui fait tourner le Runner, ce que GitLab décrit comme un risque élevé pour l’hôte et le réseau dans sa documentation officielle sur la sécurité du Shell executor. La conclusion opérationnelle est donc immédiate : les projets d’un même domaine de confiance peuvent partager un Mac Runner, mais les tâches de signature et de publication doivent utiliser un Runner macOS protégé et dédié. Pour plusieurs équipes, le meilleur compromis est un pool hybride associant nœuds partagés, nœuds sensibles et capacité temporaire.

Cette méthode concerne les équipes de plateforme qui gèrent plusieurs projets iOS et souhaitent créer un pool de compilation macOS partagé. Elle s’adresse également aux responsables sécurité qui protègent certificats, trousseaux et identifiants de publication, ainsi qu’aux décideurs IT qui comparent achat, location et configuration mixte de Mac Runner.

1. Mesurer la frontière de confiance avant de partager un Mac

La première erreur consiste à regrouper les projets par département, filiale ou équipe, puis à considérer cette organisation comme une isolation technique. Une frontière de confiance doit plutôt être établie à partir de la sensibilité du code source, du droit de modifier les pipelines, de la présence de contributions externes et de l’autorisation de publier une application.

Le risque apparaît lorsque deux projets exécutés sur le même compte système peuvent consulter le répertoire de travail, les caches, les artefacts ou les fichiers temporaires laissés par une tâche précédente. Avec un macOS Shell executor, les étiquettes GitLab et les règles de branche filtrent l’entrée logique dans le pipeline, mais elles ne transforment pas un même hôte en plusieurs machines indépendantes.

Matrice de confiance à faire valider

Critère d’évaluation Faible sensibilité Sensibilité élevée Conséquence pour le Runner
Code source Projet interne, équipe stable, accès contrôlé Code propriétaire critique ou dépôt avec contributeurs externes Partage possible dans le premier cas, nœud séparé dans le second
Modification du pipeline Mainteneurs appartenant au même périmètre Utilisateurs pouvant injecter des commandes ou modifier les étapes Revue obligatoire ou Runner dédié
Signature Compilation sans certificat de distribution Signature, notarisation ou publication Nœud protégé, accès limité et traçable
Données temporaires Aucun secret persistant ni artefact sensible Trousseau, profils de provisioning ou jetons de publication Nettoyage renforcé ou séparation physique
Besoin de continuité Compilation non urgente Fenêtre de publication contractuelle Pool de secours ou capacité réservée

Les projets iOS peuvent-ils utiliser le même GitLab macOS Runner ?
Oui, mais seulement lorsqu’ils appartiennent au même domaine de confiance et qu’aucun projet ne peut introduire une tâche non contrôlée dans le même environnement. Un projet avec une chaîne de publication, un dépôt ouvert aux contributions externes ou des mainteneurs issus d’un autre périmètre doit être placé sur un Runner plus restreint.

Pour formaliser cette décision, la plateforme peut créer une matrice projet–tâche–actif. Elle indique, pour chaque pipeline, si le job compile seulement, accède à un trousseau, produit un artefact livrable ou déclenche une publication. Si une même machine reçoit plusieurs niveaux de sensibilité sans contrôle complémentaire, le partage doit être refusé.

2. Choisir la portée du Runner et le chemin d’exécution

La portée du Runner définit quels projets peuvent le sélectionner et quelle équipe en assume l’administration. GitLab distingue notamment les Runners associés à un projet, à un groupe ou à l’instance. La documentation GitLab sur la portée des Runners doit être utilisée pour vérifier le modèle retenu, car cette portée ne constitue pas à elle seule une isolation du système de fichiers.

Portée Utilisation adaptée Avantage Limite à traiter
Projet Publication d’une application ou équipe très sensible Visibilité étroite et responsabilité claire Capacité moins mutualisée
Groupe Plusieurs dépôts d’une même unité de confiance Administration centralisée Tous les projets du groupe doivent réellement partager le même niveau de confiance
Instance Pool commun à plusieurs unités Mutualisation maximale Risque de routage trop large et gouvernance plus complexe

La règle de routage doit être restrictive. Les jobs doivent porter des étiquettes explicites correspondant au type de capacité recherché, par exemple compilation générale, publication protégée ou validation d’un outil audio, vidéo ou de design. Les tâches sans étiquette ne doivent pas pouvoir tomber par défaut sur un nœud sensible.

La documentation GitLab sur les étiquettes et les Runners protégés permet de contrôler la relation entre étiquettes, branches ou balises protégées et Runner protégé. Cette relation est utile pour réduire les chemins accidentels, mais elle ne remplace pas une séparation de l’hôte.

Contrôle de routage Test positif attendu Test négatif obligatoire Décision
Étiquette de compilation Le projet autorisé atteint le pool de compilation Un projet hors périmètre ne peut pas le sélectionner Partage limité au domaine validé
Étiquette de publication Une branche ou balise protégée atteint le Runner dédié Une branche ordinaire est refusée Publication maintenue derrière une barrière
Portée de groupe Les dépôts autorisés voient le Runner Un dépôt voisin ne le voit pas Groupe acceptable seulement si la confiance est homogène
Tâche sans étiquette Le job est bloqué ou dirigé vers un pool explicitement non sensible Aucun job implicite n’atteint le nœud protégé Routage par défaut corrigé

Les étiquettes GitLab et les branches protégées remplacent-elles l’isolation de l’hôte ?
Non. Elles contrôlent la sélection du Runner et certaines conditions de déclenchement, mais elles ne suppriment pas les fichiers résiduels, les caches, les processus ou les permissions du compte système. Elles doivent être considérées comme un contrôle de routage, jamais comme une isolation physique ou système complète.

3. Séparer les identités, les certificats et les secrets

Un Runner authentication token, une identité de dépôt, un certificat Apple, un profil de provisioning, un trousseau macOS et un identifiant de publication ne doivent pas être placés dans une seule couche d’accès. Leur exposition n’a pas le même impact et leur durée de vie doit être différente.

Le jeton d’authentification permet l’enregistrement ou l’accès du Runner selon le modèle configuré. Les variables CI/CD peuvent contenir des secrets de dépôt ou de publication, tandis que le trousseau conserve des clés privées utilisables par les outils de compilation. GitLab documente les mécanismes de protection des variables CI/CD et les risques liés aux jetons d’authentification des Runners.

Une architecture convenable sépare au minimum les rôles suivants :

  • le Runner de compilation générale, qui ne conserve pas de certificat de distribution permanent ;
  • le Runner de validation protégée, qui reçoit les actifs nécessaires pendant la tâche ;
  • le Runner de publication, dont la portée est étroite et qui n’accepte que des pipelines protégés ;
  • le système de stockage ou de rotation des secrets, qui ne doit pas être confondu avec le répertoire de travail.

Le principe important n’est pas seulement de masquer une variable dans les journaux. Il faut empêcher une tâche non autorisée de demander la variable, d’ouvrir le trousseau ou de réutiliser un artefact créé par un autre projet.

Une tâche de signature iOS doit-elle disposer d’un Runner GitLab séparé ?
Dans une entreprise multi-projets, la réponse recommandée est oui dès que la tâche utilise une clé de distribution, un trousseau de publication ou un identifiant permettant de livrer une application. Un partage peut être envisagé pour des projets appartenant au même périmètre de confiance, mais le Runner de publication doit alors rester protégé, avec une portée réduite et une procédure de rotation vérifiable.

Les environnements protégés ajoutent une barrière utile autour des tâches de publication. Les règles applicables doivent être vérifiées dans la documentation GitLab sur les environnements protégés. Pour chaque actif sensible, l’équipe doit conserver une preuve de la portée de la variable, du moment de création du trousseau, de sa destruction et de la rotation du jeton.

Attention : supprimer un fichier de certificat à la fin d’un job ne prouve pas que la clé n’a pas été copiée vers un cache, un artefact, un journal ou un processus encore actif. L’acceptation doit porter sur le chemin complet de l’actif, de son injection à sa révocation.

4. Définir le nettoyage et prouver l’absence de résidus

Le nettoyage est souvent présenté comme une commande finale du pipeline. Cette approche est insuffisante lorsqu’un job malveillant ou simplement défaillant peut lire les fichiers avant l’étape de nettoyage. L’objectif est d’abord de réduire la confiance nécessaire au partage, puis de vérifier que l’environnement revient à une ligne de base définie.

Les éléments à examiner comprennent le dossier du projet, les fichiers de configuration générés, DerivedData, les dépendances téléchargées, les caches de compilation, les artefacts, les journaux, les trousseaux temporaires et les processus lancés en arrière-plan. Un projet audio ou vidéo peut également produire des fichiers volumineux et des caches spécifiques qui compliquent la remise à zéro ; un projet de design peut conserver des polices, extensions ou ressources propriétaires dans des emplacements inattendus.

La méthode dépend du niveau de confiance :

  • pour des projets homogènes, un répertoire de travail dédié au job, suivi d’un effacement contrôlé, peut convenir ;
  • pour des projets appartenant à des équipes différentes, un compte système séparé réduit certains accès, sans constituer automatiquement une isolation complète ;
  • pour la signature et la publication, un hôte réservé reste préférable lorsque la clé privée ou le trousseau ne doit jamais cohabiter avec des tâches ordinaires ;
  • pour des contributions non fiables, la tâche doit être refusée sur le pool partagé plutôt que compensée par un script de suppression.

L’équipe doit exécuter un scénario de validation en deux temps : un projet écrit volontairement des marqueurs dans les emplacements surveillés, puis un autre projet tente de les retrouver après la remise à zéro. Le test doit également vérifier les processus persistants, les caches, les artefacts accessibles et les journaux de la tâche précédente.

5. Relier l’isolation à la capacité réelle du pool

Une séparation plus stricte diminue la capacité mutualisable. Un Runner dédié à la publication peut rester inactif entre deux fenêtres de livraison, tandis qu’un pool partagé peut accumuler une file d’attente lorsqu’une équipe lance plusieurs compilations en parallèle. Il faut donc mesurer simultanément la sécurité et le service rendu.

Le guide GitLab de conception d’un parc de Runners fournit un cadre pour organiser les pools et leur gouvernance. Il ne permet toutefois pas de déduire une capacité universelle : la durée dépend du projet, des dépendances, de la version d’Xcode, des tests, du stockage et de la configuration matérielle.

Indicateur Méthode de collecte Seuil de décision à définir en interne Effet sur l’architecture
Temps d’attente en file Export des heures de création et de démarrage des jobs Limite liée à la fenêtre de livraison Ajouter un nœud partagé ou revoir les étiquettes
Durée de compilation Rejeu d’un projet représentatif Référence propre à chaque pipeline Éviter de dimensionner selon une moyenne abstraite
Échecs et relances Classification des erreurs par cause Niveau acceptable selon le type de job Séparer problème d’outil, de dépendance et de capacité
Temps de publication Mesure de la chaîne protégée complète Compatible avec la fenêtre prévue Réserver un Runner ou un secours
Récupération après incident Chronométrage d’une remise en service Objectif validé par l’IT Prévoir image de référence et capacité de repli

Xcode 27 doit être évalué avec un projet représentatif, et non avec une installation vide. Les conditions de macOS et de matériel doivent être vérifiées dans les exigences système officielles d’Apple pour Xcode. La présence de l’outil ne prouve pas que les dépendances, la signature, les tests et les extensions utilisées par l’entreprise fonctionneront dans le pipeline réel.

Il est préférable d’enregistrer les résultats d’un rejeu reproductible : temps d’attente, durée de chaque étape, taille des caches, échec éventuel de signature, état du trousseau après le job et résultat d’une reconstruction sur un nœud remis à zéro. Il ne faut pas publier un nombre fixe de tâches simultanées sans mesure issue des projets concernés.

6. Appliquer une stratégie partagée, dédiée ou hybride

Trois modèles peuvent être comparés sans transformer la sécurité en simple question de prix.

Modèle Projets acceptés Points forts Risques ou coûts cachés
Pool partagé Projets de même confiance, sans publication sensible Meilleure utilisation de la capacité Résidus, routage trop large et nettoyage plus exigeant
Pool dédié Publication, secrets critiques, projets très sensibles Frontière claire et audit plus simple Capacité inactive et coût de réservation plus élevé
Pool hybride Compilation générale partagée et publication séparée Compromis adapté aux entreprises multi-équipes Gouvernance, étiquettes et procédures plus complexes

Le modèle partagé est acceptable lorsque les projets disposent d’un niveau de confiance comparable, que les mainteneurs sont connus et que les tests négatifs démontrent l’impossibilité d’atteindre le pool protégé. Le modèle dédié s’impose lorsque la tâche utilise une clé de distribution, une publication contrôlée ou un dépôt dont le contenu ne doit pas cohabiter avec d’autres projets.

Le modèle hybride est généralement le plus cohérent pour une organisation qui gère plusieurs applications : le pool commun absorbe les compilations ordinaires, le pool sensible traite la signature, et une capacité temporaire ou de secours absorbe les pics sans exposer les secrets de publication à tous les jobs.

Checklist d’acceptation avant mise en production

  • [ ] Chaque projet est rattaché à un domaine de confiance documenté, avec un responsable identifié.
  • [ ] La matrice projet–tâche–actif indique les jobs qui compilent, signent, publient ou produisent des artefacts sensibles.
  • [ ] La portée du Runner est limitée au projet ou au groupe réellement autorisé.
  • [ ] Les étiquettes des jobs sont obligatoires pour atteindre un nœud sensible.
  • [ ] Les tâches sans étiquette ne peuvent pas être routées implicitement vers le Runner de publication.
  • [ ] Les branches ou balises protégées sont reliées à un environnement de publication protégé.
  • [ ] Les tests positifs confirment le chemin autorisé vers chaque pool.
  • [ ] Les tests négatifs démontrent qu’un projet non autorisé ne peut pas sélectionner le Runner sensible.
  • [ ] Les variables, certificats, profils, trousseaux et jetons ont des portées distinctes.
  • [ ] Le Runner de compilation ordinaire ne conserve pas durablement les actifs de publication.
  • [ ] Les répertoires de travail, caches, artefacts, journaux et processus résiduels sont inspectés après un job.
  • [ ] Un rejeu avec Xcode 27 et le projet réel confirme la compilation, les dépendances et la signature attendue.
  • [ ] Une procédure de remise à zéro permet de restaurer la ligne de base documentée.
  • [ ] Un nœud de secours ou une procédure de repli existe pour la fenêtre de publication.
  • [ ] Les responsables sécurité, plateforme et produit ont signé la décision de partage ou de séparation.

7. Préparer l’exploitation et la reprise

L’isolation n’est pas achevée lorsque le pipeline passe au vert. Une rotation de jeton, une mise à jour macOS, une modification de branche protégée ou un changement de dépendance peut élargir le chemin d’accès sans alerte visible. Les règles doivent donc être contrôlées périodiquement et après chaque modification de portée.

La documentation interne doit préciser qui peut enregistrer, désactiver ou réaffecter un Runner, qui peut modifier les étiquettes, qui approuve une publication et qui examine les journaux. Les équipes doivent conserver les preuves de rotation des jetons et la date des derniers tests négatifs. Les conditions d’Apple et les capacités documentées par GitLab doivent être réexaminées lorsque l’exécuteur, les règles de sécurité, les exigences Xcode ou les mécanismes de pipeline changent.

Pour les entreprises qui évaluent une capacité distante, une Mac louée peut servir de nœud pilote sans imposer immédiatement l’achat d’un parc physique. Une console distante de KuzCloud permet d’abord de vérifier l’accès, la préparation de l’environnement et la procédure de remise en état. Les conditions de traitement des données doivent être comparées aux exigences internes dans la politique de confidentialité de KuzCloud, particulièrement lorsque le Runner manipule des dépôts privés ou des journaux de compilation.

Le déploiement doit rester progressif : une machine isolée valide l’enregistrement du GitLab Runner, le routage, Xcode 27, la signature et la récupération ; les mesures de file d’attente et d’échec déterminent ensuite s’il faut ajouter un pool partagé ou un Runner de publication séparé. Cette démarche évite de réserver trop tôt plusieurs nœuds dont la capacité réelle n’a pas encore été observée.

Un Mac acheté sur site conserve l’avantage du contrôle physique et peut convenir à une charge lourde, stable et prévisible, mais il impose l’immobilisation du capital, le remplacement du matériel, la surveillance locale et la gestion des périodes d’inactivité. Une infrastructure distante mal séparée, à l’inverse, ne résout pas automatiquement les risques de secrets, de nettoyage ou de routage : elle doit être configurée avec les mêmes contrôles de confiance.

Pour un pilote ou une capacité variable, louer un Mac auprès de KuzCloud peut offrir une mise à disposition plus souple qu’un achat immédiat, notamment pour valider un Runner de publication, une chaîne Xcode 27 ou un scénario de reprise avant d’agrandir le parc. La décision reste défavorable à la location lorsque l’entreprise exige un accès physique permanent, une charge soutenue sans variation ou une politique qui interdit tout traitement hors de son propre site. Dans les autres cas, commencer par un nœud isolé et mesurer la file, la stabilité et la récupération donne une base plus solide qu’un achat dimensionné sur des hypothèses.

La décision finale est donc conditionnelle : partagez uniquement les tâches d’un même domaine de confiance, dédiez les tâches de signature et de publication, puis adoptez un pool hybride lorsque plusieurs équipes doivent compiler sans partager leurs actifs sensibles. Avant toute extension, faites valider la matrice de confiance, les tests de routage, le nettoyage et la reprise sur une Mac distante KuzCloud ; les données réelles de file d’attente et de publication indiqueront ensuite si une capacité supplémentaire est justifiée.

Isolez vos environnements macOS avec KuzCloud

Déployez des Mac dédiés pour séparer les projets sensibles et limiter les risques entre vos pipelines.

Accédez à distance à des nœuds macOS prêts à l’emploi depuis une console centralisée.