Как изолировать GitLab Runner macOS: корпоративное руководство по развертыванию 2026
Общий macOS Runner оставляет исходный код или ключ подписи в рабочем каталоге после завершения задания.
Быстрое решение: проекты одного доверенного домена можно объединять на общем узле, а формальную подпись и публикацию следует выполнять на защищённом выделенном Mac Runner; замыкать схему нужно областью проекта, тегами, защищёнными ресурсами, изоляцией секретов и проверкой очистки.
Эта статья предназначена для платформенных команд, которые создают общий пул GitLab macOS Runner для нескольких iOS-проектов. Она также полезна специалистам по безопасности, защищающим сертификаты и Keychain, и руководителям IT, сравнивающим покупку, аренду или смешанную конфигурацию Mac-узлов.
Критерий доверия и границы общего узла
Почему macOS Shell executor требует отдельного решения
В macOS Shell executor задание выполняется непосредственно на хосте от имени пользователя, под которым запущен GitLab Runner. GitLab прямо предупреждает о повышенном риске для Runner и сети при использовании этого исполнителя; команды из задания получают доступ к ресурсам, доступным этому пользователю. Подробное описание модели риска приведено в официальной документации Shell executor.
Следовательно, изоляция GitLab Runner macOS — это не настройка одного переключателя. Теги, защищённые ветви и отдельный рабочий каталог сокращают вероятность ошибки, но не равны физическому разделению хостов. Если один процесс может прочитать каталог, сокет, кэш или временный секрет, граница между проектами уже нарушена.
Перед закупкой или подключением узла необходимо оценить четыре свойства каждого проекта:
- чувствительность исходного кода и артефактов;
- возможность принимать внешние изменения или задания;
- право инициировать релиз;
- доступ к сертификатам, Provisioning Profile, Keychain и учётным данным публикации.
Название отдела не является достаточным критерием. Два проекта одной команды могут иметь разные правила публикации, а два проекта разных подразделений могут находиться в одном доверенном домене. Поэтому оценку лучше оформлять как матрицу «проект — задание — актив».
| Доверительный домен | Допустимый тип задания | Размещение | Условие допуска |
|---|---|---|---|
| Низкая чувствительность, единая команда | Компиляция, тесты, анализ кода | Общий Mac Runner | Проекты имеют сопоставимые права и не получают производственные секреты |
| Разные команды, но контролируемые репозитории | Обычная сборка без подписи | Раздельные аккаунты или отдельные пуллы | Подтверждены маршрутизация, очистка и отрицательные тесты |
| Высокая чувствительность или внешний вклад | Сборка ограниченного состава | Выделенный Runner | Узел не принимает произвольные задания из других проектов |
| Публикация и формальная подпись | Подпись, загрузка, релиз | Защищённый выделенный Runner | Только защищённый pipeline, ограниченные переменные и временный Keychain |
Решение по схеме размещения
Общий узел подходит, если проекты принадлежат одному доверенному домену, не используют общий производственный Keychain и способны пройти тест чтения остатков после завершения задания. При этом общий не означает «без правил»: каждый проект должен иметь собственный рабочий путь, явный тег и контролируемый набор переменных.
Разделение на бизнес-узлы оправдано, если команды имеют разные владельцы кода, разные требования к расследованию инцидентов или используют разные наборы секретов. Выделенный узел обязателен для публикации, когда задача может подписать приложение или отправить его в магазин.
Для большинства компаний рациональна смешанная модель: общий пул обслуживает компиляцию и тесты, чувствительный пул — ограниченные репозитории, а отдельный защищённый узел — подпись и публикацию. Такой подход не обещает абсолютной изоляции, но делает доверительную границу проверяемой.
Область Runner и маршрутизация заданий
Уровни видимости и ответственность
GitLab поддерживает Runner, связанный с конкретным проектом, группой или экземпляром. Чем шире область действия, тем больше проектов потенциально могут направлять задания на узел и тем выше административная ответственность. Различия между уровнями описаны в документации о назначении Runner.
Проектный Runner обычно проще согласовать для релизной цепочки: у него уже ограничен круг потребителей. Групповой Runner удобен для нескольких доверенных репозиториев, но требует формального списка участников и регулярного пересмотра. Runner уровня экземпляра следует применять только там, где организация действительно контролирует все проекты, способные его использовать.
Теги не являются доказательством безопасности сами по себе. Они выбирают подходящий узел, однако ошибка в .gitlab-ci.yml, слишком общий тег или разрешение заданий без тегов могут направить работу не туда. В руководстве по тегам и Protected Runner GitLab отдельно описывает связь тегов, защищённых Runner и правил запуска.
| Проверяемый показатель | Положительный результат | Последствие провала |
|---|---|---|
| Область Runner | Список проектов и групп утверждён владельцем платформы | Runner временно исключается из пула |
| Теги | Каждый тип задания имеет явный тег, задания без тегов запрещены | Проверяется конфигурация pipeline до допуска |
| Защищённый Runner | Узел принимает только разрешённые защищённые ветви или теги | Релизные задания переводятся на выделенный узел |
| Позитивный тест | Разрешённый проект успешно попадает на нужный узел | Исправляются тег и правила маршрутизации |
| Негативный тест | Неавторизованный проект не получает узел | Доступ блокируется до повторной проверки |
| Журналирование | Есть запись о проекте, задании и использованном Runner | Включается контроль событий и пересматриваются права |
Позитивные и негативные проверки
Позитивный тест должен подтвердить, что сборочный pipeline проекта с разрешённым тегом попадает именно в назначенный пул и получает только предусмотренные переменные. Проверяется не только успешный статус, но и фактическое имя Runner, рабочий каталог и доступные инструменты.
Негативный тест моделирует ошибку или попытку обхода: проект без разрешения запрашивает защищённый тег, пытается запустить задачу без тега или обращается к защищённому окружению. Ожидаемый результат — задание не получает чувствительный узел и не получает производственные переменные.
Защищённые окружения и переменные должны рассматриваться совместно. Правила GitLab для защищённых окружений ограничивают доступ к этапу, но не устраняют риск уже запущенного процесса на общей системе. Тестирование маршрута важнее декларации в интерфейсе.
Секреты, Keychain и право публикации
Разные активы — разные уровни доступа
Runner authentication token предназначен для регистрации и связи Runner с GitLab. Это не сертификат подписи и не разрешение на публикацию. GitLab предупреждает, что украденный токен может позволить злоумышленнику зарегистрировать вредоносный Runner или перехватить задания, поэтому его нужно хранить отдельно и регулярно ротировать; ограничения риска описаны в официальном материале о токенах Runner.
В корпоративной схеме нужно разделить как минимум следующие сущности:
- authentication token Runner;
- токены доступа к репозиторию;
- сертификаты Apple и Provisioning Profile;
- временный или постоянный Keychain;
- учётные данные App Store Connect;
- переменные сборки и секреты сторонних сервисов.
Обычный сборочный узел не должен постоянно хранить производственные сертификаты. Если pipeline только компилирует приложение, ему не требуется полный набор релизных полномочий. Подписывающий Runner, напротив, должен принимать только защищённые задания и ограниченный набор переменных.
Жизненный цикл подписывающего задания
Для публикации следует заранее определить:
- кто может запустить защищённую ветвь или тег;
- какой Runner принимает задачу;
- какие переменные доступны этому pipeline;
- когда создаётся временный Keychain;
- когда удаляются сертификат, профиль и логи с чувствительными значениями;
- где фиксируется результат ротации токенов и очистки.
Защита переменных GitLab должна быть настроена по области и окружению, а не только по названию переменной. Документация о CI/CD variables описывает защищённые переменные и условия их передачи в pipeline.
Для Xcode 27 совместимость нужно проверять по официальным требованиям Apple непосредственно перед вводом узла в эксплуатацию: системные требования Xcode определяют поддерживаемую версию macOS и условия работы инструментов. Не следует фиксировать в корпоративном стандарте версию macOS или чип без проверки конкретного проекта и текущей документации Apple.
Рабочее состояние и очистка хоста
Что остаётся после завершения задания
Главный риск общего Shell Runner часто находится не в исходной команде, а в состоянии, которое она оставляет. В список проверки входят:
- каталог исходного кода;
DerivedData;- кэш зависимостей Swift Package Manager и CocoaPods;
- временный Keychain;
- сертификаты и профили;
- бинарные артефакты;
- логи с переменными окружения;
- файлы, созданные вспомогательными скриптами;
- процессы и сокеты, оставшиеся после сбоя.
Удаление рабочего каталога после успешного pipeline не доказывает очистку после прерывания, зависания или аварийного завершения. Скрипт также не заменяет изоляцию операционной системы: процесс может записать данные за пределами ожидаемого каталога, изменить общую конфигурацию или оставить дочерний процесс.
Поэтому стандарт должен описывать несколько сценариев восстановления: штатное завершение, отмена задания, потеря сети и перезапуск узла. Для особо чувствительных задач предпочтительнее выделенный хост, а не попытка компенсировать общий доступ длинным cleanup-скриптом.
Важно: очистка — это контроль остаточного состояния, а не доказательство физической изоляции. Если проектам нельзя доверять друг другу, результатом оценки должен быть другой узел или другой доверительный домен.
Проверка восстановления
После выполнения задания запускается сканирование, которое ищет известные имена проектов, расширения сертификатов, профили, временные Keychain, артефакты и следы секретов в логах. Затем выполняется повторная сборка другого проекта с намеренно изменённым идентификатором, чтобы проверить, не подхватываются ли старые файлы.
Результат фиксируется как baseline: какие каталоги существуют, какие процессы разрешены, какие переменные доступны и какие инструменты установлены. Если baseline не восстанавливается после нештатного сценария, узел не должен возвращаться в общий пул автоматически.
План восстановления должен отвечать на практические вопросы: кто отключает Runner, кто перевыпускает токен, кто очищает Keychain, как исключается повреждённый узел и где запускается следующий pipeline. Руководство GitLab по проектированию Runner fleet полезно использовать как основу для разделения пулов и отказоустойчивого планирования.
Ёмкость, стабильность и размер пулов
Изоляция уменьшает совместно используемый запас ресурсов: выделенный релизный узел простаивает вне окна публикации, а общий пул уже не может принять любую задачу. Поэтому решение нельзя принимать только по требованиям безопасности. Нужно сопоставить очередь, длительность pipeline, повторные запуски, окно публикации и последствия отказа.
Не следует вводить универсальное число параллельных заданий. Реальная пропускная способность зависит от проекта, версии Xcode 27, объёма зависимостей, тестов, кэша и скриптов подписи. GitLab также рекомендует проектировать парк Runner с учётом типов нагрузки и отказов, а не сводить планирование к одному параметру concurrency.
Для каждого класса задач полезно записывать:
- время ожидания до старта;
- длительность сборки и тестов;
- долю повторных запусков;
- число задач, заблокированных релизным окном;
- время замены или восстановления узла;
- результат сборки после очистки.
После этого формируется пул из трёх логических частей: обычные сборки, чувствительные задачи и временная ёмкость на период нагрузки. Одна выделенная машина не должна становиться единственной точкой доставки релиза. Если резерв не предусмотрен, в план восстановления включают заранее проверенный запасной Mac Runner или временную аренду отдельного узла.
Для первого пилота разумно проверить реальный pipeline, а не синтетическую команду Xcode. В сценарий должны входить установка зависимостей, тесты, архивация, подпись в разрешённом контуре и отмена задания. После этого результаты сравниваются с baseline, а не с обещанной производительностью оборудования.
Итоговая карта допуска
Перед подключением проекта к общему пулу ответственная команда должна пройти следующий чек-лист:
- [ ] Проект отнесён к доверительному домену по чувствительности кода, внешним изменениям и правам публикации.
- [ ] Для проекта назначена область Runner: проект, группа или экземпляр с документированным владельцем.
- [ ] Все задания имеют явные теги, а чувствительные задачи используют отдельные защищённые теги.
- [ ] Запрещённые проекты проверены негативным тестом и не могут попасть на защищённый узел.
- [ ] Runner authentication token отделён от токенов репозитория и секретов подписи.
- [ ] Производственные сертификаты и Provisioning Profile отсутствуют на обычном сборочном узле.
- [ ] Подписывающий Runner принимает только защищённый pipeline и ограниченные окружения.
- [ ] Временный Keychain создаётся для задания и удаляется после штатного и аварийного завершения.
- [ ] Проверены исходный каталог, DerivedData, кэши, артефакты, логи и фоновые процессы.
- [ ] Выполнено сканирование остатков после задания другого проекта.
- [ ] Подтверждена совместимость macOS, чипа и Xcode 27 с реальным проектом.
- [ ] Зафиксированы очередь, длительность, повторные запуски и время восстановления.
- [ ] Определены действия при компрометации токена, утечке сертификата и отказе узла.
- [ ] Есть решение: общий пул, выделенный пул или смешанная схема, с указанием причины.
Если не проходит проверка доверия или негативный тест, проект нельзя оставлять на общем узле ради экономии ёмкости. Если не проходит только очистка, сначала устраняется остаточное состояние; если проблема связана с публикацией, задача переводится на выделенный защищённый Runner. Такой порядок отделяет исправимые ошибки конфигурации от несовместимости самой модели.
Частые вопросы
Общий macOS Runner для нескольких проектов
Несколько проектов могут использовать один Runner только внутри сопоставимого доверительного домена. Следует заранее подтвердить, что участники имеют совместимые права на код и артефакты, не получают производственные секреты друг друга и проходят негативную проверку маршрутизации. Для внешних контрибьюторов, разных уровней доступа и релизных задач общий Shell Runner не является безопасным универсальным пулом.
Защита файлов между заданиями
Нужно проверять не только каталог, который GitLab очищает автоматически, но и DerivedData, кэши зависимостей, временные Keychain, логи и фоновые процессы. У каждого проекта должны быть предсказуемые пути и процедура удаления после любого сценария завершения. Если задача может читать произвольные файлы пользователя на хосте, скрипт очистки не заменяет отдельный аккаунт или выделенный Mac Runner.
Отдельный Runner для подписи
Подписывающие задания рекомендуется выносить на защищённый Runner, поскольку им нужны сертификаты, Provisioning Profile, Keychain и полномочия публикации. Обычный компилятор не должен постоянно хранить эти активы. Разрешённый pipeline получает секреты только в необходимом окружении, а после завершения удаляются временные данные и фиксируется результат проверки.
Ограничения тегов и защищённых ветвей
Теги и защищённые ветви полезны для управления входом, но они не меняют права процесса внутри macOS. Ошибка в правилах pipeline, доступ к общей учётной записи или остаточные файлы всё равно могут нарушить границу. Поэтому теги должны подтверждаться позитивными и негативными тестами, а защищённые правила — контролем секретов и состоянием хоста.
Выбор инфраструктуры и следующий шаг
Покупка физических Mac даёт компании полный контроль над сетью и жизненным циклом оборудования, но требует заранее оплачивать запас мощности, заниматься заменой узлов, инвентаризацией, удалённым доступом и восстановлением. Собственный парк также не устраняет риск неправильных прав, общего Keychain или ошибочной маршрутизации pipeline.
Аренда удалённого Mac удобнее для пилота и переменной нагрузки: можно сначала проверить GitLab Runner, Xcode 27, подпись и отказоустойчивость на изолированном узле, а затем решить, нужен ли постоянный общий пул. При этом нельзя считать удалённый доступ заменой корпоративной модели безопасности — область Runner, секреты и сценарии очистки всё равно проектирует сама команда. Для оценки доступных вариантов можно изучить консоль KuzCloud, а вопросы доступа и эксплуатации сверить с разделом помощи KuzCloud.
На практике наиболее устойчивым оказывается не выбор «общий или отдельный Mac» сам по себе, а смешанная схема: общий узел для задач одного доверительного домена, выделенный защищённый узел для подписи и заранее проверенный резерв для восстановления. После заполнения матрицы доверия и чек-листа сначала стоит провести ограниченный пилот на отдельном удалённом Mac, записать реальные очереди и результаты восстановления, а уже затем расширять пул и принимать решение о долгосрочной покупке или аренде.
Настройте изолированный macOS Runner с KuzCloud
Арендуйте удалённый Mac для CI/CD и распределяйте проекты по отдельным вычислительным узлам.
Подключайтесь к macOS через VNC для настройки, диагностики и контроля рабочего окружения.