Руководство для разработчиков, которым нужен выделенный физический Mac для Xcode или macOS CI. Выберите конфигурацию и узел, получите данные для подключения, проверьте инструменты и выполните воспроизводимую сборку.
Команды и ответы на этой странице приведены для примера и не означают, что проект уже настроен. Фактические параметры подключения, состояние устройства и ход его подготовки смотрите в консоли.
Сначала проверьте четыре пункта, а затем передайте проект удалённому узлу.
Пример чек-листа · Фактическая конфигурация указана в заказе и консоли
Пять разделов расположены в порядке выполнения задач. Если заказ уже оформлен, переходите сразу к подключению или диагностике.
Выберите модель и узел, укажите срок аренды и проверьте статус заказа. Узнайте, где получить данные для подключения.
Этапы заказа → 02Проверьте параметры SSH и определите, где хватит командной строки, а где нужен графический интерфейс.
Примеры подключения → 03Получите проект, проверьте Xcode и зависимости, затем убедитесь, что артефакт сохранён в нужном месте.
Этапы сборки → 04Проверьте Runner, теги заданий и права на подпись, прежде чем запускать автоматическую сборку.
Проверка настройки → 05Проверьте срок аренды и дополнительные опции. Сведения по текущим заказам и обращениям доступны в консоли.
Управление заказом →Время справа показывает лишь примерное распределение действий, а не срок подготовки устройства. Фактический срок и наличие данных для подключения проверяйте в статусе заказа и устройства в консоли.
Около 4 минутНа действия в примере, без ожидания подготовки устройства
Выберите доступную конфигурацию с учётом требований проекта к памяти и хранилищу. Узел выбирайте с учётом расположения команды и часовых поясов. Сначала проверьте доступность, затем оформите заказ.
Проверьте срок аренды и дополнительные опции, затем отправьте заказ. Доступность и фактически работающие способы оплаты отображаются в консоли.
Дождитесь статуса готовности устройства. В консоли найдите назначенные этому экземпляру адрес, учётную запись и инструкции по подключению. Не копируйте учётные данные из общедоступных примеров.
Подключитесь и проверьте учётную запись, свободное место на диске и версию инструментов Xcode. Если данные не совпадают с ожидаемыми, остановите автоматические задания и сохраните вывод.
SSH подходит для получения кода, запуска сборок и проверки журналов. Для работы в графическом интерфейсе Xcode следуйте инструкции по подключению к удалённому рабочему столу для вашего экземпляра.
$ ssh developer@192.0.2.10
Last login: example session
$ xcodebuild -version
Xcode
Build version: example
$ xcodebuild -workspace App.xcworkspace \
-scheme App -configuration Release \
-destination 'generic/platform=iOS' build
** BUILD SUCCEEDED **
$ fastlane build
[example] Build completed
[example] Artifact: ./build/App.ipaЛокальный Mac → облачный Mac: сначала обеспечьте доступ к исходному коду и зависимостям, затем проверьте инструменты и перенаправьте задания CI на новый узел.
По возможности получите код из репозитория. Проверьте, какие файлы конфигурации и ресурсы сборки не включены в него. Перед передачей учтите конфиденциальные данные: не сохраняйте учётные данные в репозитории или журналах.
Проверка:В облачной папке есть нужные файлы проекта, а права доступа к конфиденциальным файлам проверены.
Зафиксируйте версии Xcode, инструментов командной строки и зависимостей менеджеров пакетов, используемых локально. В облаке заново разрешите зависимости и сверьтесь с минимальными требованиями проекта к системе и архитектуре.
Проверка:Сборка запускается из командной строки с тем же Scheme, различия версий зафиксированы.
Настройте для нового узла отдельные Runner и теги заданий. Сначала выполните проверку без учётных данных для публикации, затем проверьте права, необходимые для сборки.
Проверка:Тестовое задание выполняется на нужном узле, журналы и артефакты можно отследить.
Сначала вручную выполните полную сборку и сохраните версии инструментов, команду и вывод ошибок. Только затем передавайте задачу автоматизации. Настройки подписи и зависимостей зависят от проекта.
Получите репозиторий способом, одобренным командой, и проверьте нужный коммит, подмодули и lock-файлы. Сначала выполните git status— так вы не будете оценивать результат сборки при неизвестных изменениях.
Определите, кто управляет сертификатами, профилями подготовки и нужными ключами и кто имеет к ним доступ. Не размещайте закрытые ключи в общедоступном репозитории и не вставляйте полные учётные данные в обращение о проблеме.
Сначала проверьте xcodebuild -version и Scheme проекта, затем выполните команду сборки, используемую в самом проекте. Зафиксируйте код завершения и первую значимую ошибку, а не только конец журнала.
Проверьте файлы артефактов, их размер и путь сохранения, затем архивируйте или перенесите их по процессу команды. Сообщение об успешной сборке не заменяет проверку самих файлов и результата подписи.
Чтобы подключить GitLab CI macOS Runner, установите и зарегистрируйте Runner на узле, свяжите его с проектом с нужными правами и ограничьте выполнение заданий тегами. Способ регистрации, область доступа и параметры параллельного выполнения должны соответствовать правилам управления CI в вашей команде.
Для первой проверки достаточно вывести версии системы и Xcode. Это подтвердит, что задание достигло нужного узла Apple Silicon, но не докажет, что подпись, загрузка зависимостей и публикация уже работают.
fastlane может быть частью существующего процесса сборки, но не заменяет проверку прав доступа, подписи и версий, предусмотренную проектом.
Перед заказом выберите модель и узел, укажите срок аренды — день, неделю, месяц или квартал — и отметьте, нужны ли расширение SSD или объединение через Thunderbolt 5. Дополнительные опции оплачиваются отдельно; окончательный выбор и сумма указаны в заказе.
Оплата принимается только в USDT-TRC20 и картами Visa / Mastercard / Amex через Stripe; расчёты ведутся в долларах США (USD). Доступные платёжные шлюзы смотрите в консоли.
В консоли проверьте номер заказа, срок аренды, узел, дополнительные опции и состояние устройства. Если возник вопрос по оплате текущего заказа, войдите в консоль и создайте обращение, указав номер заказа и нужные для проверки позиции. Не отправляйте платёжные данные в общедоступных сообщениях.
Открыть консольПеред обращением в команду запишите время события, номер заказа для экземпляра, выполненные действия и текст ошибки без конфиденциальных данных. Не отправляйте пароли, закрытые ключи, сертификаты подписи или незамаскированные материалы проекта.
Сначала проверьте состояние устройства, адрес и учётную запись в консоли, затем — локальную сеть и способ подключения. Запишите команду подключения, тип ошибки и время её возникновения; скройте учётные данные.
Укажите версию коммита, версию Xcode, Scheme, полную команду и первую значимую ошибку. Определите этап сбоя: загрузка зависимостей, компиляция, подпись или экспорт. Не ограничивайтесь последней строкой «сборка завершилась ошибкой».
Проверьте, сколько места занимают папка проекта, кэш сборки и артефакты. Сначала выясните, какие файлы команда может безопасно удалить. Приложите статистику занятого места и путь с ошибкой, удалив конфиденциальные данные; не удаляйте артефакты, которые ещё нужно архивировать.
Проверьте текущую учётную запись для выполнения, владельцев файлов и права на репозиторий или материалы для подписи. Запишите затронутые пути и текст ошибки; не пытайтесь решить проблему, открывая доступ ко всем файлам.
Сначала сравните три конфигурации и сроки аренды, затем проверьте доступность в консоли. После подключения выполните воспроизводимую проверочную сборку.