Зачем использовать self-hosted Mac-раннер?
GitHub-hosted macOS раннеры удобны, но оплачиваются поминутно, поэтому стоимость растёт вместе с объёмом сборок. При тарифе $0.062 в минуту (стандартный macOS раннер GitHub, на октябрь 2026 г.) команда, использующая 75 часов сборок в месяц, платит около $279. Минуты self-hosted раннеров GitHub не тарифицирует, поэтому выделенный Mac mini M4 от My Remote Mac стоит фиксированные $85/мес (USD, без налогов) без поминутной оплаты, что даёт такое же (или лучшее) оборудование за долю стоимости.
| Характеристика | Self-hosted My Remote Mac | GitHub-Hosted раннер |
|---|---|---|
| Стоимость | $85/мес (без поминутной оплаты) | $0.062/мин (~$279/мес за 75 ч) |
| Архитектура | Apple M4, физический Mac, выделенный 1:1 | ВМ на Apple M1, 3 ядра, 7 ГБ RAM (стандартный раннер) |
| Скорость сборки | ~4 мин (тот же проект) | ~12 мин (средний проект) |
| Постоянный кеш | Да (постоянный диск) | Нет (эфемерный) |
| Пользовательское ПО | Полный root-доступ | Ограничено |
| Параллельные задачи | 1 задача на раннер; для масштабирования добавьте раннеры или Mac | 5 (Free, Pro, Team) / 50 (Enterprise) |
Цены My Remote Mac указаны в USD, без налогов. Данные GitHub: стандартный macOS раннер за $0.062 в минуту, по документации GitHub о ценах, на октябрь 2026 г.
Ключевое преимущество: Поскольку раннер постоянный, DerivedData, кеши SPM и CocoaPods сохраняются между сборками. Одно это может сократить время сборки на 50–70% по сравнению с эфемерными GitHub-hosted раннерами, которые каждый раз начинают с нуля.
Предварительные требования
Прежде чем начать, убедитесь, что у вас есть следующее:
- Выделенный сервер сборки Mac mini M4 от My Remote Mac (от $85/мес, USD, без налогов)
- Аккаунт GitHub с правами администратора вашего репозитория или организации
- SSH-доступ к вашему Mac Mini (предоставляется с подпиской My Remote Mac)
- Аккаунт Apple Developer (для подписи кода и профилей обеспечения)
- Базовое знакомство с YAML и командами терминала
Шаг 1: Подключение к Mac Mini по SSH и проверка Xcode
Сначала подключитесь к Mac Mini M4 через SSH. Вы получили учётные данные при настройке сервера My Remote Mac.
Подключение через SSH
# Connect to your Mac Mini M4
ssh admin@your-server-ip
# Verify you're on Apple Silicon
uname -m
# Expected output: arm64
# Check the macOS version
sw_vers
Проверка Xcode Command Line Tools
# Xcode and its Command Line Tools come preinstalled
xcode-select -p
# /Applications/Xcode.app/Contents/Developer
# Accept the Xcode license if it asks
sudo xcodebuild -license accept
# Homebrew is preinstalled too (used below to add xcodes):
# put it on your PATH once per account
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
brew --version
Проверка Xcode и добавление других версий
Xcode, его Command Line Tools и Homebrew предустановлены на каждом сервере My Remote Mac. Проверьте активную версию и, если проекту нужны другие, установите их рядом с помощью xcodes:
# Check the preinstalled Xcode
xcodebuild -version
# Xcode 27.2
# Optional: add other Xcode releases side by side with the xcodes CLI
brew install xcodes
# List available Xcode versions
xcodes list
# Install an older release next to the preinstalled one (asks for your Apple Account)
xcodes install 26.6
# Show the installed versions and their paths
xcodes installed
# e.g. /Applications/Xcode.app and /Applications/Xcode-26.6.0.app
# Set the active Xcode (interactive SSH session: sudo asks for your password)
# preinstalled Xcode; for another version, use the path from xcodes installed
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
Установка iOS-симуляторов
# Install the iOS simulator runtime that matches your Xcode
xcodebuild -downloadPlatform iOS
# Verify simulator availability
xcrun simctl list runtimes
xcrun simctl list devices available
Шаг 2: Установка раннера GitHub Actions
Теперь скачаем и настроим агент раннера GitHub Actions. Перейдите в ваш репозиторий на GitHub, откройте Settings > Actions > Runners > New self-hosted runner и выберите macOS + ARM64.
Скачивание и настройка
# Create a directory for the runner
mkdir -p ~/actions-runner && cd ~/actions-runner
# Download the latest runner package (macOS ARM64). The same commands, with the
# current version and its checksum, are shown on Settings > Actions > Runners >
# New self-hosted runner
RUNNER_VERSION=$(curl -fsSL https://api.github.com/repos/actions/runner/releases/latest \
| sed -n 's/.*"tag_name": *"v\([^"]*\)".*/\1/p')
curl -o "actions-runner-osx-arm64-${RUNNER_VERSION}.tar.gz" -L \
"https://github.com/actions/runner/releases/download/v${RUNNER_VERSION}/actions-runner-osx-arm64-${RUNNER_VERSION}.tar.gz"
# Extract the package
tar xzf "actions-runner-osx-arm64-${RUNNER_VERSION}.tar.gz"
# Configure the runner
# Replace YOUR_TOKEN with the token from GitHub Settings
./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO \
--token YOUR_TOKEN \
--name "mac-mini-m4-runner" \
--labels "self-hosted,macOS,ARM64,M4" \
--work "_work"
# Test the runner interactively first
./run.sh
Установка как постоянный сервис launchd
Запуск агента в интерактивном режиме подходит для тестирования, но для продакшена нужен автоматический запуск и перезапуск при сбое. GitHub предоставляет встроенный скрипт установки сервиса для macOS:
# Install as a launchd service (a LaunchAgent; no sudo on macOS)
cd ~/actions-runner
./svc.sh install
# Start the service
./svc.sh start
# Check the service status
./svc.sh status
# View the launchd plist (for reference)
cat ~/Library/LaunchAgents/actions.runner.*.plist
Теперь сервис запускается при каждом входе пользователя раннера в систему и перезапускает раннер, если процесс завершится. Сам по себе LaunchAgent не стартует при загрузке: на headless Mac включите автоматический вход для этого пользователя (Системные настройки > Пользователи и группы; недоступно, пока включён FileVault), чтобы раннер снова был онлайн после перезагрузки. Вы можете убедиться, что раннер отображается как "Idle" на странице Settings > Actions > Runners вашего GitHub репозитория.
Настройка раннера для нескольких репозиториев (уровень организации)
# For an organization-level runner, use the organization URL:
./config.sh --url https://github.com/YOUR_ORG \
--token YOUR_ORG_TOKEN \
--name "mac-mini-m4-org-runner" \
--labels "self-hosted,macOS,ARM64,M4" \
--runnergroup "Default" \
--work "_work"
# This allows ALL repositories in your organization to use this runner
Шаг 3: Создание рабочего процесса сборки iOS
Создайте файл рабочего процесса в вашем репозитории по пути .github/workflows/ios-build.yml. Этот рабочий процесс будет выполняться на вашем self-hosted раннере Mac Mini M4.
name: iOS Build & Test
on:
push:
branches: [ main, develop ]
pull_request:
branches: [ main ]
jobs:
build:
runs-on: [self-hosted, macOS, ARM64, M4]
# bash -eo pipefail: a failing xcodebuild fails the step even when piped to xcbeautify
defaults:
run:
shell: bash
env:
SCHEME: "MyApp"
# Any device listed by: xcrun simctl list devices available
DESTINATION: "platform=iOS Simulator,name=iPhone 17,OS=latest"
# Pick the Xcode for this job without sudo
# (preinstalled Xcode; for another version, use the path from xcodes installed)
DEVELOPER_DIR: /Applications/Xcode.app/Contents/Developer
# Caches sit next to the checkout: actions/checkout cleans the checkout
# (git clean -ffdx) on every run, but not its parent folder
DERIVED_DATA: ${{ github.workspace }}/../DerivedData
SPM_CACHE: ${{ github.workspace }}/../SourcePackages
steps:
- name: Checkout code
uses: actions/checkout@v7
- name: Show the selected Xcode
run: xcodebuild -version
- name: Resolve Swift Package Dependencies
run: |
xcodebuild -resolvePackageDependencies \
-scheme "$SCHEME" \
-clonedSourcePackagesDirPath "$SPM_CACHE"
- name: Install xcbeautify
run: command -v xcbeautify >/dev/null || brew install xcbeautify
- name: Build the app
run: |
xcodebuild build \
-scheme "$SCHEME" \
-destination "$DESTINATION" \
-clonedSourcePackagesDirPath "$SPM_CACHE" \
-derivedDataPath "$DERIVED_DATA" \
| xcbeautify
- name: Run unit tests
run: |
xcodebuild test \
-scheme "$SCHEME" \
-destination "$DESTINATION" \
-clonedSourcePackagesDirPath "$SPM_CACHE" \
-derivedDataPath "$DERIVED_DATA" \
-resultBundlePath TestResults.xcresult \
| xcbeautify
- name: Upload test results
if: always()
uses: actions/upload-artifact@v7
with:
name: test-results
path: TestResults.xcresult
Добавление подписи кода для релизных сборок
Для деплоя в TestFlight или App Store добавьте шаги подписи кода. Храните сертификаты и профили обеспечения как GitHub Secrets:
deploy:
needs: build
runs-on: [self-hosted, macOS, ARM64, M4]
if: github.ref == 'refs/heads/main'
env:
# Same Xcode as the build job (App Store Connect requires Xcode 26 or later)
DEVELOPER_DIR: /Applications/Xcode.app/Contents/Developer
steps:
- name: Checkout code
uses: actions/checkout@v7
- name: Install certificate and provisioning profile
env:
BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
BUILD_PROVISION_PROFILE_BASE64: ${{ secrets.BUILD_PROVISION_PROFILE_BASE64 }}
KEYCHAIN_PASSWORD: ${{ secrets.KEYCHAIN_PASSWORD }}
run: |
# Create a temporary keychain
KEYCHAIN_PATH=$RUNNER_TEMP/app-signing.keychain-db
security create-keychain -p "$KEYCHAIN_PASSWORD" $KEYCHAIN_PATH
security set-keychain-settings -lut 21600 $KEYCHAIN_PATH
security unlock-keychain -p "$KEYCHAIN_PASSWORD" $KEYCHAIN_PATH
# Import certificate
CERTIFICATE_PATH=$RUNNER_TEMP/build_certificate.p12
echo -n "$BUILD_CERTIFICATE_BASE64" | base64 --decode -o $CERTIFICATE_PATH
security import $CERTIFICATE_PATH -P "$P12_PASSWORD" \
-A -t cert -f pkcs12 -k $KEYCHAIN_PATH
security list-keychain -d user -s $KEYCHAIN_PATH
# Install provisioning profile (the folder Xcode 16 and later read)
PP_PATH=$RUNNER_TEMP/build_pp.mobileprovision
echo -n "$BUILD_PROVISION_PROFILE_BASE64" | base64 --decode -o $PP_PATH
mkdir -p ~/Library/Developer/Xcode/UserData/Provisioning\ Profiles
cp $PP_PATH ~/Library/Developer/Xcode/UserData/Provisioning\ Profiles
- name: Build for distribution
run: |
xcodebuild archive \
-scheme "MyApp" \
-archivePath DerivedData/MyApp.xcarchive \
-destination "generic/platform=iOS" \
CODE_SIGN_STYLE=Manual
- name: Export IPA
run: |
xcodebuild -exportArchive \
-archivePath DerivedData/MyApp.xcarchive \
-exportOptionsPlist ExportOptions.plist \
-exportPath DerivedData/Export
- name: Upload to TestFlight
env:
APP_STORE_CONNECT_API_KEY: ${{ secrets.APP_STORE_CONNECT_API_KEY }}
APP_STORE_CONNECT_ISSUER_ID: ${{ secrets.APP_STORE_CONNECT_ISSUER_ID }}
run: |
# altool reads the key from ~/.appstoreconnect/private_keys/AuthKey_<KEY_ID>.p8
xcrun altool --upload-app \
-f DerivedData/Export/MyApp.ipa \
-t ios \
--apiKey $APP_STORE_CONNECT_API_KEY \
--apiIssuer $APP_STORE_CONNECT_ISSUER_ID
# The runner is persistent: remove the signing files at the end of every job
- name: Clean up keychain and provisioning profile
if: ${{ always() }}
run: |
security delete-keychain $RUNNER_TEMP/app-signing.keychain-db || true
rm -f ~/Library/Developer/Xcode/UserData/Provisioning\ Profiles/build_pp.mobileprovision
Шаг 4: Оптимизация производительности
Одно из главных преимуществ self-hosted раннера, постоянное кеширование. Вот ключевые оптимизации для максимальной отдачи от вашего Mac Mini M4.
Включение кеширования DerivedData
Поскольку раннер постоянный, DerivedData сохраняется между сборками. Используйте постоянный путь DerivedData:
# In your workflow, keep DerivedData next to the checkout (job env, as above):
# DERIVED_DATA: ${{ github.workspace }}/../DerivedData
# ... -derivedDataPath "$DERIVED_DATA"
# Each repository then gets ~/actions-runner/_work/<repo>/DerivedData
# On the runner, remove the DerivedData of repositories not built for 7 days
# (cron job every Sunday at 03:00, keeps your existing crontab entries)
(crontab -l 2>/dev/null; echo '0 3 * * 0 find "$HOME"/actions-runner/_work/*/DerivedData -maxdepth 0 -type d -mtime +7 -exec rm -rf {} +') \
| crontab -
Кеширование SPM-пакетов
# Use clonedSourcePackagesDirPath to keep SPM packages on disk
# (SPM_CACHE points outside the checkout, as in the workflow above)
xcodebuild build \
-scheme "MyApp" \
-clonedSourcePackagesDirPath "$SPM_CACHE" \
-derivedDataPath "$DERIVED_DATA"
# This avoids re-downloading packages on every build
Параллельное выполнение тестов
# Run tests in parallel across multiple simulators
# (devices from: xcrun simctl list devices available)
set -o pipefail
xcodebuild test \
-scheme "MyApp" \
-destination "platform=iOS Simulator,name=iPhone 17,OS=latest" \
-destination "platform=iOS Simulator,name=iPhone 18 Pro,OS=latest" \
-parallel-testing-enabled YES \
-maximum-parallel-testing-workers 4 \
-derivedDataPath "$DERIVED_DATA" \
| xcbeautify
Установка xcbeautify для улучшенных логов
# xcbeautify formats Xcode output for CI environments
brew install xcbeautify
# Use it by piping xcodebuild output (pipefail keeps xcodebuild's exit status):
set -o pipefail && xcodebuild build -scheme "MyApp" | xcbeautify
Устранение типичных проблем
Раннер отображается как "Offline" в GitHub
Обычно это означает, что сервис launchd не запущен. Проверьте статус сервиса и логи:
# Check service status
./svc.sh status
# View logs
cat ~/actions-runner/_diag/Runner_*.log | tail -50
# Restart the service
./svc.sh stop
./svc.sh start
Подпись кода не работает: "No signing certificate"
Сервис launchd работает под другим контекстом пользователя. Убедитесь, что Keychain доступен:
# Ensure the login keychain is unlocked for the runner user
security unlock-keychain -p "YOUR_PASSWORD" ~/Library/Keychains/login.keychain-db
# Or use a dedicated keychain in your workflow (recommended)
security create-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security default-keychain -s build.keychain
security unlock-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
Симулятор не запускается
Симуляторы иногда зависают. Сбрасывайте их между сборками:
# Shutdown all running simulators
xcrun simctl shutdown all
# Erase all simulator data (nuclear option)
xcrun simctl erase all
# Boot a specific simulator
xcrun simctl boot "iPhone 17"
Заканчивается дисковое пространство
Сборки Xcode генерируют много данных. Настройте автоматическую очистку:
# Clean old DerivedData
rm -rf ~/Library/Developer/Xcode/DerivedData/*
# Remove simulators whose runtime is no longer installed
xcrun simctl delete unavailable
# Clean Homebrew cache
brew cleanup --prune=7
# Remove old Xcode archives
rm -rf ~/Library/Developer/Xcode/Archives/*
Анализ стоимости
Вот детальное сравнение стоимости для разных размеров команд и объёмов сборок:
| Размер команды | Стоимость My Remote Mac | Сборок/месяц | Стоимость GitHub-Hosted | Ежемесячная экономия |
|---|---|---|---|---|
| Один разработчик | $85/мес | 100 сборок (в среднем 10 мин) | $62/мес | Нет (дороже на $23/мес) |
| Малая команда (5) | $85/мес | 500 сборок (в среднем 10 мин) | $310/мес | $225/мес |
| Средняя команда (15) | $229/мес (M4 Pro) | 1500 сборок (в среднем 10 мин) | $930/мес | $701/мес |
| Корпоративная (50+) | $458/мес (2x M4 Pro) | 5000+ сборок | $3,100+/мес | $2,642+/мес |
Цены My Remote Mac указаны в USD, без налогов. Данные GitHub: стандартный macOS раннер за $0.062 в минуту, по документации GitHub о ценах, на октябрь 2026 г.
Итог: Для команд, выполняющих более ~140 сборок в месяц, self-hosted Mac Mini M4 окупается мгновенно. А поскольку сборки быстрее на постоянном оборудовании с тёплыми кешами, ваша команда экономит и время разработчиков. При 100 сборках в месяц, как в строке «Один разработчик», GitHub-hosted раннеры обходятся на $23/мес дешевле; при этом и одному разработчику выделенный Mac может оказаться удобнее благодаря постоянным кешам, более быстрым сборкам и отсутствию поминутной оплаты. Если вы выпускаете релизы лишь изредка, посуточный тариф даёт Mac на день релиза от $14 за 24 часа (USD, без налогов): выключите автопродление при развёртывании, и он остановится через 24 часа, или перейдите на помесячный тариф на том же Mac.