Les équipes CI mobiles sur Mac mini M4 augmentent souvent le parallélisme xcodebuild parce que les graphes CPU semblent encore vides—puis constatent que le p95 de file monte alors que chaque processus n’affiche qu’environ quarante pour cent d’utilisation. Cette matrice 2026 sépare les voies limitées par la compilation des voies limitées simulateur/IO, documente comment les choix -destination entrent en collision sur la mémoire unifiée, et propose neuf étapes de déploiement avec garde-fous numériques à coller à côté de votre YAML d’orchestrateur.
Lisez-la avec les throttles workers simulateur parallèle et le sharding des tests UI sur Mac mini M4 pour ne pas empiler trois « boutons de parallélisme » qui se disputent le même budget DRAM. Si les artefacts disque grandissent plus vite que la concurrence, confrontez d’abord la matrice de rétention disque avant de blâmer Xcode.
Pourquoi le pourcentage CPU ment sur l’hôte CI Apple Silicon
La mémoire unifiée signifie que le GPU, le Neural Engine et les contrôleurs CPU partagent le même pool physique. Une voie qui passe son temps dans la composition des tampons CoreSimulator ou la préparation de pipelines Metal peut afficher un CPU modeste tout en affamant des jobs frères qui ont besoin de bande passante mémoire pour compiler des modules Swift. Le copy-on-write APFS amplifie l’illusion : supprimer et recréer des jeux de données simulateur peut faire exploser le trafic métadonnées sans bouger les courbes « CPU occupé ».
- Caches CoreServices partagés : plusieurs destinations frappent les mêmes démons auxiliaires et caches verrouillés.
- Rafales de boot : lancer quatre simulateurs en parallèle semble correct jusqu’à ce qu’un watchdog SpringBoard redémarre silencieusement une voie.
- Contention Metal : captures UI et tests GPU légers rivalisent encore avec le cache de shaders de compilation sur la même tranche GPU.
Règle opérateur : si deux destinations partagent la même famille udid et la même tranche DerivedData, vous n’avez pas créé d’isolation—vous avez créé une course.
Matrice A — type de voie vs parallélisme sûr sur paliers M4
| Type de voie | Palier 24 Go | Palier 36–48 Go | Notes |
|---|---|---|---|
| Compilation Swift seule | 2 lourdes | 3 lourdes | Associez des racines DerivedData par job ; surveillez les pics mémoire du front-end compilateur. |
| Tests unitaires (sans UI) | 2 | 3 | Allouent quand même des simulateurs—ne les traitez pas comme « gratuits » vs compile pure. |
| XCUITest + captures | 1 | 2 | GPU et disque dominent ; suivez le guide de sharding pour scaler la flotte. |
Matrice B — symptôme vs goulot probable vs première mitigation
| Symptôme | Goulot probable | Mitigation |
|---|---|---|
Déconnexions aléatoires DTXProxy |
IPC simulateur + pression mémoire | Réduisez les voies UI parallèles ; ajoutez des hooks d’arrêt entre suites. |
| La compile ralentit quand les jobs UI tournent | Bande passante mémoire unifiée | Séparez pools compile/UI par label ; planifiez l’UI hors pic. |
| Disque à 60 % libre mais builds lents | Fragmentation APFS / churn d’inodes | Faites tourner des volumes locaux par job chaque semaine ; évitez un DerivedData géant partagé. |
Garde-fous numériques pour orchestrateurs
- Plafond UI par hôte : gardez les destinations XCUITest concurrentes à 1 sur les machines 24 Go sauf preuve de profilage d’au moins 6 Go récupérables après boot.
- Éventail compile : plafonnez les workers
-parallel-testing-enabledà la moitié des cœurs performance physiques en présence de simulateurs. - Filigrane disque : suspendez les nouvelles destinations parallèles quand l’espace libre APFS tombe sous 18 % sur les volumes CI—en dessous, la création CoreSimulator échoue de façon opaque.
Lien capacité : quand les matrices montrent que vous dépassez un hôte, mappez la concurrence vers les SLO de capacité de pool avant d’acheter seulement plus de disque.
Invocations qui survivent à la revue de code
Traitez les arguments xcodebuild comme un contrat API : encapsulez-les dans de petites fonctions shell ou des ancres YAML pour que chaque voie définisse -derivedDataPath, -clonedSourcePackagesDirPath et -resultBundlePath de façon homogène. Coller des commandes ad hoc dans la CI « pour débloquer » vous prive de corréler régressions de saturation et dérive de configuration. Préférez des blocs -destination explicites versionnés aux globbing shell qui change entre vendredi soir et lundi matin.
Pour les builds matriciels, shard par classe de test ou cible—pas seulement par nom de destination—afin que chaque shard porte une signature GPU/IO prévisible. Associez manifestes de shard et politiques d’upload pour que les shards en échec publient encore des bundles xcresult avant les nettoyages agressifs. Journalisez le nombre effectif de cœurs performance et l’état thermique si l’orchestrateur l’expose ; macOS peut throttler discrètement sous charge UI parallèle soutenue même si les ventilateurs semblent calmes à distance.
Caches centralisés : accélérateur ou bombe IO
Des DerivedData ou caches SwiftPM partagés réduisent fortement les builds à froid, mais sérialisent aussi les écritures métadonnées quand des dizaines de jobs martèlent le même arbre. Si vous centralisez, isolez sur des volumes APFS rapides avec marge d’inodes généreuse et imposez des sous-dossiers par job pour que les tempêtes de verrous ne traversent pas les équipes. Couplez les hits de cache à des politiques d’éviction explicites—des module maps obsolètes sont pires que des manques car ils échouent mystérieusement jusqu’à purge manuelle.
Quand les caches vivent sur stockage réseau, attendez-vous à des pics de latence déguisés en simulateurs flaky ; privilégiez le NVMe local pour les chemins chauds et répliquez les artefacts de façon asynchrone. Documentez quelles voies peuvent lire/écrire un cache partagé vs miroirs lecture seule pour garder les revues sécurité traçables.
Neuf étapes de déploiement pour les propriétaires de plateforme build
- Étiquetez les voies compile, unitaire ou UI dans les métadonnées d’orchestrateur—des libellés lisibles battent les nombres magiques.
- Épinglez les destinations à des UDID simulateur explicites en CI, pas seulement aux noms « dernier iPhone ».
- Mesurez le temps mural par type de voie chaque semaine ; les régressions précèdent les builds rouges.
- Isolez DerivedData par identifiant de voie ; interdisez le partage implicite entre jobs matriciels.
- Plafonnez Metal quand les tests UI capturent de la vidéo ; sérialisez si nécessaire.
- Arrêt simulateur automatisé après chaque shard ; alignez la cadence d’effacement sur le guide throttle.
- Alertez sur la latence IO via métriques proxy (variance de durée d’étape) quand les compteurs noyau manquent.
- Documentez l’escalade vers des contrôles VNC lorsque des invites TCC apparaissent au milieu d’une suite.
- Scalez géographiquement sur Hong Kong, Japon, Corée du Sud, Singapour et États-Unis avant d’empiler des voies incompatibles sur un runner héroïque unique.
FAQ
xcodebuild -parallelizeTargets aide-t-il la CI ?
Parfois pour les apps multi-cibles, mais cela empile des front-ends compilateur—mesurez avant d’activer globalement sur hôtes partagés.
Faut-il épingler d’anciens runtimes simulateur pour la stabilité ?
Oui pour la reproductibilité, mais suivez les dates de fin de support Apple ; documentez des fenêtres de montée de version avec les épingles Xcode.
Où lire SSH et VNC pour Mac distants ?
Commencez par le centre d’aide et utilisez VNC lorsque des problèmes simulateur interactifs exigent une GUI.
Dimensionner correctement les destinations xcodebuild parallèles, c’est garder la CI Apple Silicon M4 honnête : la puce est rapide, mais la mémoire unifiée et les métadonnées APFS transforment un parallélisme naïf en files cachées. macOS natif avec automatisation SSH d’abord et VNC optionnel pour les invites simulateur bloquées correspond aux labs mobiles sérieux. Louer des Mac mini M4 dédiés à travers Hong Kong, le Japon, la Corée du Sud, Singapour et les États-Unis permet de séparer pools compile lourds et UI lourds sans CapEx, et l’isolation physique bat l’empilement de destinations incompatibles sur un seul disque. Quand les matrices montrent de la contention, ouvrez les tarifs et ajoutez des hôtes plutôt que de tourner les boutons de parallélisme à l’aveugle.