Проект и конфигурация
Исходные файлы и конфигурацию автоматизации следует хранить в собственной системе версий и резервного копирования команды. Рабочая копия на облачном Mac не должна быть единственной версией.
Инженерное руководство
Проблемы с облачным Mac? Сначала сузьте область поиска
Здесь собраны решения для первого подключения, работы с macOS, сборки Xcode, инференса MLX, расширения хранилища и заказов. Сначала выполните нужные проверки, затем отправьте идентификатор заказа, время возникновения и обезличенные логи — так команда поддержки избежит повторных уточнений.
- Область поддержки
- 6 типов проблем
- Доступные конфигурации
- 3 модели
- Узлы сервиса
- 4 узла
Маршрутизация проверки
Сначала определите уровень, затем соберите данные
Можно создать тикет
A
Перед подключением
Уровень входа
Проверьте статус выдачи, узел, данные подключения и локальную сеть.
B
Во время работы
Уровень выполнения
Последовательно проверьте версию, зависимости, диск, память и логи.
C
Перед отправкой
Уровень доказательств
Сохраните хронологию и шаги воспроизведения, удалив пароли, ключи и конфиденциальные данные.
Что подготовить
Идентификатор заказа + модель + узел + время + обезличенные логи
Начните проверку с этапа, где возникла проблема
Доступны все шесть категорий. Выберите наиболее близкую к текущему симптому и не смешивайте в одном описании сбой подключения, ошибку сборки и проблему с заказом.
Удалённое подключение
Статус выдачи, данные подключения, локальная сеть и ввод учётных данных.
Учётная запись и заказ
Срок аренды, варианты продления, сведения об узле и статус заказа.
Работа с macOS
Версия системы, права учётной записи, сеть и свободное место на диске.
Сборка Xcode
Версия, файлы подписи, кэш зависимостей, диск и логи сборки.
Инференс MLX
Формат модели, унифицированная память, адрес прослушивания, параллелизм и логи загрузки.
Расширение хранилища
Планирование объёма, рабочие каталоги, очистка кэша и экспорт до окончания аренды.
Проверка перед заказом
Сначала определите назначение, конфигурацию и условия подключения
Если заказ ещё не создан, сначала выполните эти шесть пунктов. Чем точнее определены назначение и требования к ресурсам, тем проще выбрать одну из трёх доступных конфигураций и не принять объём хранилища, сетевые условия или срок аренды за неисправность машины.
Каталог узлов
Три модели доступны в Сингапуре, Японии (Токио), Южной Корее (Сеул) и Гонконге. Фактическая доступность определяется в реальном времени через консоль.
Чек-лист подготовки заказа
6 / 6 пунктов
- Определено назначениеСборка, тестирование, непрерывная интеграция или инференс MLX
- Выбрана модельM4 16GB, M4 24GB или M4 Pro 64GB
- Выбран узелОриентируйтесь на часовой пояс команды и маршрут передачи данных
- Подтверждён расчётный периодПроверьте заказ на день, неделю, месяц или квартал
- Подтверждены требования к хранилищуРазделите систему, проект, кэш зависимостей и файлы моделей
- Среда удалённого подключения готоваЛокальная сеть разрешает нужные подключения и остаётся стабильной
При сбое подключения начните со статуса выдачи, а не с многократной смены пароля
Проблемы при первом входе на облачный Mac обычно связаны со статусом заказа, данными подключения, локальной сетью или процессом ввода. Проверяйте всё в указанном порядке и меняйте только одну переменную за раз.
-
01
Уровень заказа
Убедитесь, что заказ готов к подключению
Войдите в консоль и проверьте текущий заказ. Если он ещё обрабатывается, дождитесь обновления статуса; не используйте старые снимки экрана или данные подключения от другого заказа.
-
02
Уровень данных
Проверьте данные подключения по полям
Убедитесь, что узел, адрес хоста, способ подключения и учётная запись относятся к одному заказу. При копировании проверьте пробелы в начале и конце; не записывайте реальные учётные данные в чаты, имена снимков экрана или публичные репозитории.
-
03
Сетевой уровень
Исключите ограничения локальной сети
Убедитесь, что локальная сеть, брандмауэр или прокси не блокируют подключение. Можно один раз проверить его через другую доверенную сеть, но не меняйте одновременно учётную запись, клиент и сеть.
-
04
Уровень ввода
Повторно проверьте ввод учётных данных
Различайте регистр и похожие символы и убедитесь, что раскладка клавиатуры выбрана верно. Если проблему удаётся воспроизвести, запишите только тип ошибки и время, не сохраняйте пароль в исходном виде.
Ошибка сборки Xcode? Проверяйте всё по порядку — от инструментов до логов
Сначала убедитесь, в какой среде фактически выполняется сборка, затем проверяйте зависимости и подпись. Полная очистка всех кэшей или постоянная смена версий Xcode затрудняет воспроизведение исходной проблемы.
-
1
Зафиксируйте версию Xcode
Запишите выбранный путь к Xcode, его версию и требования проекта. Убедитесь, что задания командной строки и графический интерфейс используют один набор инструментов.
-
2
Проверьте файлы подписи
Убедитесь, что нужные файлы передаются через собственный процесс управления секретами команды, а путь и права указаны верно. Не копируйте содержимое файлов подписи в обращение в поддержку.
-
3
Сузьте область очистки кэша зависимостей
Сначала определите, происходит ли сбой на этапе загрузки, разбора, компиляции или компоновки. Очищайте только кэш соответствующей зависимости и сохраняйте логи до и после очистки.
-
4
Проверьте место на диске
Отдельно проверьте объём, занятый каталогом проекта, артефактами сборки, архивами и кэшем зависимостей. При нехватке места сначала экспортируйте нужные артефакты, затем удалите содержимое, которое можно восстановить.
-
5
Снимите минимально необходимый фрагмент лога
Сохраните нужные строки до и после первой ошибки, выполненную команду и код завершения. Удалите токены, имена пользователей, адреса внутренних репозиториев и сведения о подписи.
Инференс MLX
Сначала убедитесь, что модель загружается, затем проверяйте параллельность сервиса
При проблемах с инференсом MLX разделяйте формат модели, использование унифицированной памяти, прослушивание сервиса и нагрузку запросами. Сначала установите воспроизводимую базовую линию с одним запросом, затем постепенно увеличивайте параллелизм, чтобы не смешивать ошибку загрузки с перегрузкой сервиса.
FORMAT
Формат модели
Сначала проверьте
Убедитесь, что файлы модели полны, способ преобразования одинаков, и зафиксируйте используемый фреймворк и его версию.
MEMORY
Использование унифицированной памяти
Затем измерьте
Запишите показатели до загрузки, после загрузки и после первого запроса — не ориентируйтесь только на кратковременный пик.
LISTEN
Адрес прослушивания сервиса
Проверьте вход
Убедитесь, что диапазон прослушивания и порт соответствуют схеме доступа, и настройте необходимые средства контроля доступа.
LOAD
Параллельность запросов
Постепенное тестирование
Начните с одного запроса, зафиксируйте входные данные, затем постепенно повышайте параллелизм и записывайте задержку и типы сбоев.
LOG
Логи загрузки модели
Сохраните данные
Сохраните версию, параметры запуска и контекст ошибки, удалив рабочие входные данные и конфиденциальные пути.
Планируйте объём по ролям данных и не считайте узел единственной резервной копией
Система, исходные файлы проекта, кэш зависимостей, артефакты сборки и веса моделей имеют разные жизненные циклы. Сначала разделите их на группы, затем решайте, нужно ли добавлять хранилище.
Кэш зависимостей и сборки
Кэш ускоряет повторные задачи, но для него нужно задать границы очистки. При проверке диска сначала подсчитайте объём по каталогам и не удаляйте всё сразу.
Модели и файлы данных
Зафиксируйте источник, формат, версию и объём модели. Перед загрузкой крупных файлов проверьте путь узла и оставьте время для экспорта до окончания аренды.
Архивы и артефакты
Называйте архивы сборки, отчёты тестов и результаты инференса по партиям задач. После приёмки экспортируйте обязательные материалы в хранилище под контролем команды.
Заказ и продление
Актуальные сведения о заказе смотрите на текущей странице консоли
После входа проверьте текущий срок аренды, доступные варианты продления, выбранную модель и сведения об узле. Узлы работают в обычном режиме 365 дней в году; фактический статус заказа и доступные варианты в реальном времени показывает консоль.
Чтобы создать новый заказ, выберите одну из трёх доступных конфигураций и нужный узел в Сингапуре, Японии (Токио), Южной Корее (Сеул) или Гонконге. Все сочетания из каталога доступны для заказа, а фактическую доступность возвращает консоль.
Поля для проверки заказа
CURRENT
- Срок аренды
- Время начала, время окончания и текущий период
- Продление
- Доступный для текущего заказа период продления
- Конфигурация
- Чип, память, хранилище и дополнительные опции
- Узел
- Регион обслуживания, соответствующий текущему заказу
Сделайте первое обращение сразу готовым к проверке
Из обращения должно быть понятно, в каком заказе, на какой машине и узле возникла проблема, когда она произошла, как её воспроизвести и что показывают логи. Одних слов «не удаётся подключиться» или «сборка завершилась ошибкой» обычно недостаточно для диагностики.
Идентификатор заказа
Укажите идентификатор заказа из консоли и не заменяйте его пользовательским названием машины.
Модель и узел
Укажите VMCache M4 16, VMCache M4 24 или VMCache M4 Pro 64 и соответствующий узел.
Время возникновения
Укажите часовой пояс и сообщите, происходит ли проблема постоянно, периодически или возникла один раз.
Шаги воспроизведения
Начиная с заведомо рабочего состояния, по шагам перечислите действия, тип входных данных, ожидаемый и фактический результат.
Масштаб влияния
Укажите, затрагивает ли проблема одну задачу, один проект или все задачи, и приведите примеры, которые работают нормально.
Обезличенные логи
Сохраните контекст ошибки, версию и код завершения, удалив пароли, закрытые ключи, токены и рабочие данные.
Два способа связи
Создать тикет поддержки
Для существующего заказа сначала войдите в консоль и создайте тикет; если войти в консоль невозможно или вопрос относится к выбору до покупки, напишите на support@vmcache.com.
Дальше
Сначала выполните проверки, затем передайте доказательства команде поддержки
Если нужны новые ресурсы, сравните три конфигурации; при проблеме с существующим заказом отправьте тикет с идентификатором заказа, узлом, временем возникновения, шагами воспроизведения и обезличенными логами.