Начните с проверки состояния

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

Для активации, подключения, входа в систему, сборки Xcode, заказа дополнительного хранилища, продления и освобождения MiniDebug облачного Mac. Сначала выполните локальные проверки на странице, затем отправьте через тикет в консоли контекст заказа и обезличенные журналы.

Область поддержки

Сначала определите уровень проблемы.

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

Заказ и состояние хоста

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

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

Диагностика адресов, портов, сетевых маршрутов и удалённых сессий для пяти узлов: Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг и восток США.

Вход в систему и права

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

Среда сборки

Ищите причину ошибок задач xcodebuild или fastlane по версии Xcode, инструментам командной строки, кэшу зависимостей, материалам подписи, месту на диске и журналам сборки.

Дополнительное хранилище

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

Продление и освобождение

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

Первое подключение

Проверьте первое подключение за пять шагов.

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

  1. 01

    Проверьте заказ и состояние хоста

    Войдите в консоль и откройте нужный заказ. Убедитесь, что модель — MiniDebug M4, конфигурация — M4, 16GB RAM, 256GB SSD, и запишите выбранный узел. Если хост ещё не готов к подключению, не повторяйте попытки входа.

    Ввод: идентификатор заказа
  2. 02

    Получите данные подключения для заказа

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

    Вывод: параметры подключения
  3. 03

    Выполните первый вход в систему

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

    Проверка: идентичность хоста
  4. 04

    Обновите учётные данные и права доступа

    Сразу после входа обновите первоначальные учётные данные; для автоматизации SSH предпочтительнее использовать ключи. В команде ограничьте круг авторизованных участников и не используйте одну учётную запись постоянно несколькими людьми и не записывайте пароли в открытом виде в скрипты.

    Действие: обновить учётные данные
  5. 05

    Проверьте сеть и базовую среду сборки

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

    Результат: базовая среда готова
Маршрутизация ошибок сборки

Начните с первой стабильно воспроизводимой ошибки.

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

Подпись кода

Сначала разделите этапы идентификации, цели и экспорта

  • Убедитесь, что цель сборки, Bundle Identifier и настройки подписи согласованы.
  • Проверьте, не произошёл ли сбой на этапе export после успешного archive.
  • Зафиксируйте первую ошибку подписи и по 20 строк журнала до и после неё.

Направление действий: Настройки подписи проекта проверяет пользователь; если материалы подписи недоступны для чтения, проверьте права файлов и путь автоматической инъекции.

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

Проверьте действительность, соответствие и права чтения

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

Направление действий: Сначала проверьте чтение в интерактивной сессии, затем воспроизведите автоматизированную задачу и сравните переменные среды и учётные записи выполнения.

Версия Xcode

Используйте одну цепочку инструментов в графическом интерфейсе и командной строке

  • Зафиксируйте версии Xcode и SDK, а также целевую платформу.
  • Выполните xcode-select -p для проверки текущего пути.
  • Проверьте, унаследовал ли процесс CI ожидаемый каталог разработчика.

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

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

Сначала проверьте lock-файл, затем решайте, нужно ли очищать кэш

  • Сохраните lock-файл зависимостей и зафиксируйте версию менеджера пакетов.
  • Сравните сборку в чистом каталоге со сборкой с использованием кэша.
  • Удаляйте только заново создаваемые каталоги; не удаляйте файлы проекта без резервной копии.

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

Место на диске

Проверяйте общий объём, свободное место и каталоги большого размера

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

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

Журналы сборки

Сохраняйте команду, время и первую ошибку

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

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

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

Проверяйте по порядку, не пропуская условия выше по цепочке.

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

  1. 01

    Состояние хоста

    Проверьте заказ и состояние хоста в консоли. Если состояние не соответствует ожиданиям, зафиксируйте идентификатор заказа и результат на странице, затем создайте тикет.

    После успешной проверки продолжить
  2. 02

    Адрес назначения

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

    Цель подтверждена
  3. 03

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

    Убедитесь, что SSH, VNC или общий доступ к экрану используют соответствующие порт и клиент. Отдельно фиксируйте тайм-аут, отказ в подключении и ошибку аутентификации.

    Зафиксировать тип ошибки
  4. 04

    Локальная сеть

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

    Сравнение сети завершено
  5. 05

    Правила брандмауэра

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

    Проверить исходящие правила
  6. 06

    Права учётной записи

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

    Результат аутентификации понятен
  7. 07

    Занятые сессии

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

    Сохранить результат повтора
Шаблон данных для тикета

Отправьте достаточно контекста для воспроизведения с одной попытки.

Тикет в консоли подходит для проблем с существующим заказом. Если войти в консоль невозможно, используйте единственный поддерживаемый адрес support@minidebug.com и предоставьте необходимые данные для проверки аккаунта.

Рекомендуемая структура тикета Скопируйте названия полей и заполните их по порядку
Идентификатор заказа
Идентификатор заказа из консоли; не отправляйте платёжные данные.
Узел
Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг или восток США.
Время возникновения
Укажите дату, время и часовой пояс, а также произошло ли это впервые или ошибка воспроизводится постоянно.
Шаги воспроизведения
Начните с открытия консоли, выполнения команды или запуска клиента и пронумеруйте шаги в фактическом порядке.
Обезличенный журнал
Включите первую ошибку и контекст, удалив пароли, токены, закрытые ключи и конфиденциальные данные проекта.
Ожидаемый и фактический результат
Отдельно опишите ожидаемый результат, фактический результат и стабильность воспроизведения.
Существующий заказ

Используйте тикет в консоли

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

Создать тикет в консоли
Вход невозможен

Отправить письмо в поддержку

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

support@minidebug.com
Границы ответственности

Категория проблемы определяет дальнейшие действия.

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

Обрабатывает MiniDebug

Проблема инфраструктуры узла

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

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

Проблемы использования macOS

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

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

Код проекта и конфигурация сборки

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

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

Проблемы сторонних сервисов

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

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

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

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

Удалённый доступ

Сравните SSH, VNC и общий доступ к экрану macOS; диагностируйте подключение по задержке, пропускной способности и состоянию сессии.

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

Частые вопросы

Проверьте форм-фактор, срок аренды, узел, дополнительные опции, способы оплаты, инструменты сборки и границы обработки данных.

Получить краткие ответы

Безопасность и надёжность

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

Прочитать о безопасности

Тарифы и цены

Посмотрите фиксированную конфигурацию MiniDebug M4, четыре срока аренды, дополнительные опции хранилища, объединение через Thunderbolt 5 и матрицу узлов.

Проверить конфигурацию заказа

Контакты и маршрутизация

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

Подготовить контактные данные

Подготовьте контекст заказа и переходите к следующему шагу.

Новые покупки, продление и управление хостом выполняются через консоль; вопросы по существующим заказам направляйте прежде всего через тикет в консоли. Оплата поддерживается только через USDT-TRC20 и Visa / Mastercard / Amex (через Stripe); все заказы оплачиваются в долларах США (USD), а доступный шлюз определяется ответом серверного API.