01Проверка данных
Первый вход после получения данных для доступа
Сопоставьте заказ, машину и данные подключения. Сначала проверьте один экземпляр, чтобы случайно не указать в клиенте адрес другого узла.
Показать шаги
- Войдите в консоль и откройте сведения об экземпляре в нужном заказе. Проверьте модель, узел, срок аренды и статус выдачи.
- Сохраните адрес, имя пользователя и фактический порт. Используйте данные из консоли — не собирайте их из пересланных писем и переписки.
- После первого входа смените пароль, выполните
sw_vers для проверки версии системы, затем запустите df -h и проверьте свободное место на диске.
- Запишите пути к каталогам проекта и сборок, а также имя ответственного. Не добавляйте общие учётные данные в репозиторий.
Готово, если:вы можете подключиться повторно, данные системы соответствуют заказу и вы знаете, где сохраняются результаты сборки. Если оплата прошла, но данные для доступа ещё не получены, отправьте заявку в заказе — не создавайте дубликаты.
02Удалённое подключение
Настройка общего экрана и SSH-ключа
Графический интерфейс удобен для начальной настройки и отладки, а SSH — для команд, передачи файлов и автоматизации.
Показать шаги
- Подключитесь к общему экрану по выданным данным. В настройках системы откройте «Основные → Общий доступ» и разрешите подключение только нужным пользователям.
- Для работы в терминале проверьте, включён ли «Удалённый вход». Создайте локальный SSH-ключ или выберите существующий и передайте на сервер только открытый ключ.
- Добавьте открытый ключ в файл пользователя
~/.ssh/authorized_keysи установите права 700для каталога и 600для файла.
- Не закрывая текущий сеанс, откройте ещё одно окно терминала и проверьте вход по ключу. Только после этого меняйте способ аутентификации. Закрытый ключ храните локально или в системе управления ключами команды.
Готово, если:к графическому сеансу можно подключиться, а SSH-ключ проходит проверку в новом сеансе. Порт и настройки брандмауэра сверяйте с фактическими данными подключения.
Инструкции по подключению для разных систем
03Проверка инструментов
Установка и проверка инструментов командной строки Xcode
Сначала проверьте, соответствует ли текущая среда требованиям проекта. Не обновляйте систему только потому, что в ней уже установлен Xcode.
Показать шаги
- Выполните
xcodebuild -version и xcode-select -p чтобы проверить версию и путь к инструментам разработчика.
- Если инструменты командной строки не установлены, выполните
xcode-select --install. Для полной сборки нужна версия Xcode, подходящая проекту: инструменты командной строки не включают все SDK.
- Если установлено несколько версий Xcode, используйте
DEVELOPER_DIR чтобы указать каталог инструментов для отдельной задачи, или выполните xcode-select чтобы изменить выбранную в системе версию.
- Примите лицензионные условия, установите компоненты для первого запуска и соберите и протестируйте небольшой проект.
Готово, если:версия Xcode в терминале совпадает с версией в логах CI, а нужный SDK доступен. Укажите версию в настройках проекта или окружении запуска runner, не полагаясь на память оператора.
04Настройка автоматизации
Регистрация self-hosted runner на Mac mini server
Сначала проверьте ручную сборку, затем передайте задачи runner. Команду регистрации берите в настройках проекта на платформе CI.
Показать шаги
- Создайте отдельного пользователя и рабочий каталог для сборок. В настройках проекта CI скачайте пакет runner для macOS и Apple Silicon.
- Зарегистрируйте runner с краткосрочным токеном. Укажите в метках систему, чип, узел и назначение. Не храните долгосрочные токены доступа в репозитории.
- Сначала запустите простую задачу на переднем плане и проверьте PATH, путь к Xcode, доступ к связке ключей и загрузку результатов сборки.
- Убедившись, что прав достаточно для запуска без участия пользователя, настройте службу по инструкции платформы CI. Для задач с графическим интерфейсом отдельно проверьте требования к сеансу.
Готово, если:тестовое изменение запускает задачу, в логах виден нужный экземпляр, а результаты сборки сохраняются вне машины. Выделенная машина не означает неограниченный параллелизм: сначала проверьте последовательный запуск, затем увеличивайте число параллельных задач с учётом памяти и диска.