Подключение Mockarty Desktop к Cloud

Name: Mockarty
Author: Mockarty

Mockarty Desktop может подключить именованный профиль Cloud, не копируя пароль или лицензию в приложение.

Где взять Desktop

Откройте в кабинете Cloud раздел Desktop и устройства — там перечислены опубликованные сборки для каждой платформы, их размер и контрольная сумма SHA-256. Платформа может быть представлена в нескольких формах: на macOS это образ диска (.dmg) и архив (.zip) с одним и тем же приложением — выбирайте ту, что удобнее по вашей политике. Mac на Apple Silicon и на Intel — отдельные сборки. Если сборка выложена из бета-канала, рядом с версией на карточке стоит пометка Beta. Скачайте сборку для своей системы и сверьте контрольную сумму, если ваша политика этого требует.

Если раздел сообщает, что сборка ещё не опубликована, значит в этой установке Cloud релиз пока не выложен: обратитесь к администратору, а не ищите файл на стороне.

Когда соответствующие сборки опубликованы, в том же разделе появляется блок Другие приложения Mockarty: CLI для CI и скриптов, Runner для запуска тестов пространства на ваших серверах, Android Companion и расширение для браузера. Пока сборок нет, блок скрыт, чтобы не предлагать неработающие загрузки. Кнопки показывают доступные платформы; для macOS явно выберите Apple Silicon или Intel. Ссылка Все приложения и платформы открывает полный каталог только после его публикации.

Desktop на сервере

Desktop можно запустить на своём Linux-сервере и работать с ним из браузера, как с удалённой машиной: моки, тесты и синхронизация с Cloud выполняются на сервере, а вы открываете интерфейс у себя. В разделе Desktop и устройства возьмите сборку Linux-сервер (.tar.gz) для архитектуры сервера и распакуйте её.

Создайте ключ, которым Desktop зашифрует сохранённые входы. На сервере нет системного хранилища паролей, поэтому ключ задаёте вы:
```
openssl rand -base64 32 > ~/.mockarty-vault.key
chmod 600 ~/.mockarty-vault.key
```
Храните ключ отдельно от данных Desktop. Без ключа Desktop не запустится, а с другим ключом не откроет уже сохранённые входы.

Запустите Desktop без окна:

MOCKARTY_NO_BROWSER=1 \
MOCKARTY_DESKTOP_VAULT_KEY_FILE=$HOME/.mockarty-vault.key \
./mockarty-desktop

На своём компьютере откройте туннель и зайдите в интерфейс:
```
ssh -N -L 15780:127.0.0.1:5780 user@your-server
```
Откройте http://127.0.0.1:15780/ui/. Порт 15780 выбран, чтобы не пересекаться с Desktop на вашем компьютере.

Интерфейс слушает только 127.0.0.1 сервера и снаружи не виден — доступ идёт через SSH. Вход в Cloud делается так же, как в приложении: кабинет откроется в вашем браузере, после подтверждения вы вернётесь в Desktop через тот же туннель. Вход сохраняется между перезапусками. Если после перезапуска сервера страница попросит войти заново, обновите её. Данные хранятся в ~/.mockarty пользователя, от которого запущен Desktop.

Перед началом

Без аккаунта доступны локальные моки, API- и UI-тестирование, а также фаззинг
с ограничениями. Для надёжности и хаос-тестирования войдите с действующим
разрешением Cloud либо активируйте лицензию с этими возможностями.

Без входа начните работу в sandbox. Для создания дополнительных пространств нужно войти; существующие пространства от прежней работы остаются доступны. Лимиты общие для пространств этого устройства и не сбрасываются при переключении. Если сохранённых объектов больше лимита, удалите ненужные объекты или выберите тариф с большей ёмкостью перед созданием новых.

В разделе Панель Desktop → Пространства имён ошибка обновления показывается отдельно от пустого списка. Ранее загруженные пространства остаются видимыми; после восстановления локального сервиса нажмите Повторить. Если создание пространства не удалось без сети, выбранное пространство не меняется.

На странице Моки скопируйте Адрес HTTP-моков на этом устройстве и добавьте путь мока. Адрес содержит фактический локальный порт и выбранное пространство: например, http://127.0.0.1:5780/stubs/sandbox плюс /orders. Десктоп должен работать во время запросов. Для получения адреса выберите одно пространство; у просмотра всех пространств нет единого базового адреса.

Для локальной работы аккаунт не обязателен. В шапке Desktop наведите указатель на Лимиты или нажмите эту кнопку, чтобы увидеть использование по доступным типам объектов и запусков. Оттуда можно перейти к входу или настройкам аккаунта. Существующие данные сохраняются при достижении лимита.

В нативном приложении кнопки − / процент / + в шапке меняют масштаб от 50% до 200%. Нажатие на процент возвращает 100%; выбранный масштаб сохраняется между запусками. Управление масштабом есть и в меню Вид. Грид-консоль в боковом меню открывает локальную консоль раннера внутри приложения. Локальные дашборды показывают источники данных для доступных локальных инструментов.

Встроенная Грид-консоль использует тему и язык приложения. API-, UI-, нагрузочные тесты и фаззинг выполняются локальным узлом; подключать отдельный браузерный раннер для этого не нужно. Консоль управляет дополнительными раннерами устройств. В ней видны состояние служб и пространство раннера; выбор пространства в шапке сам по себе не меняет привязку раннера. Поля идентичности узла и расписание находятся в разделе Дополнительные настройки. Запуск дополнительных служб — отдельное действие кнопкой Подключить; отключение доступно той же кнопкой. Отдельно открытая консоль сохраняет собственную шапку и настройки оформления.

Первый локальный UI-тест может запускаться дольше: Desktop устанавливает компоненты браузера. Для этой первой установки нужен интернет; подготовьте и проверьте браузер до перехода в офлайн. Аккаунт для запуска локального UI-теста не требуется.

В разделе Панель Desktop → UI-тесты выберите, будет ли Desktop управлять браузером или подключаться к уже запущенному на этом устройстве, затем нажмите Установить / проверить браузер. Элементы управления станут доступны после чтения сохранённого выбора. Если чтение не удалось, нажмите Повторить: Desktop не заменит неизвестный выбор настройкой по умолчанию. Ошибка сохранения или проверки показывается как ошибка, а не как успешная настройка. Если автоматическая установка браузера не удалась без сети, панель покажет команду ручной установки выбранного движка.

Для UI-теста на телефоне в той же локальной сети откройте Панель Desktop → UI-тесты → Телефон в этой сети, выберите сеть и ограниченное по времени окно, затем откройте его. QR-код на странице UI-тестирования использует показанный там адрес. Desktop подтверждает состояние окна перед сообщением об успехе и обновляет его, пока окно открыто. Если состояние неизвестно, не используйте старый QR-код; нажмите Обновить состояние связи. Кнопка Выключить связь закрывает временную доступность по сети, но не отзывает уже выданный телефону токен устройства.

Временное окно также пропускает соединение сигналинга раннера привязанного телефона. Оно не открывает маршруты зрителя или администрирования, а закрытие или истечение срока окна разрывает активные соединения телефона и запрещает новые.

Где что настраивается

В меню Desktop два пункта настроек, как на сервере:

Настройки — локальные параметры пространства имён: корзина, Git-синхронизация, трекер и тест-кейсы, колбэки, политика очистки. Серверные настройки коллегии, агентов встреч и ИИ-профилей пространства находятся на сервере, а не здесь.
Панель Desktop — само приложение: подключение к Cloud, лицензия, пространства имён, модули, плагины, UI-тесты, обновления и раздел ИИ и модели.

В пространстве Team, где доступен трекер задач, владелец может включить его локально в Настройки → Тест-кейсы и задачи. После этого в меню появятся Задачи. Обсуждения и звук новых сообщений настраиваются лично в меню аккаунта; без доступа к командным возможностям эти переключатели не показываются.

Для функций ИИ, доступных вашему аккаунту и лицензии, добавьте локальную модель в Панель Desktop → ИИ и модели: нажмите Создать профиль, выберите провайдера, укажите модель и свой ключ, нажмите Проверить и сделайте профиль профилем по умолчанию. Само добавление профиля не открывает агентские функции, отсутствующие в тарифе. Ключ хранится на этом устройстве в зашифрованном виде. Участниками команды и их ролями управляют в кабинете Cloud: Desktop — приложение одного человека.

Откройте Панель Desktop → Общие, чтобы выбрать оформление, язык и параметры
конфиденциальности. Сетевые параметры выделены в отдельную группу: смена темы
не сохраняет и не включает аналитику. Остальные настройки доступны в списке разделов.
Параметры конфиденциальности недоступны, пока Desktop не прочитает сохранённые
настройки. Если чтение не удалось, проверьте локальное хранилище и нажмите
Повторить: Desktop не запишет значения формы по умолчанию поверх неизвестного состояния.
Если стандартный локальный порт Грид-консоли занят, Desktop выберет свободный
порт на этой машине автоматически. Явно заданный адрес не подменяется: если он
занят, освободите его или измените настройку и перезапустите Desktop.
Во встроенной консоли состояние и возможная причина сбоя показаны в верхней панели;
отдельная пустая карточка статуса не занимает место.

Нативные пакеты Desktop включают desktop-runner для тестирования настоящих
десктоп-приложений; отдельно скачивать его не нужно. В Грид-консоли включите
Тестирование десктоп-приложений, проверьте готовность и подключите службы
раннера. В macOS предоставьте доступ к записи экрана и управлению компьютером
при запросе, затем нажмите Проверить снова. Установленные компоненты и
доступные разрешения показываются отдельно. Во время сценариев рабочий сеанс
должен оставаться доступным. В Linux используйте сеанс X11/Xorg; Wayland может
ограничивать захват экрана и ввод.

В macOS разрешения относятся к установленному приложению, которое запрашивает
доступ, а не ко всем приложениям с одинаковым названием. При проверке разрешений
используйте одну копию Mockarty в постоянной папке.
Если после обновления переключатель уже включён, но проверка не проходит,
удалите только старую запись Mockarty кнопкой −, добавьте установленную сейчас
копию кнопкой + и полностью перезапустите Desktop. Разрешения других приложений
и рабочие пространства Mockarty удалять не нужно.
Проверка готовности не запрашивает отсутствующие разрешения macOS автоматически.
Нажмите Открыть настройки, чтобы явно запросить доступ, выдайте его в системном
окне и повторите проверку. Если macOS просит перезапуск, полностью закройте и
заново откройте Mockarty перед проверкой.
При переходе между разработческой и распространяемой сборками система может
запросить согласие заново. Не удаляйте свои данные и не переустанавливайте Desktop
только из-за отсутствующего разрешения: сначала проверьте нужную запись в
системных настройках и нажмите Проверить снова.

При установке Linux из tar-архива установите GTK 3, WebKit2GTK и библиотеки
X11/XTest и XKB через пакетный менеджер дистрибутива. В Debian и Ubuntu для
раннера дополнительно нужны libxtst6, libx11-xcb1, libxcb-xkb1 и
libxkbcommon-x11-0. В Debian-пакете эти зависимости указаны автоматически.

Создайте или выберите профиль Cloud в разделе Панель Desktop → Подключение → Именованные профили подключения.
Если при создании профиля появилась ошибка соединения, проверьте локальный сервис Desktop и повторите попытку; существующий список профилей не заменяется.
Убедитесь, что Desktop видит адрес Cloud, указанный в профиле.
Войдите в кабинет Cloud с подтверждённым аккаунтом.
Если развёртывание использует частный центр сертификации, получите у
администратора локальный PEM-файл и запустите Desktop с SSL_CERT_FILE,
указывающим на этот файл. Desktop по-прежнему проверяет сертификат и точный
отпечаток сервера; не отключайте проверку TLS.

Авторизация устройства

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

На экране входа Desktop выберите Cloud и нажмите Продолжить через Cloud.
В браузере откроется кабинет Cloud. Сравните видимый код и имя устройства с окном Desktop. Имя устройства — это имя вашего компьютера и система, например MacBook-Air · macOS.
Выберите Пространство, к которому Desktop получит доступ. Изначально список пуст: первое Пространство никогда не выбирается автоматически.
Нажмите Разрешить устройству. Кабинет подтвердит, что подключил, назовёт Пространство и предложит Вернуться в Mockarty Desktop; через несколько секунд он вернёт вас туда сам. Вкладка кабинета при этом остаётся открытой — кнопка Назад в браузере вернёт её, если она понадобится.

Если вы хотите остаться в кабинете, нажмите Остаться в кабинете — Desktop в любом случае уже подключён.

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

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

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

При подключённом профиле Cloud для запуска фаззинга, нагрузочного или UI-теста нужна действующая связь с Cloud. Суточное использование принадлежит вашему аккаунту и общее для всех установок Desktop и Пространств: смена Пространства или вступление в Team не обнуляют счётчик. Даже если у типа запуска пока нет суточного потолка, подключённый профиль передаёт его использование для единой истории. Новый день начинается в полночь UTC. Если Cloud недоступен, локальные данные остаются доступными; повторите запуск после восстановления связи. Анонимное локальное использование и активированная офлайн-лицензия сохраняют лимиты на устройстве.

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

Выход

Откройте меню аккаунта (справа вверху) и выберите Выход или откройте страницу входа и выберите Выйти из Mockarty Cloud, затем подтвердите. Desktop:

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

Локальные проекты остаются на компьютере. Если Cloud недоступен, Desktop всё равно выходит на этом компьютере и сообщает об этом; чтобы наверняка, удалите устройство в кабинете. Чтобы работать под другим аккаунтом, выйдите и войдите снова.

Восстановление подключения

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

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

Подключение Cloud и пакетные обновления Desktop независимы. Авторизация
устройства не включает канал обновлений, а импорт офлайн-обновления не
отправляет проекты или учётные данные подключения. Используйте подписанные
элементы обновления в меню Справка; окно данных не показывает токены профиля.

Потерянное или заменённое устройство

Откройте раздел Desktop и устройства в кабинете Cloud и отзовите старую установку — устройства подписаны именем компьютера и системой. После отзыва она не сможет получить новое активное подключение. Затем авторизуйте замену как новое устройство.