GitLab Runner на Mac mini: iOS CI/CD и автосборка

Масштабирование iOS-разработки упирается в надёжный CI/CD. Облачные shared-runner’ы удобны, но не дают ни контроля окружения, ни предсказуемой скорости сборки. Выделенный Mac mini — особенно в формате облака VNCMac — даёт и то и другое: полный доступ к нативной тулчейну и минимум накладных расходов.

Зачем выделенный Mac mini под iOS-сборки

Нативная компиляция на Apple Silicon (M2/M4) даёт максимальную производительность для Swift и Objective-C. Собственный GitLab Runner на удалённом Mac mini даёт:

Скорость сборки: выделенное железо без виртуализации и «шумных соседей».
Одинаковое окружение: фиксированные версии Xcode, Ruby и тулчейна у всей команды.
Предсказуемая стоимость: почасовая или месячная оплата вместо кредитов CI/CD.

Принцип работы: архитектура GitLab Runner и executor

Понимание внутренней модели важно для выжимания максимума из пайплайна. GitLab Runner — это агент, который в цикле опрашивает GitLab API по механизму long polling. При появлении джоба он получает payload (репозиторий, переменные, теги), скачивает артефакты и передаёт выполнение executor’у.

Для iOS критичен выбор executor’а. Shell запускает скрипты в нативной среде macOS: доступны Xcode, симуляторы, Keychain, коды подписи. Docker на Mac по сути крутит Linux-контейнеры внутри виртуальной машины — без доступа к нативному Xcode и без аппаратного Metal, что убивает идею iOS-сборки в контейнере на том же хосте. Итог: под iOS на Mac mini используется только shell executor.

Цепочка выполнения джоба (упрощённо):
GitLab → Web API (REST) → Runner (polling) → Executor (shell) → subprocess(bash) → xcodebuild / fastlane

«Bare Metal Mac в VNCMac без гипервизора даёт нулевой оверхед и прямой доступ к ARM64-инструкциям. Линковка и компиляция Swift выигрывают 30–40% по времени по сравнению с общими облачными раннерами.» — Команда VNCMac

Шаг 1: Подготовка окружения на Mac mini

До установки GitLab Runner на машине должен быть рабочий стек под Xcode и Ruby.

1. Xcode и Command Line Tools

Ставите Xcode из App Store и инициализируете CLI:

sudo xcodebuild -runFirstLaunch
xcode-select --install

2. Homebrew и зависимости

Через Homebrew ставим сам раннер и Ruby-окружение:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install gitlab-runner ruby rbenv

Шаг 2: Установка и регистрация GitLab Runner

После подготовки окружения поднимаем сервис и привязываем раннер к проекту.

Запуск сервиса:
```
brew services start gitlab-runner
```
Регистрация: выполняем gitlab-runner register и вводим:
- URL инстанса: например https://gitlab.com/
- Registration Token: в GitLab — Settings → CI/CD → Runners.
- Executor: обязательно shell — иначе нет доступа к Xcode и Keychain.

Шаг 3: Код-сайнинг и Fastlane Match

Автосборка iOS невозможна без валидных сертификатов и профилей. Fastlane Match хранит их в приватном репозитории и подставляет на раннер при сборке.

В корне проекта создаёте Gemfile:

source "https://rubygems.org"
gem "fastlane"

Инициализация Match и синхронизация хранилища (например, App Store):

bundle exec fastlane match init
bundle exec fastlane match appstore

Шаг 4: Конфигурация пайплайна (.gitlab-ci.yml)

В .gitlab-ci.yml описываете этапы сборки и деплоя. Теги ios и xcode должны совпадать с тегами зарегистрированного раннера на Mac mini.

stages:
  - build
  - deploy

variables:
  LC_ALL: "en_US.UTF-8"
  LANG: "en_US.UTF-8"

build_job:
  stage: build
  script:
    - bundle install
    - bundle exec fastlane build_app
  tags:
    - ios
    - xcode
  artifacts:
    paths:
      - build/*.ipa

Бенчмарки и пределы производительности

На инстансе Mac mini (M4) в VNCMac для среднеразмерного Swift-проекта мы зафиксировали:

Полная чистая сборка: ~4,5 мин (против 12+ мин на типовых облачных раннерах).
Юнит-тесты: ~45 сек.
Архивация и загрузка IPA (App Store Connect): ~2 мин.

Узким местом остаётся не CPU, а дисковый I/O при клонировании репозитория и работа Xcode с индексацией. SSD с высокой последовательной записью и выделенный объём памяти снижают разброс времени сборки и позволяют держать пайплайн в пределах 7–10 минут «от пуш до артефакта».

Заключение

Развёртывание GitLab Runner на удалённом Mac mini — один из самых эффективных шагов для iOS-команды: стабильная скорость, полный контроль над окружением и предсказуемые затраты. Использование выделенных инстансов Apple Silicon в VNCMac убирает очереди и «шумных соседей» и даёт возможность упираться уже в пределы самого Xcode, а не инфраструктуры.

Как быстро развернуть GitLab Runner на удалённом Mac mini для iOS-автосборки