Подключение и сборка

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

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

Арендовать Mac mini Руководство по подключению
Доступные узлы
6 регионов
Доступные конфигурации
2 физических модели
Что подготовить
Регион, время, текст ошибки
МАРШРУТИЗАЦИЯ / BAMINI

Регистрация проблемы

Можно отправить
01 / КОНТЕКСТ Заказ и узел Проверьте модель, регион и состояние текущего узла
02 / ДОСТУП Подключение и данные доступа Проверьте адрес, имя аккаунта и версию клиента
03 / ДОКАЗАТЕЛЬСТВА Журналы и время Сохраните полный текст ошибки и время сбоя
04 / МАРШРУТ Самопроверка или тикет Воспроизводимые проблемы передавайте через тикет в консоли
Не отправляйте пароль аккаунта, коды восстановления или закрытые ключи СТАТУС / ГОТОВО
Выберите проблему

Сначала выберите наиболее подходящий тип проблемы

Все шесть вариантов доступны одновременно. Выбор варианта ведёт к нужной проверке, но не скрывает остальные руководства.

Подключение

Не удаётся установить сеанс рабочего стола

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

Проверить подключение Данные доступа

Данные подключения не работают

Убедитесь, что адрес, имя аккаунта и данные доступа относятся к одному заказу; удалите лишние пробелы при копировании.

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

Изображение, ввод или задача работают медленно

Отдельно зафиксируйте задержку сети, настройки качества рабочего стола и ресурсы задачи — не объединяйте их в один вывод.

Порядок наблюдений Заказ

Нужно проверить заказ или счёт

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

Процесс поддержки Хранилище

Дополнительное хранилище работает не так, как ожидалось

Запишите выбранную опцию, результат распознавания системой, путь монтирования и время первого сбоя.

Подготовить данные запроса Сборка

Задача Xcode или runner завершилась ошибкой

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

Проверить сборку
Первый запуск

От доступности узла до проверки рабочего стола

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

Проверить состояние узла

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

  • Номер заказа указан верно
  • Модель и регион совпадают
  • Узел доступен

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

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

  • В адресе нет лишних пробелов
  • Имя аккаунта хранится отдельно
  • Данные относятся к текущему заказу

Установить VNC-сеанс

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

  • Версия клиента поддерживается
  • Локальная сеть разрешает подключение
  • Текст ошибки сохранён полностью

Завершить первую проверку рабочего стола

Открыв графический интерфейс macOS, проверьте клавиатурный ввод, масштабирование, запуск терминала и доступ к каталогу проекта, затем синхронизируйте проект или запустите runner.

  • Ввод и изображение работают нормально
  • Команды терминала выполняются
  • Каталог проекта доступен для чтения и записи
Порядок диагностики подключения

Проверяйте условия подключения по одному слою

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

Таблица пошаговой проверки VNC-подключения
Порядок Что проверять Действие Что записать Критерий успеха
01 Локальная сеть Переключитесь на заведомо стабильную сеть и убедитесь, что брандмауэр или прокси не блокирует VNC-подключение. Тип сети, используется ли прокси, время сбоя Адрес назначения доступен из той же сети
02 Адрес назначения Заново скопируйте адрес сервера из текущего заказа; не используйте старый снимок экрана или адрес другого заказа. Номер заказа, регион узла, источник адреса Адрес совпадает с записью текущего узла
03 Данные подключения Отдельно проверьте имя аккаунта и данные доступа; убедитесь, что до и после скопированного текста нет пробелов или переводов строки. Текст ошибки, без отправки фактического пароля Клиент больше не возвращает ошибку аутентификации
04 Версия клиента Запишите название и версию клиента, а также настройки отображения; при необходимости проверьте результат в другом проверенном клиенте. Версия клиента, версия ОС, настройки качества Стабильный сеанс устанавливается с теми же данными
05 Состояние сеанса Проверьте, не занят ли сеанс, не зависло ли изображение и не хранит ли клиент неработающее подключение. Действия до отключения, результат переподключения, время сеанса После закрытия старого сеанса можно подключиться снова
Фиксируйте проблемы производительности раздельно

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

Диагностика сборки

Отделите конфигурацию проекта от среды узла

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

СБОРКА / ВЕРСИЯ

Версии Xcode и инструментов

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

Ключевой вопрос Можно ли воспроизвести сбой того же проекта на фиксированной версии.
СБОРКА / ЖУРНАЛ

Полный журнал проекта

Сохраните контекст до и после шага сбоя, а не только последнюю строку ошибки.

Ключевой вопрос Возникает ли ошибка на этапе зависимостей, компиляции, тестирования, экспорта или скрипта.
СБОРКА / ВРЕМЯ

Время сбоя

Запишите часовой пояс, время начала, время сбоя и длительность задачи, чтобы сопоставить их с данными узла.

Ключевой вопрос Возникает ли проблема на определённом шаге или после фиксированной длительности.
RUNNER / МЕТКА

Метка и каталог Runner

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

Ключевой вопрос Направлена ли задача на правильный self-hosted runner.
ВОСПРОИЗВЕДЕНИЕ / ШАГИ

Минимальные шаги воспроизведения

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

Ключевой вопрос Зависит ли сбой от конфигурации проекта, кэша или переменных среды.
СРАВНЕНИЕ / РЕЗУЛЬТАТ

Сравнительный результат

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

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

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

Признаки среды узла

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

Краткий словарь терминов

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

Точные термины уменьшают число уточнений из-за смешения понятий «машина», «экземпляр» и «сервер».

Физический узел
Физический Mac mini, на котором работают macOS и задачи разработки. Состояние узла, регион и данные подключения связаны с конкретным заказом.
Выделенная физическая машина
Один заказ соответствует отдельному физическому ресурсу, не разделяющему одну среду операционной системы с другими клиентами.
Не виртуальная машина
Предоставляется среда macOS на физическом оборудовании, а не виртуальный экземпляр, выделенный на общем хосте.
VNC
Способ подключения для просмотра и управления удалённым графическим рабочим столом. Качество изображения, масштабирование и задержка ввода зависят от локальной сети и настроек клиента.
Self-hosted runner
Исполнитель автоматизированных задач, развёрнутый на арендованном облачном Mac и самостоятельно зарегистрированный и обслуживаемый командой.
Расчётный период
Выбранный для заказа период на день, неделю, месяц или квартал. При проверке счёта также указывайте модель, период и дополнительные опции.
Регион узла
Регион размещения устройства. BAMini предоставляет узлы в Сингапуре, Токио, Сеуле, Гонконге, восточной и западной части США — всего 6 регионов.
Параллельное подключение Thunderbolt 5
Дополнительная возможность подключения, выбираемая для каждой машины. В запросе укажите количество устройств и схему подключения.
Подготовка перед отправкой запроса

Чтобы поддержка могла воспроизвести и проверить проблему

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

ЗАПРОС В ПОДДЕРЖКУ / ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

Список данных о проблеме

7 пунктов
01 Номер заказа

Помогает найти запись заказа; не указывайте только название модели.

02 Регион узла

Укажите Сингапур, Токио, Сеул, Гонконг, восточную или западную часть США.

03 Доступная модель

Укажите BookAMini M4 Core или BookAMini M4 Plus.

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

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

05 Полный текст ошибки

Скопируйте исходный текст, сохранив код ошибки и контекст; не ограничивайтесь фразой «не работает».

06 Выполненные шаги

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

07 Воспроизводимость

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

Передача специалистам

Если самопроверка не помогла, отправьте тикет в консоли

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

01 / ПОЛУЧЕНИЕ

Отправьте проблему и данные о состоянии

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

02 / КЛАССИФИКАЦИЯ

Определите: подключение, среда или счёт

Специалисты поддержки определят область проблемы по доказательствам. При нехватке данных тикет укажет конкретные поля для дополнения.

03 / ДОПОЛНЕНИЕ

Продолжайте отвечать в исходном тикете

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

04 / ОБРАБОТКА

Проверьте вывод и следующие шаги

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

ТИКЕТ

Проблема существующего заказа или узла

Отправьте тикет в консоли и свяжите его с соответствующим заказом.

Открыть консоль
ЭЛЕКТРОННАЯ ПОЧТА

Не удаётся войти в консоль

Напишите с адреса электронной почты аккаунта и укажите номер заказа и описание проблемы со входом.

support@bookamini.com
Начать сборку

Выберите один из 6 узлов и двух моделей с выделенными физическими ресурсами.

BookAMini M4 Core и BookAMini M4 Plus — выделенные физические машины для облачного Mac, а не виртуальные машины. Заказы оплачиваются в долларах; доступность определяется актуальным статусом в консоли.

Арендовать Mac mini Конфигурации и цены