Начните диагностику с проверки фактов

Разделите проблемы поставки, подключения и сборки на выполнимые шаги

Сначала проверьте физический узел, конфигурацию, срок аренды и учётные данные, затем — сеть, среду разработки и журналы задач. Для каждого шага указаны входные данные, проверки и критерии готовности — для первого запуска, повседневных сборок и диагностики.

Если нужны сведения о подключении, сначала ознакомьтесь спроцедурой удалённого доступа; по существующему заказу укажите в тикете номер заказа и код узла.

Предполётный чек-лист задачи BUILD SUPPORT / 04
Порядок диагностики готов
Входные данные Проверка Восстановление
Машина и узел Сопоставьте конфигурацию, регион и срок аренды с заказом
Сначала проверьте
Учётная запись и сессия Храните адрес, системную учётную запись и одноразовые данные доступа отдельно
Затем подключитесь
Инструменты и runner Версии, метки, параллельность, кэш и очистка после выхода
После этого запускайте
Временная шкала и журналы Используйте единый часовой пояс и сохраните ключевые записи до и после сбоя
Для диагностики
Критерии готовности Сбой воспроизводится, границы проблемы понятны, журналы обезличены
Шесть направлений

Выберите путь проверки по этапу, на котором возникла проблема

Не начинайте с переустановки среды. Сначала определите, связана ли проблема с поставкой, подключением, инструментами, запуском задачи, чтением и записью данных или расчётами — это значительно сокращает ненужные изменения.

01

Первая поставка

Проверьте узел, конфигурацию машины, системную учётную запись, данные доступа, начало и конец аренды, а также параметры безопасности.

Критерий готовности: фактические данные заказа и машины совпадают
02

Удалённое подключение

По очереди проверьте доступность адреса, правила портов, состояние учётной записи, сетевые задержки, раскладку клавиатуры и восстановление сессии.

Критерий готовности: стабильное повторное подключение и ввод данных
03

Среда разработки

Зафиксируйте Xcode, инструменты командной строки, сертификаты, профили, кэш зависимостей и права каталога проекта.

Критерий готовности: локальная и удалённая базовые конфигурации сопоставимы
04

CI/CD

Проверьте регистрацию runner, маршрутизацию по меткам, лимит параллельных задач, каталог кэша, внедрение ключей и очистку после задачи.

Критерий готовности: задачи воспроизводимы и не смешивают среды
05

Хранилище

Разделяйте системный диск, каталог проекта, кэш сборки и командное хранилище; сначала проверьте место, права и состояние синхронизации.

Критерий готовности: пути данных и ответственность за перенос определены
06

Счета

Сверьте модель, срок аренды, узел, дополнительные SSD и количество параллельных Thunderbolt 5, затем проверьте соответствующие позиции счёта.

Критерий готовности: каждая сумма прослеживается до конфигурации
Шесть проверок до поставки

До первого входа сохраните базовую конфигурацию поставки

Базовая конфигурация помогает понять, вызваны ли последующие изменения заказом, системными настройками или инструментами проекта. Записывайте только необходимые сведения; не помещайте пароли, закрытые ключи и полные токены в командную документацию.

Узел

Проверьте регион и точку подключения

Сверьте коды узлов SG, JP, KR или HK в заказе и запишите адрес поставки. Узел влияет на маршрут доступа, но сетевые проблемы не следует маскировать изменением зависимостей проекта.

Точка проверки
Узел в заказе совпадает с узлом поставки
Что записать
Код узла, сеть, из которой выполняется проверка
Конфигурация

Проверьте чип, память и диск

В системной информации подтвердите соответствующие заказу M4 или M4 Pro, объём памяти и системного диска. Внешнее или дополнительное хранилище фиксируйте отдельно вместе с точкой подключения.

Точка проверки
Все поля конфигурации совпадают с заказом
Что записать
Чип, RAM, SSD
Системная учётная запись

Разделяйте административную и рабочую учётные записи

Убедитесь, что исходная системная учётная запись выполняет вход, затем создайте для автоматизации учётную запись с минимальными правами. Не используйте для постоянной работы runner ненужные повышенные права.

Точка проверки
Учётная запись входит в систему и имеет подходящие права
Что записать
Роль учётной записи; пароль не записывать
Данные доступа

После первого использования обновите одноразовые данные доступа

Храните удалённый адрес, имя системного пользователя и данные сессии отдельно. После обновления выйдите и подключитесь заново, чтобы убедиться, что новые данные работают ожидаемым способом.

Точка проверки
Старые данные недействительны, с новыми можно подключиться
Что записать
Время изменения и исполнитель
Срок аренды

Согласуйте начало, конец и часовой пояс команды

Внесите начало и конец аренды в календарь проекта и укажите часовой пояс. Для длительных задач заранее оставьте время на сохранение контрольной точки, синхронизацию результатов и очистку среды.

Точка проверки
Все участники видят одно и то же время
Что записать
Начало и конец, часовой пояс, ответственный
Параметры безопасности

Сначала ограничьте точки входа, затем устанавливайте инструменты

Проверьте общие учётные записи, диапазон удалённого доступа, права каталогов и место хранения ключей. Скрипты установки должны быть проверяемыми, а конфиденциальные переменные следует внедрять только во время выполнения задачи.

Точка проверки
Минимальные права и границы доступа определены
Что записать
Разрешённые источники, каталоги и ответственность за ротацию
Ключевые термины

Сначала согласуйте восемь терминов — меньше двусмысленности в коммуникации

Эти термины описывают принадлежность ресурсов, способ подключения и среду сборки. В обращении используйте соответствующие названия, чтобы поддержка сразу определила уровень проблемы.

Физический узел
Фактическое устройство и регион, на которых размещён облачный Mac. SoarMac предоставляет физическую машину Apple Silicon на выделенном узле, а не абстрактный общий вычислительный экземпляр.
Выделенный
В течение срока аренды ресурсы машины использует один заказ, системная среда не разделяется с другими заказами. Команда самостоятельно планирует учётные записи, каталоги и права задач.
Не виртуальная машина
Система работает непосредственно на соответствующей физической машине. При диагностике производительности или возможностей устройства сначала смотрите реальную конфигурацию, текущие задачи и состояние хранилища, а не параметры виртуальной машины.
VNC
Способ удалённого доступа к графическому интерфейсу macOS. Подходит для работы с интерфейсом и визуальной проверки, но не заменяет синхронизацию файлов и журналы автоматизированных задач.
self-hosted runner
Исполнитель задач, зарегистрированный на платформе CI/CD команды и фактически работающий на облачном Mac. Для него нужно определить метки, лимиты параллельности, рабочий каталог и правила очистки после выхода.
Кэш сборки
Зависимости или промежуточные результаты, сохраняемые для сокращения повторных загрузок и компиляции. Кэш должен иметь понятный ключ, ограничение объёма и условия недействительности; не смешивайте его с исходными файлами проекта.
Среда подписи
Набор версий инструментов, сертификатов, профилей, прав и переменных задач, необходимых для проверки подписи. Фиксируйте источник и ответственность за ротацию, не выводите конфиденциальные данные в обычные журналы.
Данные сессии
Адрес, имя пользователя и временные данные аутентификации для удалённой сессии. Это не то же самое, что ключи проекта или токены репозитория: храните и ротируйте их отдельно.
Подключение CI/CD

Сделайте выполнение runner воспроизводимым, а не одноразово успешным

Порядок подключения должен быть фиксированным: регистрация, маршрутизация, ограничение нагрузки, кэш, ключи и очистка. После каждого изменения Xcode, зависимостей или материалов подписи повторяйте проверку одним и тем же минимальным конвейером.

01

Зарегистрируйте runner

Создайте исполнитель предусмотренным для проекта или организации способом, запишите имя runner, область действия и способ запуска службы. Затем выполните диагностическую задачу без конфиденциальных переменных.

02

Спланируйте метки

Метки должны отражать систему, семейство чипа, базовую версию Xcode и назначение — например, сборку, тестирование или обработку медиа. Не позволяйте общей метке направлять ресурсоёмкие задачи в лёгкую очередь.

03

Ограничьте параллельность

Начните с одной задачи: проверьте CPU, память, запись на диск и каталог производных данных, затем постепенно увеличивайте параллельность. При задержках сохраните длину очереди и временную шкалу задачи, а не только итоговый код ошибки.

04

Разделите каталоги кэша

Храните кэш зависимостей, промежуточные результаты сборки и экспортированные файлы раздельно. Задайте предел объёма, правила ключей и условия очистки, чтобы старые артефакты архитектуры или инструментов не использовались повторно.

05

Внедрите ключи

Конфиденциальные переменные должны попадать в окружение только во время выполнения задачи; отключите отображение команд в журналах и ограничьте задачи, которым разрешено их читать. При ошибке проверяйте наличие переменной, не выводя её значение.

06

Очистите среду после задачи

При выходе удалите временные файлы, отключите временные подключения, завершите оставшиеся процессы и очистите краткосрочные данные доступа. Очистка должна выполняться даже после ошибки предыдущего шага; сохраняйте проверяемый код результата.

Минимальная проверочная задача Версии инструментов → получение зависимостей → компиляция → тесты → экспорт сводки
Сохранять Метки runner, идентификатор коммита, время задачи, код выхода, обезличенный журнал
Не включать в журнал Пароли, закрытые ключи, полные токены, исходные материалы подписи
Базовая среда разработки

Сначала зафиксируйте версии, затем определяйте: различие среды или проблема проекта

Ошибка удалённой сборки не означает неисправность машины. Проверяйте отдельно версии инструментов, разрешение зависимостей, права каталогов и материалы подписи, чтобы найти изменившийся уровень.

Проверка версии Xcode

Запишите полную версию, номер сборки и текущий выбранный путь. В конвейере явно выбирайте версию, чтобы графический интерфейс и командная строка не использовали разные наборы инструментов.

Инструменты командной строки

Проверьте фактические пути компилятора, менеджера пакетов и интерпретатора скриптов. Не судите о версии только по окну установки; журнал задачи должен выводить безопасную сводку версий.

Сертификаты и профили

Проверьте область действия, назначение и права чтения. В журнале фиксируйте только идентификатор и результат проверки, не выводите закрытые данные сертификата; после ротации выполните минимальную проверку подписи.

Кэш зависимостей

Ключ кэша должен включать lock-файл зависимостей, версию инструментов и архитектуру. При необъяснимых различиях сборки проверьте работу с пустым кэшем, а не удаляйте все данные проекта.

Права каталога проекта

Убедитесь, что runner имеет необходимые права на исходный код, кэш и каталог экспорта. Не решайте проблему одного каталога глобальным ослаблением прав; фиксируйте изменения владельца.

Пути хранения

Разделяйте систему, проект, кэш и файлы поставки

Проблемы с диском обычно вызваны смешением путей, неограниченным кэшем, изменением прав или незавершённой синхронизацией. Сначала определите уровень данных, затем решайте, очищать, расширять или переносить их.

Системный диск

Сохраняйте запас свободного места

Постоянно следите за свободным местом, чтобы промежуточные результаты сборки не вытесняли объём, нужный системе. Системный каталог не предназначен для командного хранилища артефактов.

Каталог проекта

Определите владельца

Исходный код и конфигурацию обслуживает выделенная учётная запись задачи. После переноса каталога заново проверьте права, символические ссылки и абсолютные пути в скриптах.

Кэш сборки

Задайте условия недействительности

Разделяйте кэш по проекту, архитектуре и версии инструментов; задайте правила очистки по объёму и сроку хранения, чтобы старые артефакты не влияли на новые задачи.

Файлы поставки

Очищайте после синхронизации

Перед синхронизацией в командное хранилище проверьте целостность экспортированных артефактов. До окончания аренды выполните перенос и сохраните записи передачи.

Порядок диагностики подключения

Меняйте только одно условие за раз и записывайте результат

Сначала проверьте локальную сеть и адрес назначения, затем переходите к аутентификации и сессии. Изображение, клавиатура и буфер обмена относятся к работе сессии и не должны смешиваться с недоступностью адреса.

Порядок проверки типичных проблем удалённого подключения и доказательства для тикета
Симптом Первый шаг Второй шаг Сохранить, если не восстановилось
Не удаётся установить сессию Проверьте узел, адрес и доступность локальной сети; исключите блокировку корпоративными правилами. Повторите проверку из заведомо рабочей сети, не меняя одновременно учётную запись и параметры подключения. Узел, время, сеть-источник, полный текст ошибки и результаты последовательных тестов.
Задержка изображения Снизьте разрешение и качество цвета, приостановите локальную загрузку больших объёмов данных. Сравните задержку и джиттер в разных сетях и проверьте, сохраняется ли проблема. Узел, разрешение, тип сети, образцы задержки и период проблемы.
Неправильная раскладка клавиатуры Проверьте локальный метод ввода, раскладку клавиатуры сессии и региональные настройки системы. Проверьте модификаторы, символьные клавиши и сочетания клавиш в текстовом редакторе без форматирования. Локальная система, раскладка, проблемные клавиши и шаги воспроизведения.
Буфер обмена не синхронизируется Убедитесь, что инструмент сессии разрешает передачу буфера обмена, и протестируйте короткий обычный текст. Создайте сессию заново и повторите тест; сначала не копируйте большие файлы или форматированный текст. Инструмент сессии, тип содержимого, направление и минимальный воспроизводимый текст.
Не удаётся подключиться повторно Полностью завершите старую сессию, дождитесь освобождения подключения и повторите попытку с исходным адресом. Проверьте действительность системной учётной записи; не запускайте подключения подряд слишком быстро. Причина отключения, интервал повторов, полный текст ошибки и время последнего успешного подключения.
Данные доступа недействительны Убедитесь, что используются актуальные имя системного пользователя и данные сессии, без старых записей. Ответственный с нужными правами должен проверить последние изменения и время ротации. Номер заказа, узел, имя пользователя, время сбоя; пароль не прикладывать.
Передача большого файла прерывается Используйте проверяемый процесс синхронизации с поддержкой продолжения, а не буфер обмена. Сравните размер исходного и целевого файла и результаты проверки. Размер, направление передачи, время начала, этап сбоя и сводка проверки.
Целевой показатель сервиса

99.9% Целевой показатель доступности — проверяйте по журналу событий

Все узлы работают 365 дней в году. При инциденте временная шкала в консоли фиксирует начало, масштаб влияния, восстановление и окончание; право на компенсацию и порядок расчёта определяются условиями сервиса.

Последние 90 дней Три 30-дневных окна проверки
Фактические данные берутся из временной шкалы
D−90 — D−61

Ежедневный статус, время начала инцидента и масштаб влияния

D−60 — D−31

Действия по восстановлению, обновления этапов и охваченные узлы

D−30 — D−1

Время окончания, длительность и последующие сведения

Основание расчёта
Записи затронутого сервиса и временная шкала заказа
Способ подачи
Тикет в консоли
Материалы
Номер заказа, узел, время и описание влияния
Проверка счёта

Сверяйте каждую позицию конфигурации, не выводите её из общей суммы

Стоимость заказа складывается из уровня машины, срока аренды, узла, дополнительного SSD и количества параллельных Thunderbolt 5. После изменения срока или дополнительных опций заново проверьте сводку заказа.

A

Машина и срок аренды

Сначала проверьте SoarMac M4 Air, SoarMac M4 Plus или SoarMac M4 Pro, затем — дневной, недельный, месячный или квартальный период.

B

Узел и дополнительные опции

Проверьте узлы SG, JP, KR или HK, а также +1TB SSD, +2TB SSD и количество параллельных подключений Thunderbolt 5.

C

Расчётные данные

Все цены рассчитываются в USD; доступны только USDT-TRC20 и Visa / Mastercard / Amex (через Stripe). Фактически доступный платёжный шлюз определяется ответом системы.

Подготовка перед отправкой

Сделайте тикет диагностируемым уже с первого ответа

Сообщение «не работает» приводит лишь к запросу дополнительных сведений. Предоставьте факты в указанном порядке и удалите из журналов пароли, закрытые ключи, полные токены и материалы подписи.

01
Номер заказа

Нужен для связи модели, срока аренды и данных поставки; платёжные данные не прикладывайте.

02
Узел

Укажите SG, JP, KR или HK и примерный регион сети, из которой выполнялось подключение.

03
Время возникновения

Используйте время с часовым поясом и укажите первое появление, последнее воспроизведение и последний момент нормальной работы.

04
Шаги воспроизведения

Пошагово опишите ввод, действия, ожидаемый и фактический результат, начиная с исходного состояния.

05
Обезличенный журнал

Сохраните исходный текст ошибки, код выхода и контекст до и после неё; удалите пароли, закрытые ключи, полные токены и персональные данные.

Технический вопрос

В первую очередь создайте тикет в консоли

Существующие заказы, ошибки подключения, проверки конфигурации и сервисные события можно связать с записью заказа и дополнять временной шкалой в консоли.

Открыть консоль
Предпродажная консультация и помощь специалиста

Соберите контекст на странице контактов

Для подбора решения, массового развёртывания, оценки рабочего процесса или вопросов без привязанного заказа используйте support@soarmac.com либо подготовьте сведения по инструкциям на странице контактов.

Открыть страницу контактов

Подготовьте задачу и выберите подходящий физический узел

Три тарифа с выделенными физическими машинами Apple Silicon работают без виртуализации на узлах в Сингапуре, Токио, Сеуле и Гонконге. Перед заказом проверьте нагрузку, память, хранилище, срок аренды и путь подключения.