Поддержка разработчиков

Сначала проверьте сами

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

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

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

Три первых шага

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

Проверьте IP-адрес и данные для подключения

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

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

Подготовка к подключению

Первый вход по SSH

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

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

Инструкция по подключению через SSH

Подключение к графическому интерфейсу macOS

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

При медленном соединении уменьшите глубину цвета и отключите динамические обои. Для запуска тестов и просмотра журналов лучше использовать SSH — так передача изображения рабочего стола не будет занимать время.

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

Восемь терминов о машинах и подключении

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

Физический узел
Место, где физически размещён Mac. MetalVNC предлагает четыре узла в Азиатско-Тихоокеанском регионе: Сингапур, Токио, Сеул и Гонконг. При выборе учитывайте маршрут передачи данных: небольшое географическое расстояние не всегда означает меньшую задержку.
Выделенный физический компьютер
На весь срок аренды вы получаете отдельный компьютер и используете его процессор, память и диск без совместного доступа других клиентов. Если команда запускает на нём несколько задач, они всё равно конкурируют за ресурсы одной машины — распределение параллельной нагрузки остаётся за вами.
Не виртуальная машина
Среда работает на физическом Mac, а не на виртуальном экземпляре общего хоста. Доступны графический интерфейс macOS и командная строка. Скорость сборки по-прежнему зависит от размера проекта, набора инструментов, кэша и числа параллельных задач.
VNC
Способ удалённого доступа, который передаёт изображение рабочего стола и принимает ввод с клавиатуры и мыши. Подходит для отладки графики и проверки интерфейса, но не для синхронизации файлов. Для передачи больших исходников и артефактов используйте отдельный подходящий способ.
Вход по ключу SSH
Аутентификация с помощью открытого и закрытого ключей. Открытый ключ добавляют в список разрешённых на удалённой машине, а закрытый хранят на защищённом локальном устройстве или в хранилище секретов CI/CD. Не добавляйте закрытый ключ в репозиторий и не отправляйте его через заявку в поддержку.
self-hosted runner
Исполнитель CI, которым управляет ваша команда и который получает задания на выполнение. На выделенном узле можно запускать сборки и тесты, но команда самостоятельно отвечает за токены регистрации, права заданий, очистку рабочих каталогов и версии инструментов.
Сертификат подписи кода и профиль подготовки
Конфиденциальные ресурсы для процесса подписи сборок, а не учётные данные для удалённого входа. Перед использованием проверьте назначение и права доступа, импортируйте их по правилам безопасности команды и удалите ненужные материалы после завершения задачи.
Объединение через Thunderbolt 5
Дополнительная возможность подключения нескольких машин для совместной работы. Она не объединяет память разных машин в единый общий пул. Перед заказом укажите число машин, направление передачи данных и требования к хранилищу. Доступные варианты будут показаны на странице конфигурации.
Среда и жизненный цикл

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

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

Когда после заказа можно подключиться к машине?

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

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

Что нужно сделать перед переустановкой системы?

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

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

Как проверить и сменить версию Xcode?

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

xcode-select -p
xcodebuild -version
DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer" xcodebuild -version

Последний путь приведён для примера — замените его на фактический каталог Xcode на машине. Смена каталога разработчика не устанавливает отсутствующие SDK или среды выполнения. Перед запуском полноценного конвейера CI сначала проведите небольшую проверку.

На диске закончилось место. Можно добавить хранилище?

Доступны дополнительные SSD на +1 ТБ и +2 ТБ. SSD на +1 ТБ стоит $2.4 в день, $6.5 в неделю, $12.1 в месяц или $32.9 за квартал; SSD на +2 ТБ — $4.8 в день, $13 в неделю, $24.2 в месяц или $65.8 за квартал.

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

Как долго хранятся данные на машине после окончания срока аренды?

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

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

Команде нужен платёжный документ для возмещения расходов. Что делать?

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

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

Гарантии доступности сервиса

Важно и обязательство, и методика расчёта

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

Целевая доступность в месяц

99,9%

Если месячная доступность ниже 99,9%, время недоступности компенсируется в десятикратном размере временем сервиса.

Расчёт ведётся помесячно. Это не показатель успешности сборок и не оценка плавности изображения VNC. Исключения, включая форс-мажор и действия пользователя, проверяются по применимым условиям сервиса.

Данные мониторинга за последние 90 дней

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

Историю состояния пока нельзя проверить

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

Сообщить о сбое
Оплата и сверка платежей

Перед оплатой проверьте сеть и сумму

Все расчёты ведутся в долларах США (USD). Доступность платёжного шлюза определяется ответом серверного интерфейса при оформлении заказа.

USDT-TRC20

Используйте только сеть TRC20, адрес получателя и сумму к оплате, указанные на странице оформления заказа. Не используйте реквизиты другого заказа и не считайте снимок экрана с переводом подтверждением оплаты заказа.

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

Статус оплаты заказа — основание для подтверждения

Visa / Mastercard / Amex

Платежи по картам обрабатывает Stripe. Сверяйтесь с суммой и результатом оплаты на странице оформления заказа. Если банк-эмитент запросит подтверждение, выполните необходимые действия, затем проверьте статус платежа в консоли.

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

Валюта расчётов: USD

Перед продлением проверьте два пункта

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

Передайте проблему инженерам

Заявка со всеми данными для воспроизведения

По вопросам уже арендованных экземпляров отправляйте заявку через консоль — так её можно связать с заказом. По вопросам выбора до покупки или если не удаётся войти, напишите на support@metalvnc.com.

  1. 01

    Укажите объект

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

  2. 02

    Опишите проблему

    Укажите время и часовой пояс, последнюю успешную операцию и масштаб проблемы. Уточните, что именно происходит: «тормозит только VNC», «не удаётся подключиться и по SSH» или «команда сборки выдаёт ошибку».

  3. 03

    Добавьте шаги воспроизведения

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

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

Расскажите, на каком шаге возникла проблема

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