Самохостинговые Mac mini M4 ускоряют CI, но остаются компьютерами в регионе: часовой пояс по умолчанию, 12- или 24-часовой формат, первый день недели и порядок сортировки (collation) часто отличаются от вашего ноутбука. Если не зафиксировать эти измерения в пайплайне, тесты «переворачиваются» в полночь, при переходе на летнее время или при переносе задания с хоста в Гонконге на хост в США. В статье — две матрицы решений, восемь шагов внедрения и числовые ограничения для runbook, чтобы XCTest, снапшоты UI и серверная дата перестали спорить с раннером.
Сочетайте руководство с карантином flaky-тестов, фиксацией Xcode и дрейфом и распределяемыми Mac-узлами при мультирегиональных матрицах. Для отладки на той же машине используйте VNC. Регионы сравните на странице цен; операционные настройки — в разделе помощи.
Почему пояс и локаль выглядят как «железные» flaky
Apple Silicon не убирает недетерминизм календарей. Тест, вызывающий Date() на границе биллингового окна, остаётся зелёным, пока системные часы раннера не пересекут границу. Локаль меняет разделители групп разрядов в NumberFormatter — снапшоты, записанные с другим LANG, ломаются. Сортировка имён файлов с локалью по умолчанию — тихий источник порядко-зависимых падений, когда тесты ожидают POSIX, а CI наследует языковую collation.
- Полночь: ночные джобы, стартующие в 23:55 локально и заканчивающиеся после 00:05, могут дважды учесть день или пропустить его, если утверждения используют «сегодня» без замороженных часов.
- Прыжки DST: задание в 23:30 в день перевода часов получает меньше реальных минут; cron и наивный
sleep 3600ломаются. - Окна сертификатов: TLS и проверка подписи сравнивают notBefore/notAfter со стеночным временем; сдвиг даёт интермитентность.
- Мультирегион пулы: один и тот же коммит на раннере в Сингапуре и Калифорнии может по-разному ответить «какой календарный день — пятница» без централизованного эталона UTC.
Матрица A: регион узла и рекомендуемый контракт CI-среды
NodeMac эксплуатирует bare-metal Mac mini M4 в Гонконге, Японии, Корее, Сингапуре и США. Таблица не является юридической гарантией системных умолчаний — операторы могут менять настройки — но отражает типичные безнадзорные раннеры. Закодируйте контракт в оркестраторе, чтобы «зелёный в SG» не означал «зелёный везде».
| Типичный регион раннера | Риск стеночных часов по умолчанию | Рекомендуемая базовая линия CI | Доп. matrix-job |
|---|---|---|---|
| Гонконг / Сингапур | Границы азиатского календаря; праздники ≠ США | TZ=UTC, LC_ALL=C.UTF-8 для стадий компиляции |
Еженедельно TZ=Asia/Hong_Kong для чеков |
| Япония / Корея | Пакеты локали; нумерация дней в UI | Зафиксировать LANG=C.UTF-8 для CLI |
Снапшот-стадия с ja_JP.UTF-8 при японском UI |
| США | 12ч по умолчанию; DST зависит от штата | Принудительно 24ч в тестах; не парсить «3 PM» без локали | Неделя DST: два синтетических времени в XCTest |
| Кросс-регион пул | Один коммит, разный «локальный сегодня» | Централизовать «бизнес-дату» в UTC; конвертировать только на границе UI | Метка timezone-matrix блокирует релиз при красном |
Матрица B: симптом, зонд, исправление
| Симптом | Быстрый зонд | Шаблон исправления |
|---|---|---|
| Падения только около полуночи UTC | Логировать TZ, системные часы, гистограмму часа старта |
Заморозить «сейчас» через DI; добавить граничные XCTest-кейсы |
| Числовые снапшоты различаются между хостами | Печатать LANG / LC_NUMERIC в начале job |
Задать LC_ALL=C.UTF-8 в plist launchd или CI-обёртке |
| «Случайные» сбои TLS или нотариуса | Сравнить offset sntp с эталоном stratum-1 |
Дисциплина NTP; fail-fast при offset > порога |
| Нестабильная сортировка списков файлов | Вывод locale в пре-баннер |
Явный POSIX-компаратор в Swift или сортировка с LC_ALL=C |
Числовые ограничения для политики
- Абсолютный сдвиг NTP: держите ошибку часов ниже 250 мс в установившемся режиме; эскалация, если раннер > 2 с три проверки подряд.
- Плановое обслуживание: не меняйте эксперименты с поясом 72 часа вокруг DST в регионах с критичной датой для клиента.
- Запас таймаута: добавьте 15 % к wall-clock для тестовых наборов, зависящих от календаря, — скачки симулированного времени нелинейно удлиняют XCTest.
Совет по аудиту: сохраняйте эффективные TZ, LANG и измеренный NTP-offset рядом с каждым junit.xml.
Восемь шагов внедрения
- Инвентаризация тестов с реальными часами, форматтерами локали или сортировкой ФС без явного компаратора.
- Префлайт-баннер в логах CI: пояс, локаль, билд ОС, Xcode — та же строка, что и для аудита дрейфа.
- Закодировать умолчания в
EnvironmentVariableslaunchd, чтобы сессии без GUI наследовали тот же контракт, что SSH. - Небольшой XCTest-хелпер с заморозкой времени через DI; запретить прямой
Date()в бизнес-логике тестов. - Еженедельная матрица, повторяющая топ-20 датовых тестов минимум в двух поясах продаж.
- Алерты при корреляции всплесков NTP с ошибками TLS.
- Документировать исключения (например POS с локальным временем) и изолировать такие наборы на помеченных раннерах.
- Масштабировать отдельными Mac mini M4 по регионам, когда глубина очереди заставляет делить рискованные «почти полночь» окна между командами.
FAQ
Должны ли сервер и симулятор делить одну переменную TZ?
Нет. Серверные джобы по умолчанию UTC; UI-симулятор может требовать отдельных прогонов по локали. Смешивание в одном процессе XCTest без изоляции часто даёт двойные сбои.
Меняет ли Apple Silicon поведение NTP?
Существенно нет. Важен демон дисциплины. Меняется скорость сборок — короткие джобы маскируют сдвиг до длинной интеграции.
Что если legacy-тесты нельзя переписать сейчас?
Карантин с явными метками, временная привязка к одному региону и бюджет на переписывание по flaky-playbook. Корректность важнее мифа о «нейтральной географии».
Когда наборам тестов, чувствительным к датам, нужен предсказуемый металл без борьбы со сном ноутбука или Wi‑Fi кафе, Mac mini M4 на NodeMac даёт нативный macOS с SSH и VNC, предсказуемые часы на bare metal и узлы в Гонконге, Японии, Корее, Сингапуре и США, чтобы CI была ближе к пользователям. Apple Silicon держит высокий throughput компиляции и тестов на ватт; аренда выделенной машины избегает сюрпризов перегруженных общих VM. Если матрица показала нужду в хосте в другом регионе, начните со страницы цен и сопоставьте регионы с джобами, а не угадывайте в YAML.