Здесь собраны решения для подключений к выделенным физическим Mac-узлам, сборок Xcode, CI/CD runner, хранилища, сети узлов и биллинга. Сначала выполните базовые проверки по порядку; если это не поможет, отправьте заказ, параметры окружения и обезличенные логи, чтобы сократить число уточнений.
Не меняйте одновременно сеть, версию системы и параметры сборки. Изменяйте только одну переменную за раз и сохраняйте исходный текст ошибки и время — так можно определить, относится ли проблема к подключению, окружению или проекту.
Сначала проверьте адрес узла, порт, имя пользователя и учётные данные, затем — ограничения локальной сети, параметры шифрования клиента и состояние сеанса. Не повторяйте попытки со старыми учётными данными.
Открыть шаги проверки подключенияЗафиксируйте этап сбоя, затем проверьте свободное место, версии Xcode и SDK, lock-файл зависимостей, материалы подписи и полный лог сборки. В первую очередь сохраните первую фактическую ошибку.
Посмотреть порядок диагностики сборкиПроверьте процесс службы runner, статус регистрации, соответствие тегов, права рабочей директории и предел параллелизма. Статус «онлайн» на платформе не гарантирует, что теги текущей задачи будут найдены.
Проверить конфигурацию runnerРазделите использование места исходниками, кэшем зависимостей, DerivedData, архивами и артефактами доставки. Сначала экспортируйте нужные файлы, затем очищайте каталоги; не удаляйте данные, назначение которых не подтверждено.
Частые вопросы о хранилищеСначала зафиксируйте текущий узел, регион размещения репозитория, расположение основных исполнителей и направление передачи больших файлов, затем оценивайте миграцию. До миграции подготовьте отдельные копии кода и артефактов сборки.
Сравнить узлы и сетьПодготовьте номер заказа, выбранную конфигурацию, расчётный период, способ оплаты и статус в консоли. Отправляйте только идентификатор транзакции — не пересылайте полные данные карты или приватные ключи.
Отправить обращение по биллингу через консольПри первом входе сначала выполните проверки подключения и безопасности, затем настройте среду разработки. Это позволит отделить проблемы системы от проблем зависимостей проекта и упростит последующее воспроизведение.
Проверьте узел, соответствующий заказу, адрес сервера, порт, имя пользователя и временные учётные данные. Данные подключения предназначены только для авторизованных участников и не должны пересылаться в чатах или общедоступных документах.
Критерий готовности: сеанс стабильно устанавливается, и вы подтвердили подключение к узлу, соответствующему заказу.После первого входа замените временные учётные данные, создайте системные учётные записи в соответствии с политикой доступа команды и предоставьте права администратора только участникам, которым нужно устанавливать инструменты или изменять службы.
Критерий готовности: временные учётные данные больше не используются, а назначения обычной и административной учётных записей разделены.Запишите версию macOS, чип, доступное место на диске, версию Xcode, путь к инструментам командной строки и целевой SDK. Команда должна добавить эти данные в собственное руководство по сборке и эксплуатации.
Критерий готовности: различия между локальной и облачной сборкой объясняются одним и тем же набором версий.Установите зависимости по lock-файлу проекта, задайте отдельный каталог кэша, затем зарегистрируйте self-hosted runner. Для первой задачи используйте низкий параллелизм и проверьте подпись, архивацию и путь загрузки.
Критерий готовности: минимальная задача сборки выполняется повторно и оставляет полный лог.Сначала получите коммит, для которого точно известна успешная сборка, и запустите только установку зависимостей, компиляцию и архивацию. После успеха добавьте параллельные задачи, восстановление кэша и этапы доставки.
Подготовка к проверке подключенияПроблемы сборки обычно затрагивают шесть уровней: место, подпись, версии, зависимости, логи и параллелизм. После каждого уровня повторно запускайте тот же коммит и фиксируйте изменения результата.
Отдельно проверьте свободное место на системном томе, DerivedData, кэше зависимостей, каталоге архивов и экспортированных артефактах. При нехватке места сначала сохраните нужные артефакты, затем очистите каталоги.
Убедитесь, что выбранная проектом команда, действующий сертификат, профиль подготовки и Bundle Identifier согласованы. Не прикладывайте приватный ключ подписи к логам или обращениям.
Зафиксируйте путь к Xcode, фактически выполняющему сборку, убедитесь, что инструменты командной строки не указывают на другую версию, и проверьте наличие целевого SDK, требуемого проектом.
Сопоставьте кэш с lock-файлом и проверьте, не устарел ли он. Сначала выполните чистую сборку без восстановления кэша; если она успешна, восстанавливайте кэш зависимостей по одному, чтобы найти источник расхождения.
Сохраните выполняемую команду, код выхода и первую фактическую ошибку. Последний экран часто скрывает начальный сбой — приложите обезличенный лог от запуска задачи до завершения.
Снизьте параллелизм до одной задачи и наблюдайте за использованием памяти, диска и сети. Если одна задача успешна, а параллельные завершаются с ошибкой, постепенно увеличивайте параллелизм, чтобы найти стабильный предел.
Если после проверки всех шести уровней причина не найдена, отправьте идентификатор неудачного коммита, команду, версии окружения, код выхода и обезличенный лог.
Отправить обращение по проблеме сборкиВыделенный физический узел подходит для self-hosted runner, однако стабильная работа требует чёткой стратегии регистрации, тегов, управления службой, границ кэша и контроля доступа.
Используйте уникальное имя runner для каждого узла и запишите репозиторий или организацию, область регистрации, рабочую директорию и сервисную учётную запись. При миграции узла сначала отмените старую регистрацию.
Теги должны описывать стабильные характеристики: архитектуру чипа, основную версию Xcode, регион узла и назначение. Не перегружайте их временными названиями проектов, которые сложно поддерживать.
Запускайте runner как управляемую службу и фиксируйте способ запуска и расположение логов. После перезагрузки системы проверьте автоматическое восстановление службы и выполните минимальную задачу.
Храните зависимости, DerivedData и архивы в отдельных каталогах и задайте порог очистки. Кэш ускоряет работу, но не должен быть единственной копией проекта или постоянным хранилищем артефактов доставки.
Обычной учётной записи сборки предоставляйте только права на необходимые каталоги и команды. Права администратора используйте для установки инструментов, изменения системной конфигурации и управления службами.
Процесс службы → действительность регистрации → соответствие тегов → права рабочей директории → внешнее подключение → очередь задач платформы.
Единообразные термины в обращении помогают не смешивать физический узел, удалённый сеанс, runner и кэш сборки в одну неисправность.
VMArm предлагает 5 регионов узлов: Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг и запад США. Сравнивайте удалённую работу, получение репозитория, загрузку зависимостей и передачу артефактов.
Подходит командам Юго-Восточной Азии и цепочкам репозиториев и доставки, ориентированным на этот регион.
Подходит командам Японии и Восточной Азии, позволяя совместить работу с удалённым рабочим столом и доступ к региональным ресурсам сборки.
Подходит разработчикам, зеркалам зависимостей и процессам доставки в Южной Корее и Северо-Восточной Азии.
Подходит командам Южного Китая и Юго-Восточной Азии; перед выбором одновременно проверьте цепочки репозитория и удалённого сеанса.
Подходит командам западного побережья Северной Америки и проектам, чьи репозитории, источники зависимостей или системы доставки расположены в Северной Америке.
| Объект проверки | Как измерять | Что фиксировать | На что обратить внимание |
|---|---|---|---|
| Удалённый сеанс | Проверяйте подключение и взаимодействие в рабочее и непиковое время | Локальная сеть, узел, версия клиента, время возникновения | Постоянная проблема или колебания в определённые часы |
| Репозиторий кода | Одним репозиторием и коммитом проверьте клонирование, получение изменений и подмодули | Регион репозитория, длительность, неудачная команда, код выхода | Медленно устанавливается соединение или передаются большие файлы |
| Загрузка зависимостей | Один раз выполните полный разбор зависимостей с отключённым кэшем | Источник зависимостей, версия менеджера пакетов, проблемный пакет и число повторов | Сбой одного источника зависимостей или общей пропускной способности |
| Загрузка артефактов | Сравните передачу обезличенных тестовых файлов одинакового размера | Размер файла, целевой регион, время начала и окончания | Влияние исходящего канала, целевого сервиса или размера файла |
Цель обращения — не доказать наличие проблемы, а помочь специалисту определить тот же заказ, узел, момент времени и этап сбоя.
Нужен для подтверждения конфигурации, расчётного периода и данных поставки.
Укажите Сингапур, Японию (Токио), Южную Корею (Сеул), Гонконг или запад США.
Укажите время с часовым поясом и сообщите, воспроизводится ли проблема.
Укажите полную версию macOS, а не только название основной версии.
Также укажите версию и путь, на которые фактически указывают инструменты командной строки.
Начните с нормального состояния и последовательно опишите фактические клики или команды.
Сохраните контекст ошибки и код выхода, удалив токены, приватные ключи и другие конфиденциальные данные.
После входа выберите нужный заказ и отправьте проблему. Контекст заказа и узла будет полным — это подходит для проблем подключения, сборки, миграции и биллинга.
Перейти в консольЕсли заказ ещё не оформлен, укажите назначение, целевую конфигурацию, число параллельных сборок, предпочтительный регион и предполагаемое время запуска.
Посмотреть каналы связиПеред отправкой удалите токены доступа, приватные ключи подписи, полные платёжные данные и другую конфиденциальную информацию. Чтобы узнать о способах обработки данных, ознакомьтесь с политикой конфиденциальности.
Порядок ответа зависит от масштаба влияния и воспроизводимости. Поддержка отвечает за поставку узла, подключение, окружение и вопросы заказа; бизнес-логику проекта должен подтверждать владелец проекта.
Определите масштаб влияния по невозможности подключения, полной блокировке сборки, сбою части задач или общему вопросу и проверьте наличие рабочего обходного пути.
Подтвердите получение номера заказа, узла, времени, окружения и логов; при нехватке данных будет явно указан список полей для дополнения.
Укажите текущий проверяемый уровень, исключённые причины, следующее действие и тест, который должен выполнить пользователь, чтобы не повторять шаги без новой информации.
Обращение переходит к закрытию после восстановления работы и описания причины и способа обхода либо после подтверждения, что проблема связана с конфигурацией проекта, с указанием выполнимых направлений проверки.
Выберите VMArm M4 Core или VMArm M4 Plus и регион узла: Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг или запад США. Фактическая доступность определяется актуальным ответом консоли.