Раздел инженерной поддержки
Здесь собраны решения проблем с подключением, системой, сборкой, сетью, хранилищем и аккаунтом на облачных Mac. Сначала выполните базовые проверки по порядку, затем укажите узел, время события и обезличенные логи — это обычно сокращает число уточнений.
Маршрутизация проблемы
Не меняйте несколько параметров одновременно. За один цикл корректируйте только способ подключения, настройки клиента, параметры сборки или сетевой маршрут и сохраняйте результаты до и после изменения.
Отклонены учётные данные, порт недоступен, изображение отображается некорректно, ввод задерживается или сеанс прерывается.
Проверить подключениеГрафический сеанс, права доступа, подключение диска, настройки времени или состояние процессов не соответствуют ожиданиям.
Проверить состояние системыRunner отключён, очередь заблокирована, кэш зависимостей недействителен, среда подписи или этап упаковки завершились ошибкой.
Проверить сборкуПотери пакетов, джиттер, сбои DNS, изменения маршрута или нестабильная пропускная способность.
Открыть рабочую область диагностикиПланирование ёмкости, обнаружение дополнительного SSD, очистка кэша, резервное копирование и миграция до окончания срока аренды.
Проверить хранилище и данныеНеобходимо проверить идентификатор заказа, учётные данные, записи о платежах, результат оплаты или действия в панели управления.
Подготовить запрос в поддержкуДиагностика удалённого подключения
Сначала убедитесь, что адрес подключения указан верно, затем проверьте порт и клиент. Не пытайтесь скрыть проблемы сети или сеанса многократным сбросом учётных данных.
Скопируйте из панели управления адрес хоста, порт и имя пользователя текущего экземпляра и убедитесь, что не используются данные старого заказа. Проверьте раскладку, регистр, пробелы в начале и конце, а также результат автозаполнения менеджера паролей. Не добавляйте пароль, приватный ключ или полную строку подключения на скриншоты и в текст тикета.
В локальном терминале используйте nc для проверки указанного порта. Успешное TCP-подключение означает только доступность порта, но не подтверждает работу графического сеанса; при тайм-ауте продолжайте фиксировать данные о локальной сети, операторе и целевом узле.
nc -vz "$TARGET_HOST" "$TARGET_PORT"Убедитесь, что экземпляр запущен, служба графического сеанса доступна, а текущая учётная запись имеет права на удалённый сеанс. Если командная строка подключается, но изображение не появляется, ограничьте поиск службой графики, согласованием клиента или оставшимся сеансом, не меняя сетевую конфигурацию.
Сначала установите базовый режим с одним монитором, меньшим разрешением и сниженным качеством изображения, затем поочерёдно верните масштаб, качество цвета и настройки нескольких дисплеев. Если низкое разрешение стабильно, а высокое вызывает задержки, одновременно соберите данные о задержке, потерях пакетов и кодировании клиента.
Корректно выйдите из клиента, дождитесь освобождения старого подключения и создайте сеанс заново. Не подключайте несколько клиентов к одному графическому сеансу. При повторном обрыве укажите точное время до минуты, версию клиента, смену сети и наличие одновременных проблем с подключением из командной строки.
Диагностика CI/CD
Сначала запустите минимальную задачу, которая не читает ключи проекта и не устанавливает зависимости. После её успешного выполнения поэтапно добавляйте репозиторий, кэш, материалы подписи и архивирование.
Проверьте, зарегистрирован ли Runner в нужном проекте или организации, совпадают ли метки и находится ли исполнитель в сети. Если задача долго стоит в очереди, сначала проверьте метки и ограничения параллельного выполнения, затем процесс Runner, а не перезапускайте весь конвейер.
ps aux | grep -i runner
launchctl list | grep -i runnerУбедитесь, что аккаунт процесса сборки, путь поиска связки ключей, видимость сертификатов и область действия профиля подготовки согласованы. В логах оставляйте только имя сертификата, этап истечения срока и текст ошибки; перед отправкой удалите пароли, содержимое приватных ключей и полные материалы подписи.
security list-keychains
security find-identity -v -p codesigningХраните кэш зависимостей, производные данные и готовые артефакты в разных каталогах. При сбоях попадания в кэш сначала зафиксируйте ключ кэша и занятое место, затем очистите данные только одного проекта, чтобы сохранить образец для сравнения.
du -sh "$CACHE_PATH"
df -h
find "$CACHE_PATH" -maxdepth 1 -type dЗафиксируйте время постановки в очередь, фактического запуска и завершения, различая случаи «задача не получена» и «задача запущена, но долго не выводит данные». В первом случае проверяйте метки, параллельность и состояние Runner, во втором — ожидание скрипта, сетевые зависимости и дочерние процессы.
Сохраните минимум по 50 строк до и после ошибочного шага, добавив код выхода команды, версии инструментов и минимальные параметры воспроизведения, которые можно раскрыть. Не отправляйте только скриншот окна ошибки и не загружайте полный архив логов с токенами, учётными данными репозитория или рабочими данными.
xcodebuild -version
sw_vers
uname -mПосле первой ошибки сохраните исходные логи и один раз повторите запуск с тем же коммитом и параметрами. При успехе сравните сетевые запросы, попадания в кэш и длительность выполнения; при стабильной ошибке сведите проверку к одной команде и запишите её входные данные, код выхода и продолжительность.
Рабочая область диагностики сети
Один ping не показывает качество канала. Соберите результаты во время проблемы и после восстановления, сохраняя одинаковые локальную сеть, адрес цели и параметры команды.
Отправьте 20 пакетов подряд и сохраните минимальное, среднее и максимальное значение, а также процент потерь.
ping -c 20 "$TARGET_HOST"Результат показывает, на каком переходе начинается изменение задержки. То, что некоторые маршрутизаторы не отвечают на проверку, не означает обрыв канала.
traceroute "$TARGET_HOST"Зафиксируйте результат разрешения, время ответа и используемый DNS-сервер, отделив проблему разрешения имени от проблемы целевого порта.
dig "$TARGET_HOST"
scutil --dnsСоберите встроенными средствами macOS данные о скорости передачи и приёма, отзывчивости и задержке в состоянии простоя. На время теста приостановите синхронизацию больших файлов и другие задачи с высокой нагрузкой на канал.
networkQuality -vРабота с хранилищем и данными
Проблемы хранилища обычно не сводятся к одному числу объёма. Границы каталогов, права записи, восстанавливаемые копии и сроки миграции нужно определить до первой сборки.
После добавления хранилища сначала проверьте, обнаружила ли система устройство, подключён ли том и доступна ли файловая система для записи, затем меняйте каталог сборки. Не переключайте пути кэша или артефактов во время выполнения задачи.
diskutil list
df -h
mountДоступность сервиса
Записи состояния помогают определить масштаб влияния на стороне сервиса. Конкретные окна измерений, исключения, условия обращения, сервисные компенсации и область применения определяются условиями сервиса.
Узлы работают штатно 365 дней в году. Влияние форс-мажора, действий пользователя, сети со стороны пользователя и настроек рабочей нагрузки не включается в показатель доступности платформы.
Если вы считаете, что на заказ повлияло событие на стороне платформы, сохраните идентификатор заказа, узел, время первого обнаружения, время восстановления и результаты непрерывных проверок и отправьте их через тикет в панели управления. Соответствие условиям сервисной компенсации и способ компенсации определяются правилами условий сервиса.
Посмотреть условия сервисаОтправить запрос в поддержку
Организуйте запрос в поддержку вокруг одной проблемы. Описывайте отдельно разные узлы, заказы и этапы сбоя, чтобы временные шкалы не смешивались.
Укажите идентификатор заказа или экземпляра из панели управления. Не отправляйте пароль от аккаунта.
Явно укажите Сингапур, Японию (Токио), Южную Корею (Сеул) или Гонконг.
Укажите дату, часовой пояс, время начала, продолжительность и факт восстановления.
Отдельно опишите, что должно было произойти и что произошло на самом деле, а не только напишите «не работает».
Перечислите кратчайшие шаги от нормального состояния до появления сбоя и укажите, стабильно ли он воспроизводится при повторе.
Приложите логи до и после ошибочного шага, коды выхода команд и необходимые скриншоты, удалив токены, пароли, приватные ключи, платёжные данные и рабочую информацию.
Сохраните код ошибки, время, название команды, версию инструмента, структуру пути и код выхода; замените токены доступа, пароли, приватные ключи, учётные данные в адресах репозиториев, настоящее имя пользователя и рабочие данные. После обезличивания ещё раз выполните поиск распространённых префиксов ключей и адресов электронной почты.
Как минимум приложите одну серию ping, один traceroute, время возникновения проблемы, целевой узел, локальный город и оператора, а также укажите, изменился ли результат после переключения на кабель, Wi‑Fi или мобильную точку доступа.
Обычно нет. Сначала предоставьте команду с ошибкой, код выхода, логи до и после, версии инструментов и минимальные шаги воспроизведения. Если образец необходим, удалите рабочий код, ключи, материалы подписи и производственные данные, оставив только минимальную структуру, воспроизводящую проблему.
Подготовить отправку
Проблемы по существующим заказам лучше отправлять через тикет в панели управления; по общим вопросам обращайтесь по электронной почте поддержки. Полный контекст позволяет инженерам сразу начать диагностику по пригодным для анализа данным.