Заказ и устройство
Убедитесь, что выбрали Mac, модель и идентификатор экземпляра из нужного заказа. Если у вас несколько устройств, сначала определите, с каким будете работать, чтобы случайно не передать файлы проекта на другой Mac.
Подключение и сборка
Подключитесь к облачному Mac по данным заказа.
Сначала проверьте устройство, регион и права доступа, затем подключитесь по SSH и проверьте среду сборки. Инструкция подходит для первого подключения и диагностики. Адрес, имя пользователя и ключ берите из данных своего заказа.
Уже оформили заказ? Откройте его в консоли и выполните проверки в указанном порядке.
Проверка подключения
01 / 03
Сначала проверка, затем подключение
Один заказ — одно устройство.
- Устройство
- Сверьте модель и идентификатор экземпляра с заказом
- Регион
- Проверьте выбранный регион и способ подключения
- Доступ
- Используйте данные для подключения из заказа
В открытых примерах нет настоящих адресов, закрытых ключей или токенов доступа. Актуальные данные смотрите в консоли.
Перед началом
Проверьте параметры подключения и откройте терминал.
Найдите данные в сведениях о заказе — не копируйте их из старых заметок или переписки: они могли измениться. Если вы ещё не оформили заказ, сначала откройте страницуМодели и ценыи проверьте доступные конфигурации и сроки аренды.
Регион и данные подключения
Проверьте выбранный в заказе регион и найдите адрес, порт и имя пользователя в сведениях об устройстве. Не используйте демонстрационный адрес с этой страницы для реального подключения.
Учётная запись и права доступа
Убедитесь, что текущая учётная запись позволяет просматривать заказ и данные подключения. Храните закрытый ключ в защищённой локальной среде — не отправляйте его в заявку, репозиторий или на общедоступную страницу.
Не отправляйте конфиденциальные данные.Для диагностики можно прислать сообщение об ошибке без конфиденциальных данных, но не отправляйте закрытые ключи, полные токены, содержимое сертификатов или исходные журналы с персональными данными.
Подключение
Настройте безопасное подключение за три шага.
Сначала получите актуальные параметры заказа, затем подготовьте локальный ключ и при первом подключении проверьте идентификатор хоста. Сетевое соединение, права учётной записи и подлинность хоста — разные проверки. Не пропускайте их, даже если появилось приглашение ко входу.
-
01
Получите данные для подключения
Войдите в консоль, откройте нужный заказ и сохраните адрес, порт, имя пользователя и инструкции для устройства. Если данные подключения ещё не появились, проверьте статус заказа — не пытайтесь угадать адрес.
-
02
Подготовьте ключ SSH
Проверьте права доступа к файлу закрытого ключа и добавьте соответствующий открытый ключ согласно инструкциям к заказу. Для CI подготовьте отдельные учётные данные с ограниченными правами. Не копируйте закрытый ключ с личного компьютера в репозиторий сборки.
-
03
Проверьте подлинность хоста
При первом подключении сверьте отпечаток хоста с доверенными данными устройства. Если отпечаток не совпадает или внезапно изменился, прекратите подключение и проверьте, правильно ли выбраны устройство, адрес и способ доступа. Не игнорируйте предупреждение.
Примеры команд
После подключения выполните несколько простых проверок.
Ниже показан порядок проверок, а не фактическая версия системы, результат сборки или конфигурация конкретного устройства. Адрес 192.0.2.10 приведён только для примера и не является адресом подключения из заказа. Перед запуском укажите данные из консоли.
Сначала убедитесь, что удалось войти на нужное устройство, затем проверьте путь к инструментам командной строки Xcode и запустите задачу сборки в каталоге проекта. Каждый этап можно диагностировать отдельно — не нужно сразу переносить весь CI-процесс.
Проверка подключения и сборки · пример
$ ssh -i ~/.ssh/id_ed25519 operator@192.0.2.10
Пример вывода: вы вошли на целевое устройство; проверьте подлинность хоста
$ xcodebuild -version
Пример вывода: отображается версия Xcode, установленная на устройстве
$ fastlane build
Пример вывода: после проверки конфигурации проекта выводится результат сборкиВ примерах нет настоящих учётных данных.fastlane build Подходит только для проектов с настроенной задачей fastlane build. Фактическая команда зависит от конфигурации проекта.
Первая сборка
Сначала зафиксируйте версии и зависимости, затем сравните результаты сборки.
Успешное подключение подтверждает только то, что вы вошли на устройство, но не то, что среда разработки совместима с проектом. Выполните проверки до установки Runner и загрузки больших объёмов файлов. Фактические версии системы и инструментов зависят от арендованного устройства.
Система и Xcode
Запишите версию macOS, установленную версию Xcode и каталог разработчика, на который указывает xcode-select -p . Если проекту требуется определённая версия SDK, проверьте доступные версии до начала сборки.
Проверьте: версию системы, версию Xcode и путь к инструментам командной строки.
Зависимости проекта
Установите зависимости по lock-файлу репозитория и проверьте менеджер пакетов, среду запуска скриптов и необходимые проекту плагины. Управляйте установкой инструментов, конфигурацией проекта и материалами для подписи отдельно — не считайте сбой одной сборки неисправностью устройства.
Проверьте: lock-файл, журнал установки и версии зависимостей.
Минимальная сборка
В каталоге проекта запустите воспроизводимую проверку или сборку и сохраните команду, код завершения и место первой ошибки. Когда ручная сборка заработает, подключите эту же задачу к CI.
Проверьте: каталог запуска, полную команду и первый этап со сбоем.
Настройка автоматизации
Настройте Runner так, чтобы он повторял проверенную ручную сборку.
Задача CI/CD — не создать непрозрачную среду, а оформить успешные команды, зависимости и требования к правам в виде воспроизводимой задачи. Способ регистрации и настройки исполнителя зависит от вашей CI-системы. Не вставляйте настоящие токены регистрации в общедоступную конфигурацию.
A
Регистрация и изоляция
Зарегистрируйте Runner для нужного устройства в своей CI-системе и убедитесь, что он получает ожидаемые проекты и задачи. Проверьте пользователя запуска, рабочий каталог и настройки параллельного выполнения.
B
Ключи и материалы для подписи
Храните ключи доступа и материалы для подписи в защищённом хранилище секретов CI-системы. Не добавляйте их в репозиторий, вывод скриптов сборки или кэш. Предоставляйте только права, необходимые задаче.
C
Кэш и артефакты
Определите пути к кэшу зависимостей и условия его очистки. Сохраняйте артефакты сборки в месте, принятом в команде. Если ошибка не воспроизводится, сравните результат со сборкой без старого кэша.
D
Завершение сеанса
После завершения задачи проверьте временные файлы, фоновые процессы и состояние сеанса. При передаче устройства или изменении прав отзовите ненужный доступ и убедитесь, что в рабочем каталоге не осталось учётных данных.
Диагностика
Начните с первого этапа, на котором возникла ошибка.
Запишите, на каком шаге возникла проблема, и сохраните соответствующие команду, код завершения и журнал без конфиденциальных данных. Не ограничивайтесь снимком экрана с надписью «Сбой»: первая ошибка обычно важнее итоговой строки.
Не удаётся подключиться по SSH
Сначала проверьте заказ и целевое устройство, затем адрес, порт и доступность устройства из локальной сети. После этого проверьте имя пользователя, права доступа к ключу и предупреждения о подлинности хоста. Фиксируйте тайм-аут и отказ в доступе отдельно: при тайм-ауте проверьте путь подключения, при отказе — права.
Проблема с настройками подписи
Убедитесь, что настройки подписи проекта, цель сборки и пользователь CI совпадают. Не вставляйте содержимое сертификатов или закрытых ключей в заявку в поддержку. Достаточно прислать строку ошибки без конфиденциальных данных и указать шаг сборки, на котором она возникла.
Сборка завершилась с ошибкой
Сравните путь к Xcode, версии зависимостей, рабочий каталог и источники переменных среды при ручном запуске и в задаче CI. Найдите первую фактическую ошибку компиляции или скрипта и только затем решайте, нужно ли очистить кэш и повторить сборку.
Недостаточно места на диске
Проверьте свободное место и отдельно оцените файлы проекта, артефакты сборки, кэш зависимостей и временные файлы. Перед очисткой убедитесь, кому принадлежат файлы. Если нагрузке постоянно нужно больше места, на страницеТарифыпроверьте доступные варианты расширения хранилища.
При обращении в поддержку:Укажите модель устройства и регион из заказа, время возникновения проблемы, выполненную команду, место первой ошибки и уже предпринятые шаги. Перед отправкой удалите токены, сертификаты, закрытые ключи и персональные данные.
Обратитесь в поддержку
Не удалось решить проблему самостоятельно? Укажите данные заказа.
По вопросу о существующем заказе войдите в консоль, проверьте сведения об устройстве и отправьте заявку, привязав её к нужному заказу. По вопросам выбора до покупки ознакомьтесь с рекомендациями по подготовке письма на странице контактов. Не отправляйте пароль от учётной записи или полный ключ.
Готовы начать?
Выберите устройство и подключите его по инструкции.
Три варианта выделенных физических Mac на Apple Silicon доступны в аренду на день, неделю, месяц или квартал. Сначала выберите модель и срок, а после заказа получите данные для подключения в консоли.