Сначала выберите регион, модель и срок, затем настройте учетные данные, проверьте SSH, инициализируйте графический рабочий стол и выполните первую сборку в Xcode. Фиксируйте проверяемый статус на каждом шаге.
При выборе важен не только чип. Регион, способ доступа, версии инструментов и ответственные в команде напрямую влияют на первый час после активации узла.
Выберите Сингапур, Японию (Токио), Южную Корею (Сеул) или Гонконг — в зависимости от расположения основных разработчиков и маршрута к хранилищу артефактов. Учитывайте не только местоположение команды, но и сетевой путь к репозиторию и источникам зависимостей.
SG · JP · KR · HKДля легких сборок начните с Orb M4 16; для больших графов зависимостей и параллельных задач рассмотрите Orb M4 24; для сборок с большим объемом памяти или локальных экспериментов с ИИ выберите Orb M4 Pro.
Всего 3 конфигурацииДля краткой проверки выберите день или неделю, для стабильного конвейера — месяц или квартал. Сначала зафиксируйте внутреннюю дату приемки, затем решайте вопрос о продлении, чтобы не передавать выпуск продукта временному заказу без ответственного.
День · неделя · месяц · кварталПодготовьте ключ Ed25519, предназначенный для этого узла, и убедитесь, что закрытый ключ хранится только на авторизованном устройстве или в контролируемой системе ключей. Не используйте личный повседневный ключ как общую учетную запись команды.
Рекомендуется Ed25519Назначьте владельца узла, администратора CI и контакт для инцидентов. Каждый участник использует отдельный ключ; фиксируйте добавление, изменения и отзыв доступа, не применяйте одну учетную запись для всей команды.
Отдельные учетные данные для каждогоЗаранее зафиксируйте версии macOS, Xcode, инструментов командной строки, Ruby, Node, CocoaPods и менеджеров зависимостей. Запишите требования в репозитории и проверьте их по пунктам при инициализации узла.
Версии должны воспроизводитьсяКонсоль показывает доступные регионы для каждой модели. Комбинации в каталоге обычно доступны для заказа, а фактический статус доступности определяется ответом консоли в реальном времени.
Orb M4 16: M4, 16 ГБ ОЗУ и 256 ГБ хранилища; Orb M4 24: M4, 24 ГБ ОЗУ и 512 ГБ хранилища; Orb M4 Pro: M4 Pro, 64 ГБ ОЗУ и 2 ТБ хранилища.
Доступны Сингапур, Япония (Токио), Южная Корея (Сеул) и Гонконг; срок — день, неделя, месяц или квартал. Команда должна внести код региона и дату продления во внутренний реестр активов.
Проверьте модель, регион, срок и дополнительные параметры, затем оформите заказ. Адрес узла, первоначальные данные доступа и статус сервиса появятся в консоли; не пересылайте их по неавторизованным каналам.
Первоначальные данные нужны только для первого контролируемого подключения. Не импортируйте производственный репозиторий или материалы подписи, пока не проверите ключи, не настроите доступ и не сохраните данные восстановления.
Ключ разработчика используется для интерактивной диагностики, ключ раннера получает только права, необходимые конвейеру. При уходе участника отзывайте его открытый ключ, не меняя общую учетную запись команды.
Перед изменением сетевых настроек, SSH или графической сессии сохраните текущую рабочую сессию и убедитесь, что данные восстановления в консоли проверены вторым ответственным.
Не пропускайте проверку отпечатка хоста. Адрес и порт берите из консоли, а доверенный отпечаток сверяйте с подтвержденной командой записью о выдаче.
# Установите переменную только после получения адреса из консоли
export NODE_HOST="ADRES_UZLA"
export NODE_PORT="22"
# Исправьте права выделенного закрытого ключа
chmod 600 ~/.ssh/orbvps_node
# Считайте и покажите отпечаток хоста, затем сверьте его с записью о выдаче
ssh-keyscan -p "$NODE_PORT" "$NODE_HOST" \
| ssh-keygen -lf -
# Выполните первое подключение
ssh -p "$NODE_PORT" \
-i ~/.ssh/orbvps_node \
nodeadmin@"$NODE_HOST"
# После входа проверьте состояние оборудования, системы и диска
$ uname -m
arm64
$ sw_vers
$ sysctl -n machdep.cpu.brand_string
$ df -h /
$ uptimeГрафический рабочий стол подходит для настройки дисплея, системных параметров и первого интерактивного запуска Xcode. Данные доступа не публикуются; точный адрес и учетные данные доступны после активации.
После каждой настройки выйдите из системы и подключитесь заново, чтобы убедиться, что конфигурация сохраняется в новой сессии.
Выберите разрешение, подходящее для текущей сети и экрана. Если текст слишком мелкий или изображение заметно запаздывает, сначала уменьшите разрешение, затем оцените сетевой маршрут.
Согласуйте язык системы, региональный формат и часовой пояс команды, чтобы журналы сборки, даты и сценарии автоматизации были единообразными.
Убедитесь, что блокировка не прерывает задачи, которым требуется длительное выполнение, и одновременно ограничьте несанкционированный доступ. Интерактивные сессии и CI-задачи проверяйте отдельно.
Намеренно разорвите графическую сессию, подключитесь снова и проверьте состояние рабочего стола, разрешение и запущенные процессы.
Выполняйте миграцию в три этапа: сначала переносите проверяемые данные, затем фиксируйте инструменты и только после этого подключайте CI. Не копируйте репозиторий, зависимости и настройки автоматизации одновременно без проверки.
Переносите только нужные репозитории, lock-файлы зависимостей, сценарии сборки и тестовые данные. Исключите временный кэш, старые артефакты и бесхозные файлы; после миграции проверьте состояние репозитория и контрольные суммы важных файлов.
Установите Xcode, инструменты командной строки и менеджеры зависимостей согласно требованиям репозитория. Сохраните фактические версии в базовой записи, не заменяйте точный номер формулировкой «последняя версия».
После регистрации self-hosted runner сначала запустите контролируемую тестовую задачу. Проверьте выполнение анализа ошибок, очистки кэша и восстановления, затем постепенно подключайте рабочую ветку.
Критерий завершения миграции:Один и тот же коммит собирается на локальном и облачном Mac с использованием зафиксированного набора инструментов, ключевые тесты дают одинаковый результат, а развертывание можно повторить по документации.
Цель первой сборки — не минимальное время, а доказательство воспроизводимости инструментов, зависимостей, прав и путей вывода.
Убедитесь, что выбранный каталог разработчика, версия Xcode и доступный SDK соответствуют требованиям проекта.
Примите лицензию Xcode, затем установите Ruby, Node, CocoaPods и другие зависимости строго по lock-файлу.
Явно укажите workspace, scheme и configuration, а полный стандартный вывод сохраните в отдельном файле журнала.
Зафиксируйте номер коммита, версии инструментов, время начала и окончания, код возврата и расположение артефактов для последующего сравнения изменений.
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild -version
Xcode <VERSIYA_PROEKTA>
$ sudo xcodebuild -license accept
$ bundle install
$ bundle exec pod install
$ mkdir -p build-logs
$ set -o pipefail
$ xcodebuild \
-workspace App.xcworkspace \
-scheme App \
-configuration Release \
clean build \
| tee build-logs/first-success.log
** BUILD SUCCEEDED **После подключения self-hosted runner сначала ограничьте область специальными тегами и тестовой веткой, а затем постепенно открывайте рабочие сборки.
Задача должна вывести сведения о среде, восстановить зависимости, выполнить модульные тесты и одну сборку без публикации. Перед подключением рабочей ветки проверьте маршрутизацию тегов, полноту журналов, очистку кэша и остановку при ошибке.
Внесите результаты проверок в руководство команды. Узел может работать 365 дней в году, но процесс сборки по-прежнему требует четко определенных данных, мониторинга и ответственности за реагирование.
Репозитории, конфигурация сборки, данные восстановления ключей и необходимые артефакты имеют копии вне узла; проверка восстановления выполнена.
Восстановление провереноКак минимум фиксируйте свободное место на диске, коды завершения сборок, время ожидания задач и статус раннера; задайте пороги отклонений.
За метрики назначен ответственныйОсновной и резервный ответственные имеют доступ к записям узла, журналам сборки и тикетам консоли; порядок передачи дел описан.
Основной и резервный контакты назначеныСрок заказа и внутренняя дата подтверждения зарегистрированы и не зависят от памяти одного участника. Перед изменением конфигурации оцените окно текущих задач.
Срок зарегистрированКлючи сотрудников, ключи раннера и соответствующие права перечислены; каждый доступ можно отозвать отдельно, не затрагивая остальных участников.
Отдельная запись для каждогоИдентификатор узла, время события, шаги воспроизведения и обезличенный журнал можно быстро подготовить; авторизованный участник может отправить тикет через консоль.
Материалы готовы к отправкеВыберите модель, регион и срок, а после активации выполните по этому руководству безопасное подключение, первую сборку и приемку CI.