Для новых пользователей, инженеров релизов и специалистов по CI/CD. Введите команду, фрагмент ошибки или название задачи, чтобы сузить область поиска и проверить результат по шагам.
Сейчас показано 8 точек входа.
Каждая точка входа содержит объект проверки, команду или измеряемый показатель. Фильтр меняет только список ниже и не скрывает полные разделы инструкций.
Получите данные подключения в консоли и проверьте SSH, графический интерфейс, пароль, дату и часовой пояс.
Проверьте инструменты Xcode, данные для подписи, путь к архиву и правила хранения результатов сборки.
Разделите регистрацию платформы, метки узла, предел параллелизма и рабочий каталог каждой задачи.
Последовательно исключайте зависания интерфейса по разрешению, цветам, частоте кадров и сетевому джиттеру.
Унифицируйте значения терминов «узел», runner, кэш и активы подписи, чтобы избежать разночтений.
Соберите проблемы сети, диска, Xcode и подписи в формат команд, ожидаемых результатов и вариантов ошибок.
Укажите регион, время, номер задачи и обезличенные логи, чтобы поддержка могла воспроизвести сценарий.
Разделите пересоздаваемый кэш, архивы и результаты релиза, которые необходимо сохранить.
Сократите текст ошибки или выполните поиск по имени команды, например xcodebuild, df -h, ping.
Ориентируйтесь на данные текущего экземпляра в консоли. Не копируйте адреса и учётные данные из старых обращений, переписок или исторических скриптов.
Сначала установите один стабильный способ подключения, затем проверьте пароль и часовой пояс. Не меняйте одновременно сеть, разрешение и способ аутентификации — иначе причина изменений останется неясной.
Проверьте регион узла, адрес хоста, порт, имя пользователя и состояние экземпляра. Храните учётные данные только в защищённом менеджере паролей, а не в репозитории или логах сборки.
Выполните ssh -v user@host и проверьте этапы разрешения адреса, рукопожатия и аутентификации. Если тайм-аут возникает до установления соединения, проверьте локальную сеть и порт; при ошибке аутентификации проверьте имя пользователя и актуальные учётные данные.
Для работы с интерфейсом Xcode используйте VNC или демонстрацию экрана. Сначала оставьте разрешение и цветопередачу по умолчанию, убедитесь в нормальной работе клавиатуры, мыши и буфера обмена, а затем настраивайте качество изображения.
Смените начальный пароль, выполните date и systemsetup -gettimezone проверьте дату и часовой пояс, а также убедитесь, что каталог проекта принадлежит пользователю текущей задачи.
Воспроизводимая сборка iOS требует фиксированных инструментов, точки входа проекта, активов подписи, параметров архивации и места экспорта. Записи «сборка не удалась» недостаточно для повторной проверки.
Сначала выполните xcode-select -p и xcodebuild -versionчтобы подтвердить каталог разработчика и версию Xcode, которые использует скрипт. После смены версии повторите обе команды и не ориентируйтесь на заголовок окна терминала.
Ограничивайте доступ к активам подписи по проекту и среде. После импорта выполните security find-identity -v -p codesigning для проверки доступных идентификаторов; не выводите пароли сертификатов в логи конвейера.
Скрипт должен явно указывать workspace или project, общую scheme, configuration и -archivePath. На машине сборки не полагайтесь на временный выбор в графическом интерфейсе Xcode, сделанный ранее.
С помощью -exportArchive и конфигурации экспорта под контролем версий создавайте результаты сборки. Сохраняйте архив, результаты экспорта, логи сборки и идентификатор коммита; при ошибке также оставляйте обезличенные диагностические данные.
xcodebuild \
-workspace App.xcworkspace \
-scheme App \
-configuration Release \
-archivePath "$PWD/output/App.xcarchive" \
clean archiveУзлы OakVM — выделенные физические машины, а не виртуальные машины. Параллелизм масштабируется добавлением выделенных узлов; даже на одном узле необходимо чётко разделять очередь, метки и рабочие каталоги задач.
runs-on точно; не используйте универсальные метки с неоднозначным смыслом.Базовая изоляция:Управляйте каталогами проекта, кэшем сборки, активами подписи и результатами раздельно. Не используйте очистку всего узла как обычный способ изоляции и не позволяйте двум проектам совместно использовать одну доступную для записи папку подписи.
Субъективные задержки в VNC и демонстрации экрана не обязательно вызваны нагрузкой на вычисления узла. Тестируйте в фиксированном порядке, чтобы отличить нагрузку кодирования, джиттер локальной сети и конкуренцию фоновых задач.
Сначала установите минимальное разрешение, достаточное для текущей операции, и отключите неиспользуемые дополнительные области экрана. Если отклик заметно улучшится, проблема, вероятно, связана с объёмом кодирования изображения.
Приостановите видео, анимированные превью и постоянно обновляемые окна мониторинга. Во время сборки отключите ненужное изображение симулятора и проверьте стабильность работы со статичным редактором.
Для редактирования кода и публикации обычно не нужна высокая частота кадров. Сначала добейтесь быстрого отклика ввода и чёткости текста, затем постепенно повышайте плавность изображения.
Выполните серию коротких тестов задержки до адреса узла и оценивайте колебания и потери пакетов, а не только единичное минимальное значение. После смены локальной сети повторите тест с тем же числом образцов.
Для одной задачи оставляйте одного основного оператора, а остальные участники взаимодействуют через логи сборки и записи результатов. Одновременная работа в графическом интерфейсе повышает риск конфликтов контекста.
Эти термины используются на страницах OakVM, в консоли и при общении с поддержкой. Они описывают формат поставки и рабочий процесс, а не поддержку сервиса сторонними платформами.
Сначала сохраните исходный код выхода и первую значимую ошибку, затем исправляйте проблему. Последовательный запуск множества команд очистки уничтожает исходные данные и может выдать ошибку зависимости за неисправность узла.
| Объект проверки | Команда или действие | Ожидаемый результат | Вариант ошибки |
|---|---|---|---|
| Разрешение сети и доступность | ping -c 20 hostssh -v user@host |
Адрес разрешается одинаково; в образцах нет постоянных потерь; SSH доходит до рукопожатия и аутентификации. | При ошибке разрешения проверьте адрес; при тайм-ауте до соединения повторите тест через другой локальный канал; при ошибке аутентификации проверяйте только актуальные имя пользователя и учётные данные. |
| Диск и место под сборку | df -hdu -sh ~/Library/Developer/Xcode/DerivedData |
На целевом томе достаточно места для исходников, зависимостей, архива и экспорта; размер кэша не превышает командный порог. | Сначала перенесите результаты, которые нужно сохранить, затем удалите пересоздаваемый кэш проекта; не удаляйте архивы с неизвестным владельцем. |
| Инструменты Xcode | xcode-select -pxcodebuild -version |
Каталог разработчика и версия совпадают с записями конвейера; команды завершаются успешно. | При ошибке пути явно переключите набор инструментов; при несовпадении версии остановите задачу, чтобы не получить несопоставимые архивы. |
| Проект и scheme | xcodebuild -list -workspace App.xcworkspace |
Целевая scheme видна и опубликована для автоматизации. | Если список пуст, проверьте рабочий каталог и генерацию зависимостей; если scheme не видна, проверьте общие настройки проекта и регистр имени. |
| Идентификатор подписи | security find-identity -v -p codesigning |
Идентификатор подписи текущей задачи доступен; вывод не содержит неоднозначности из-за недействительных или дублирующихся вариантов. | При отсутствии идентификатора проверьте область импорта, доступ к связке ключей и соответствие профиля; не публикуйте закрытый ключ или пароль. |
| Архивация и экспорт | Сохраните xcodebuild код выхода, путь к архиву и лог экспорта. |
Каталог архива существует; результат экспорта связан с идентификатором коммита и номером задачи. | Начните диагностику с первого error в логе; отдельно определяйте этап компиляции, подписи, архивации и экспорта, не описывайте весь сбой последней строкой. |
После смены сети не меняйте настройки изображения; после смены Xcode не меняйте коммит исходников. Только так можно корректно сравнить результаты.
Последующие ошибки часто являются цепной реакцией. Запишите самый ранний фрагмент ошибки, код выхода и соответствующую команду.
Удалите учётные данные хоста, токены, содержимое закрытых ключей и чувствительные пути проекта, сохранив время, номер задачи и версии инструментов.
Пользователи с заказом могут войти в консоль и создать обращение; если вход невозможен, напишите на support@oakvm.com. Не вставляйте данные подключения в публичные страницы.
Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг, восток или запад США.
Укажите дату, время и часовой пояс, чтобы сопоставить данные с логами узла.
Укажите идентифицируемый номер заказа, экземпляра или задачи CI.
Перечислите точку входа, команды и последний успешный шаг перед возникновением проблемы.
Опишите ожидаемый и фактический вывод отдельно, а не просто напишите «не работает».
Сохраните контекст ошибки, код выхода и версии; удалите учётные данные, токены и закрытые ключи.
Выберите OakVM M4 или OakVM M4 Pro и настройте срок аренды в одном из шести доступных регионов узлов. Все регионы стабильно работают 365 дней в году; фактическая доступность отображается в консоли в реальном времени.