Найдите нужный шаг

Руководство по облачному Mac

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

СЕАНС / 01 Первые шаги: справочник
01
Заказ

Проверьте модель, период оплаты и выбранные дополнения.

Сначала проверьте
02
Узел

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

Затем сверьте
03
Сеанс

Настройте клиент удалённого рабочего стола согласно предоставленным инструкциям.

После этого подключайтесь

В справочнике нет адресов подключения и учётных данных. Войдите в систему и проверьте данные о предоставлении сервера.

Первые шаги

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

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

01Сверьте заказ

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

02Проверьте физический узел

Сопоставьте узел в данных о предоставлении сервера с выбранным в заказе. Доступны узлы в Сингапуре, Токио, Сеуле, Гонконге и на западе США. Актуальный статус проверяйте в панели управления.

03Подготовьтесь к подключению

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

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

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

Проблема не исчезла?

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

Руководство по подключению к удалённому рабочему столу
Среда разработки

Перенесите требования проекта на облачный Mac

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

СРЕДА / 01

Система и Xcode

Запишите требования проекта к версии macOS и Xcode, SDK и инструментам командной строки. После подключения проверьте установленные версии и решите, нужно ли менять набор инструментов. Для начала выполните минимальную тестовую сборку.

Что проверить: конфигурацию проекта, документацию команды по сборке и фактические версии на машине.

СРЕДА / 02

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

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

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

СРЕДА / 03

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

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

Что проверить: настройки подписи проекта, срок действия материалов и права доступа.

Проверяйте результат по мере переноса

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

CI/CD

Настройте runner с проверяемой средой сборки

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

ДОСТУП

Ограничьте права учётной записи

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

СБОРКА

Зафиксируйте набор инструментов и выполните пробный запуск

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

СЕКРЕТЫ

Изолируйте материалы для подписи

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

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

Оплата

Разберите счёт по составляющим

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

Период оплаты

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

Дополнения

Если выбрали дополнительный SSD на +1 TB или +2 TB либо Thunderbolt 5, проверьте выбранные опции и цену для соответствующего периода. Не считайте невыбранные опции частью заказа.

Способы оплаты

Принимаются только USDT-TRC20 и карты Visa / Mastercard / Amex через Stripe. Все платежи проводятся в USD. Доступные при оплате варианты смотрите в панели управления.

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

Восемь терминов для начала

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

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

Темы для дальнейшего изучения

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

01Apple Silicon и виртуализация

Разберитесь в архитектуре и особенностях предоставления выделенного физического Mac.

02Подключение конвейера CI/CD

От прав runner и первой сборки до проверки журналов и результатов.

03Сертификаты и профили

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

04Публикация через TestFlight

Чем проверка сборки на облачном Mac отличается от последующей отправки приложения.

05Автоматическая сборка iOS-приложений

Включите в процесс зависимости, подпись, параметры сборки и проверку результатов.

06Перенос среды Homebrew

Составьте список инструментов и последовательно восстановите версии и зависимости проекта.

Нужна помощь

Опишите проблему так, чтобы её можно было воспроизвести

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

Уже есть заказ или нужно проверить экземпляр

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

Войти и отправить тикет
Выбор конфигурации и общие вопросы до заказа

Напишите на support@xcodezone.com и укажите цель использования, нужный набор инструментов и предпочтительный узел.

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

Определились с моделью, узлом и сроком аренды?

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