Les Mac mini M4 auto-hébergés accélèrent la CI, mais ils restent des ordinateurs dans une région : fuseau par défaut, affichage 12 h ou 24 h, premier jour de la semaine et ordre de collation diffèrent souvent de votre portable. Si vous ne figez pas ces dimensions dans la pipeline, des tests basculent à minuit, lors d’un passage DST ou simplement quand une tâche migre d’un hôte Hong Kong vers les États-Unis. Cet article propose deux matrices de décision, huit étapes de déploiement et des garde-fous numériques réutilisables dans vos runbooks pour que XCTest, les captures d’interface et la logique serveur cessent de se battre contre le runner.
Combinez ce guide avec la quarantaine des tests flaky, l’épinglage Xcode et la dérive, et les nœuds Mac dispatchables lorsque vous orchestrez des matrices multi-régions. Pour déboguer sur la même machine, utilisez VNC. Comparez les régions sur la page tarifs ; les réglages opérationnels sont résumés dans l’aide.
Pourquoi fuseau et locale ressemblent à des « flocons matériels »
Apple Silicon n’efface pas le non-déterminisme des calendriers. Un test qui appelle Date() au bord d’une fenêtre de facturation passe jusqu’à ce que l’horloge murale du runner franchisse la limite. La locale change la façon dont NumberFormatter insère des séparateurs de milliers, ce qui casse les snapshots enregistrés avec un autre LANG. Trier des noms de fichiers avec la collation par défaut est une autre source silencieuse d’échecs dépendants de l’ordre lorsque les tests supposent l’ordre POSIX alors que la CI hérite d’une collation spécifique à la langue.
- Minuit : des jobs nocturnes qui commencent à 23 h 55 locales et finissent après 00 h 05 peuvent compter deux fois ou sauter un jour si les assertions utilisent « aujourd’hui » sans horloge figée.
- Sauts DST : un job à 23 h 30 le jour du passage à l’heure d’été dispose de moins de minutes réelles que prévu ; les déclencheurs cron et les hypothèses « sleep 3600 » explosent.
- Fenêtres de certificats : TLS et la signature comparent notBefore/notAfter à l’heure murale ; la dérive rend les échecs intermittents.
- Pools multi-régions : la même branche sur un runner à Singapour et en Californie peut ne pas s’accorder sur « quel jour calendaire est vendredi » pour un train de release mondial sans référence UTC centralisée.
Matrice A : région du nœud vs contrat d’environnement CI recommandé
NodeMac exploite des hôtes Mac mini M4 bare metal à Hong Kong, au Japon, en Corée, à Singapour et aux États-Unis. Le tableau ci-dessous n’est pas une garantie juridique des réglages système—les opérateurs peuvent toujours personnaliser—mais il reflète ce que la plupart des runners non surveillés exposent tant que vous ne les surchargez pas. Encodez le contrat dans l’orchestrateur pour qu’un vert à Singapour n’implique pas un vert partout.
| Région typique du runner | Risque d’horloge murale par défaut | Baseline CI recommandée | Job matrice supplémentaire |
|---|---|---|---|
| Hong Kong / Singapour | Bords de calendrier Asie ; jours fériés différents des US | TZ=UTC, LC_ALL=C.UTF-8 pour la compilation |
Hebdomadaire avec TZ=Asia/Hong_Kong pour les reçus |
| Japon / Corée | Packs de locale présents ; numérotation des jours dans l’UI | Épinglez LANG=C.UTF-8 pour les outils CLI |
Étape snapshot avec ja_JP.UTF-8 si vous livrez une UI japonaise |
| États-Unis | 12 h par défaut ; règles DST variables selon l’état | Forcez des assertions 24 h ; n’analysez jamais « 15 h » sans locale | Semaine DST : deux heures synthétiques dans XCTest |
| Pool inter-régions | Même commit, « aujourd’hui local » différent | Centralisez la « date métier » en UTC ; convertissez seulement à la frontière UI | Ajoutez l’étiquette timezone-matrix bloquante release si rouge |
Matrice B : symptôme, sonde, correctif
| Symptôme | Sonde rapide | Pattern de correction |
|---|---|---|
| Échecs uniquement près de minuit UTC | Journalisez TZ, l’horloge système et l’histogramme d’heure de démarrage |
Gelez « maintenant » par injection de dépendance ; ajoutez des cas XCTest aux frontières |
| Snapshots numériques différents entre hôtes | Affichez LANG / LC_NUMERIC au démarrage du job |
Définissez LC_ALL=C.UTF-8 dans le plist launchd ou l’enveloppe CI |
| Flocons TLS ou notaire « aléatoires » | Comparez l’offset sntp à une référence stratum-1 |
Appliquez la discipline NTP ; échouez vite si offset > seuil |
| Tri des listes de fichiers instable | Dump de la sortie locale dans la bannière pré-job |
Triez avec un comparateur POSIX explicite en Swift ou LC_ALL=C |
Garde-fous numériques à intégrer dans la politique
- Offset NTP absolu : maintenez l’erreur d’horloge sous 250 ms en régime établi ; appelez l’astreinte si un runner dépasse 2 s sur trois contrôles consécutifs.
- Maintenance planifiée : figez les expériences de fuseau pendant 72 heures autour des transitions DST dans toute région où la logique date côté client est critique.
- Marge de timeout : ajoutez 15 % de marge horloge aux suites qui manipulent des calendriers, car les sauts de temps simulés allongent non linéairement XCTest.
Conseil audit : stockez le TZ effectif, le LANG et l’offset NTP mesuré à côté de chaque junit.xml. Le futur vous remerciera quand un flake disparaît après un correctif OS silencieux.
Huit étapes de déploiement
- Inventoriez chaque test qui appelle une horloge réelle, des formateurs sensibles à la locale ou un tri disque sans comparateur explicite.
- Émettez une bannière pré-vol dans les journaux CI : fuseau, locale, build OS, version Xcode—la même ligne que pour les audits de dérive.
- Encodez les défauts dans
EnvironmentVariableslaunchd pour que les sessions sans GUI héritent du même contrat que les shells SSH. - Ajoutez un petit helper XCTest qui fige le temps par injection ; interdisez
Date()direct dans la logique métier testée. - Planifiez une matrice hebdomadaire qui rejoue les vingt principaux tests de date sous au moins deux fuseaux où vous vendez.
- Branchez des alertes lorsque les pics d’offset NTP corrèlent aux échecs TLS—souvent plus rapide que relire des captures.
- Documentez les exceptions où le produit utilise volontairement l’heure locale (imprimantes POS) et isolez ces suites sur des runners étiquetés.
- Scalez avec des Mac mini M4 dédiés par région lorsque la profondeur de file force le partage risqué de fenêtres « presque minuit » entre équipes.
FAQ
Les serveurs et simulateurs doivent-ils partager une seule variable TZ ?
Non. Les jobs serveur doivent défaut UTC ; les simulateurs UI peuvent exiger des exécutions par locale. Mélanger les deux dans un même processus XCTest sans isolation est une source fréquente de doubles échecs.
Apple Silicon change-t-il le comportement NTP ?
Pas de façon significative. Le démon de discipline compte toujours. Ce qui change, c’est la vitesse des builds—les jobs courts masquent la dérive jusqu’à la longue suite d’intégration.
Et si je ne peux pas réécrire les tests legacy aujourd’hui ?
Mettez en quarantaine avec des étiquettes explicites, épinglez temporairement les jobs à une seule région et financez une réécriture via le playbook flaky. La correction prime sur la fiction d’une géographie neutre.
Lorsque les suites sensibles au calendrier exigent du métal déterministe sans combattre la mise en veille d’un portable ou le Wi‑Fi d’un café, un Mac mini M4 chez NodeMac offre macOS natif avec SSH et VNC, des horloges prévisibles sur bare metal et des nœuds à Hong Kong, au Japon, en Corée, à Singapour et aux États-Unis pour rapprocher la CI des utilisateurs. Apple Silicon maximise le débit compile/test par watt, et louer une machine dédiée évite les surprises de voisin bruyant des VM partagées. Si votre matrice prouve qu’un hôte supplémentaire dans une autre région est nécessaire, partez de la page tarifs et mappez régions ↔ jobs plutôt que de deviner dans le YAML.