В этом руководстве заказ, подключение, перенос и приёмка разбиты на проверяемые действия. Сначала подтвердите конфигурацию и границы доступа, затем переносите код и инструменты сборки, чтобы не записывать конфиденциальные данные до проверки окружения.
Регион, объём памяти и срок аренды напрямую влияют на дальнейший способ переноса. Краткий план запуска, составленный заранее, надёжнее, чем уточнение условий после заказа.
Укажите основную задачу: сборка Xcode, self-hosted runner, локальный вывод моделей или обработка медиа. Затем выберите ближайший к команде или зависимым сервисам узел: Сингапур, Токио (Япония), Сеул (Южная Корея) или Гонконг.
Для краткосрочной адаптации и лёгких сборок можно рассмотреть BookaMac M4; для параллельных задач с большим объёмом памяти, вывода моделей и тяжёлой обработки медиа — BookaMac M4 Pro. Срок аренды доступен на день, неделю, месяц или квартал.
Подготовьте рабочие SSH- и VNC-клиенты, сгенерируйте локально отдельную пару ключей SSH и передайте только открытый ключ. Закрытый ключ должен храниться на контролируемом устройстве; не отправляйте его по почте или через тикет.
Оба тарифа включают выделенный физический Mac mini, а не виртуальную машину. Перед созданием заказа проверьте модель, узел, срок аренды и дополнительное хранилище; консоль в реальном времени показывает доступность и итоговые данные заказа.
Получение устройства не означает, что его можно сразу использовать для записи данных. Сначала проверьте конфигурацию и границы подключения, затем загружайте приватный репозиторий или импортируйте материалы подписи.
Проверьте, совпадает ли регион в заказе с регионом на странице поставки. Не определяйте расположение узла только по скорости подключения.
Сверьте в системной информации чип, объём памяти и накопителя с данными на странице подтверждения заказа.
Проверьте источник SSH-адреса, порта, имени пользователя и отпечатка хоста; при первом подключении сохраните результат проверки.
Уточните область действия временных учётных данных, порядок их замены и точку входа. Не пересылайте полные учётные данные в общих каналах.
Для каждого шага определите входные данные, действия и результат проверки. Если предыдущий шаг не пройден, не переносите на узел новые репозитории, учётные данные или задачи.
Сначала загрузите репозиторий, который можно собрать независимо, и проверьте ветку, хеш коммита, подмодули и большие файлы. Кэш зависимостей следует пересоздавать по мере необходимости, а не копировать неизвестный системный кэш целиком.
Проверьте текущий каталог разработчика, установите явно указанные проектом инструменты командной строки и восстановите зависимости по lock-файлу. Не обновляйте сначала все инструменты глобально, пытаясь затем объяснить различия в сборке.
Назначьте узлу понятные метки, изолируйте рабочий каталог, ограничьте число параллельных задач и сначала запустите проверочный пайплайн без действий публикации. В журналах не должны выводиться ключи, токены или полные материалы подписи.
Справа приведён адрес примеров из документации. При работе используйте адрес подключения, имя пользователя, рабочую область проекта и цель сборки со страницы поставки.
$ ssh build@203.0.113.24
The authenticity of host is confirmed.
Connected to dedicated Mac node
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild \
-workspace Sample.xcworkspace \
-scheme Sample \
-configuration Debug \
build
** BUILD SUCCEEDED **
$ bundle exec fastlane env
System Locale: zh_CN
Xcode Path: /Applications/Xcode.app
Environment check completedДля повседневной автоматизации отдавайте предпочтение SSH; когда нужно открыть интерфейс Xcode, симулятор или графические инструменты, подключайтесь через VNC-клиент.
Используйте доверенный VNC-клиент и укажите адрес, порт и учётные данные со страницы поставки. Не экспортируйте настройки подключения в общую синхронизируемую папку и не разрешайте клиенту постоянно сохранять общие учётные данные.
При первом подключении начните с умеренного разрешения и качества цвета. При заметной задержке сначала снизьте качество изображения и проверьте локальную сеть; не смешивайте время сборки с задержкой обновления экрана.
Синхронизация буфера обмена подходит для коротких команд и обычного текста; не передавайте через неё закрытые ключи, полные токены доступа или незащищённые учётные данные. Для конфиденциальных настроек используйте контролируемый процесс работы с файлами и проверяйте права доступа.
После работы с графическими инструментами завершите их работу, заблокируйте графический интерфейс macOS и отключите VNC-сеанс. Долгие задачи должны выполняться скриптом или runner, а не зависеть от постоянно открытого окна рабочего стола.
«Вход выполнен» означает только успешное подключение. Полная приёмка должна охватывать код, зависимости, сборку, журналы и сеть, а также оставлять базовую конфигурацию для следующего запуска.
Если какой-либо пункт не пройден, сначала запишите команду, код завершения, время и соответствующий журнал, затем сокращайте число переменных. Не меняйте одновременно Xcode, версии зависимостей и сетевые настройки — иначе будет сложно определить настоящую причину.
Целевая ветка и хеш коммита верны, подмодули и большие файлы загружены полностью.
Lock-файл применён, команда установки выполняется повторно без неожиданного обновления ключевых зависимостей.
Указанная цель успешно собрана; расположение, размер и способ создания артефактов можно отследить.
Полный журнал заархивирован, конфиденциальные поля обезличены, код завершения и идентификатор задачи указаны.
Необходимые проекту репозитории и конечные точки зависимостей доступны, лишние для задачи области доступа не открыты.
Выполните настройки безопасности сразу после первой приёмки и повторно проверьте их перед передачей команде, изменением runner и окончанием срока аренды.
После первой проверки замените временный пароль или данные доступа и убедитесь, что старые учётные данные больше не работают.
Используйте отдельный открытый ключ SSH, проверьте authorized_keys и ограничьте права локального файла закрытого ключа.
Назначьте участникам отслеживаемые способы доступа и не допускайте длительного совместного использования одной административной учётной записи.
Удалите тестовые архивы, временные загрузки, устаревший кэш и копии неиспользуемых учётных данных; проверьте оставшееся место.
Записывайте переключения Xcode, обновления зависимостей, метки runner и сетевые изменения, чтобы следующая диагностика опиралась на факты.
Заранее определите место переноса артефактов сборки, изменений репозитория и необходимых журналов; не откладывайте очистку данных до окончания аренды.
Заказы, продление аренды и управление хостом выполняются в консоли. Поддерживаются только USDT-TRC20 и Visa / Mastercard / Amex (через Stripe); расчёт ведётся в долларах США (USD), а фактически доступный платёжный шлюз определяется ответом серверной части.