Это руководство предназначено для разработчиков и инженеров CI/CD, впервые использующих Oakmini. Вы выберете выделенный физический Mac mini, подключитесь по SSH или VNC, восстановите инструменты Apple Silicon, выполните воспроизводимую сборку и подключите self-hosted runner к существующему конвейеру.
$ uname -m
arm64
$ sw_vers -productVersion
macOS ready
$ system_profiler SPHardwareDataType
Chip: Apple M4
$ xcodebuild -version
Xcode toolchain detected
$ git --version
git ready
✓ базовая конфигурация среды сохраненаЗаранее зафиксируйте совместимость, регион, период и права доступа — это поможет не обнаружить после подключения несовместимую архитектуру зависимостей, нехватку диска или отсутствие доступа к репозиторию. Сохраните результаты в журнале миграции проекта.
Проверьте, доступна ли для зависимостей версия arm64 , уделив особое внимание бинарным инструментам, образам контейнеров, нативным расширениям и старым скриптам. Если проект пришёл из среды Intel, заранее составьте список компонентов для замены или повторной компиляции.
file ./your-binaryПроверить целевую архитектуруВыберите Сингапур, Японию (Токио), Южную Корею (Сеул), Гонконг или западное побережье США. Для интерактивного VNC выбирайте регион ближе к основным операторам; для сборок без участия пользователя учитывайте расположение исходного кода, хранилища артефактов и команды.
ping / tracerouteИзмерить из рабочей сетиДень подходит для краткой проверки, неделя — для ускоренной миграции, месяц или квартал — для постоянной разработки и runner. Оцените полный цикл подготовки, сборки, приёмки и выгрузки артефактов, а не только длительность одной задачи.
day / week / month / quarterПериоды заказа нельзя смешиватьОтдельно оцените объём репозитория, кэша зависимостей, данных симуляторов, архивов и экспортируемых артефактов. Оставьте запас в каталоге сборки, чтобы разбор зависимостей или архивация не прервались из-за заполненного диска. Для долгих задач определите стратегию очистки кэша.
df -hПовторно проверить после подключенияДля задач в командной строке подготовьте SSH-клиент и ключ; для графического интерфейса macOS — VNC-клиент. Убедитесь, что локальная сеть разрешает нужное подключение, и зафиксируйте влияние корпоративного брандмауэра, прокси или VPN на маршрут.
ssh -VСначала проверить локальный клиентПроверьте права на чтение репозитория, доступ к источнику зависимостей, регистрацию CI runner, материалы подписи сборок и загрузку артефактов. Используйте отдельные учётные данные для задачи и минимально необходимые права автоматизации.
read / build / uploadУказать область прав для каждого пунктаOak Core и Oak Forge — выделенные физические узлы Mac mini, а не виртуальные машины. При выборе учитывайте пиковое потребление памяти, число параллельных сборок, размер рабочего набора и объём артефактов, а не расплывчатые показатели ускорения.
Подходит для отладки одного проекта, проверки зависимостей, автоматизации с малым числом параллельных задач и кратких миграционных проверок. Если репозиторий, симуляторы и архивы занимают много места, добавьте хранилище при заказе.
Подходит для параллельной работы с несколькими проектами, крупных графов зависимостей, компиляции с высоким потреблением памяти, экспериментов с ИИ на Apple Silicon и задач с большим объёмом кэша и артефактов.
| Поле заказа | Доступные варианты | Критерий выбора | Результат проверки |
|---|---|---|---|
| Расчётный период | день, неделя, месяц, квартал | Включает подготовку среды, выполнение задач, приёмку и выгрузку артефактов | Диапазон дат в заказе соответствует плану |
| Узел | Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг, западное побережье США | Фактический сетевой маршрут между пользователями, исходным кодом и местом назначения артефактов | Регион совпадает с базовой записью |
| Расширение хранилища | +1TB SSD или +2TB SSD | Общий объём репозитория, кэша зависимостей, рабочего каталога, архивов и экспортируемых артефактов | Оставлен запас для очистки и временных файлов |
| Параллельный вариант | Параллельное подключение Thunderbolt 5 (за устройство) | Выбирайте только для заранее спланированного многонодового рабочего процесса | Проверить количество и топологию каждого узла |
Получите на портале текущее состояние хоста, адрес, порт и сведения о доступе. Не угадывайте параметры по старому заказу или локальной истории. Для работы в командной строке используйте SSH, для графического интерфейса — VNC.
ssh -p <PORT> <USER>@<HOST>
hostname
sw_vers
uname -m
system_profiler SPHardwareDataType
df -h
systemsetup -gettimezone
dateСохраните вывод в журнале миграции. В нём должны быть как минимум имя хоста, версия macOS,arm64 , модель чипа, объём диска, часовой пояс и текущее время.
Хост должен быть доступен для подключения. Если состояние ещё меняется, дождитесь обновления портала и не повторяйте учётные данные без необходимости.
Проверьте адрес хоста, порт, имя пользователя и способ подключения. Файл ключа храните только на контролируемом устройстве.
При первом SSH-подключении сохраните отпечаток; при неожиданном изменении остановите подключение и проверьте данные через обращение в консоли.
При подключении по VNC сначала выберите разрешение и качество с учётом текущей сети, затем проверьте раскладку клавиатуры, работу буфера обмена и настройки сна.
Сначала создайте проверяемую базовую среду, затем устанавливайте зависимости проекта. Не копируйте целиком домашний каталог со старой машины; переносите прежде всего списки, конфигурацию и lock-файлы, чтобы избежать архитектурных различий и бесполезного кэша.
Восстановите список программ и запустите диагностику, проверив префикс установки и окружение shell. На Apple Silicon распространённые пути должны совпадать с жёстко заданными путями в скриптах либо быть заменены.
brew bundle check && brew doctorНастройте данные автора коммитов, правила перевода строк и способ чтения учётных данных. Сначала загрузите тестовый репозиторий только для чтения, проверьте сеть и права, затем переходите к рабочему проекту.
git config --list --show-originВосстановите версии Ruby, Node.js, Python и других сред по lock-файлам. Запишите менеджер версий, глобальные инструменты и версии проекта — не полагайтесь на формулировку «последняя версия».
ruby -v; node -v; python3 --versionПроверьте выбранный каталог разработчика, версию Xcode, SDK и инструменты командной строки. Если проектам нужны разные версии, явно зафиксируйте шаги переключения в конвейере.
xcode-select -p; xcodebuild -versionВосстановите зависимости по lock-файлу и сохраните полный журнал разрешения. Если зависимость требует компиляции нативного расширения, проверьте, что архитектура вывода — arm64.
file ./path/to/native-extensiondate
hostname
sw_vers
uname -m
xcode-select -p
xcodebuild -version
git --version
brew --version
brew list --versions
ruby -v
node -v
python3 --version
df -hЦель первой сборки — не минимальное время выполнения, а проверка воспроизводимости разрешения зависимостей, прав подписи, каталога вывода и журналов. Сначала протестируйте фиксированную ревизию, затем переходите к полному проекту.
Загрузите указанную ревизию или тег и проверьте полноту подмодулей, приватных зависимостей и объектов больших файлов. Запишите хеш коммита, чтобы входные данные не менялись во время теста.
git rev-parse HEAD
Восстановите зависимости по lock-файлу и запишите стандартный вывод и ошибки в журнал. При проблемах архитектуры сначала найдите конкретный бинарный файл, не очищайте всю среду без необходимости.
command 2>&1 | tee dependency.log
Убедитесь, что процесс сборки может читать необходимые материалы подписи и конфигурационные файлы. Автоматизированной учётной записи предоставьте только права для соответствующего проекта и этапов сборки.
security find-identity -v -p codesigning
Поместите DerivedData, архивы, результаты тестов и экспортируемые артефакты в чётко определённые каталоги, не используя общие неконтролируемые временные пути.
mkdir -p build logs artifacts
Журнал должен содержать как минимум ревизию, версию Xcode, SDK, команду, время начала и окончания и код выхода. Перед загрузкой удалите чувствительные данные.
echo "$?" > logs/exit-code.txt
Повторно запустите сборку с той же ревизией и конфигурацией, чтобы убедиться, что зависимости, пути и права не зависят от временных действий первой сессии. Результаты должны быть объяснимыми и сопоставимыми.
./scripts/verify-build.sh
xcodebuild \
-project Example.xcodeproj \
-scheme Example \
-configuration Release \
-derivedDataPath ./build/DerivedData \
build 2>&1 | tee ./logs/first-build.logКод выхода команды равен 0; журнал позволяет определить фиксированную ревизию и версии инструментов; в каталоге вывода есть ожидаемые артефакты; повторный запуск не требует незаписанных ручных действий.
Три направления можно готовить параллельно, но они должны сойтись на общей базе: фиксированной версии репозитория, записанных версиях инструментов и заданных тегах runner, после чего запускается воспроизводимая проверочная задача.
Переносите только данные с понятным происхождением, не копируйте историю, которую невозможно отследить.
Восстанавливайте инструменты по списку и подтверждайте результат выводом версий.
Сделайте правила планирования однозначными для этого выделенного физического узла.
Работающая среда ещё не означает готовность к длительной эксплуатации. После первой сборки сразу обработайте исходные учётные данные, хранение ключей, область репозитория и чувствительные данные в скриптах.
Перед коммитом найдите распространённые чувствительные поля и проверьте историю shell, файлы окружения, конфигурацию CI и журналы. При обнаружении открытых учётных данных сначала отзовите и замените их, затем очистите историю файлов.
Ограничьте права файлов закрытых ключей, удалите неиспользуемые открытые ключи и задайте для автоматизированных подключений понятные имена и описания назначения ключей.
chmod 600 ~/.ssh/private_key
Сохраняйте время, команды, версии, коды выхода и стеки ошибок; удаляйте токены доступа, содержимое закрытых ключей, исходные материалы подписи и другие данные, пригодные для авторизации.
Приёмка должна основываться на воспроизводимых результатах, а не на том, что «сейчас всё работает». Отключите сеанс, подключитесь заново и повторите ключевые команды из чистой оболочки.
Отключите SSH и VNC, затем подключитесь с сохранёнными корректными параметрами. Отпечаток хоста, имя пользователя, порт и графический сеанс должны соответствовать записи.
Восстановите зависимости по lock-файлу; код выхода команды равен 0; архитектура нативных компонентов корректна; журнал установки сохранён без чувствительных данных.
Выполните сборку с фиксированной ревизией и версиями инструментов; каталог вывода должен быть определён, а повторный запуск не должен зависеть от незаписанных ручных действий.
Архивы, результаты тестов и другие целевые артефакты должны экспортироваться из указанного каталога; имена файлов, версии и способ проверки должны соответствовать соглашениям команды.
Статус self-hosted runner — online, его теги соответствуют целевой задаче, а задания неавторизованных проектов не принимаются.
Базовая конфигурация среды, журналы зависимостей и сборки, код выхода и пути к артефактам заархивированы; чувствительные поля удалены.
На портале можно проверить состояние хоста, данные заказа и вход в управление. Все узлы работают стабильно 365 дней в году.
Откройте портал, проверьте доступные узлы и выберите Oak Core или Oak Forge, расчётный период и объём хранилища. После заказа выполните подключение, восстановите инструменты и пройдите приёмку по шагам этой страницы.