Найдите проблему по задаче

Справочный центр облачного Mac: от подключения до сборки

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

6 категорий задач
Подключение, доступ, инструменты, CI/CD, хранилище, аренда
5 шагов диагностики
От области узла к конкретной задаче
2 канала поддержки
Заявка в консоли и почта поддержки
Диагностическая доска

Сначала фиксируйте факты, потом меняйте настройки

Проверка по порядку
  1. 01
    Проверьте узел заказа Зафиксируйте дата-центр, имя хоста и статус заказа
  2. 02
    Проверьте состояние учётных данных Проверьте ключи, срок действия и последнюю ротацию
  3. 03
    Проверьте сетевой маршрут Отличите проблему DNS, порта или локальной сети
  4. 04
    Проверьте доступные ресурсы Проверьте место на диске, память и фоновые задачи
  5. 05
    Сохраните обезличенные данные Соберите время, команды, коды выхода и фрагменты журналов
Что записать Узел · время · команда · код выхода
Перейти к задаче

Откройте путь для текущей работы

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

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

От подтверждения заказа до первичной проверки

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

  • Проверьте статус заказа и дату окончания
  • Проверьте отпечаток хоста и создайте первый сеанс
  • Сохраните результат проверки, но не открытые учётные данные
Открыть консоль
Удалённое подключение

Создайте сеанс SSH или VNC

SSH подходит для командной строки, автоматизации и туннелей, а VNC — для операций в графическом интерфейсе macOS. Сначала проверьте узел и учётные данные, затем локальную сеть и порт.

  • При первом подключении обязательно проверьте отпечаток хоста
  • При разрыве сначала отличите локальную сеть от сеанса узла
  • Не сохраняйте конфиденциальные данные подключения на общем устройстве
Инструкции по подключению
Инструменты разработки

Проверьте Xcode и среду сборки

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

  • Вывод xcodebuild -version Запишите
  • Проверьте диск с проектом, зависимостями и кэшем
  • Перед очисткой сохраните полную сводку ошибок
Диагностика сборки
CI/CD

Проверьте self-hosted runner

Сначала убедитесь, что runner подключён, метки совпадают, а рабочий каталог доступен, затем запустите минимальную тестовую задачу. Не перезапускайте сразу весь конвейер — это затруднит поиск сбойного этапа.

  • Проверьте метки runner и условия задачи
  • Проверьте права рабочего каталога и каталога кэша
  • Сохраните код выхода и обезличенные журналы неудачной задачи
Диагностика CI/CD
Управление хранилищем

Управляйте местом, кэшем и расширением

Сначала разделите занятое место между файлами проекта, кэшем зависимостей, артефактами сборки и журналами. При постоянном росте выберите +1TB SSD, +2TB SSD или измените стратегию очистки по фактическому приросту.

  • Проверьте свободное место и самые большие каталоги
  • Отделите восстанавливаемый кэш от рабочих данных
  • Перед расширением сделайте резервную копию важных данных
Управление ресурсами
Управление сроком аренды

Проверьте продление, окончание и перенос данных

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

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

Выберите текущий сбойный этап

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

Подготовка к диагностике
  • Запишите время возникновения проблемы и дата-центр узла
  • Сохраните исходные команды, коды выхода и обезличенные журналы
  • Меняйте только одну переменную за раз и фиксируйте результат
Порядок проверки 01—05
Путь решения Начните проверку с пункта 01

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

Запись: узел / время / симптом / последнее изменение
Проблемы сборки

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

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

01

Проверьте версию Xcode

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

xcodebuild -version
xcode-select -p
swift --version
Проверка: версия, путь и требования проекта совпадают
02

Проверьте среду подписи

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

security find-identity -v -p codesigning
env | sort
Проверка: целевой элемент подписи виден, права корректны
03

Очистите DerivedData выборочно

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

du -sh ~/Library/Developer/Xcode/DerivedData
df -h
Проверка: после освобождения места ошибка стабильно воспроизводится или исчезает
04

Найдите сбойный этап Fastlane

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

bundle exec fastlane lane_name --verbose
echo $?
Проверка: определены сбойный action и первая ошибка
05

Проверьте метки и права runner

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

whoami
pwd
ls -ld .
df -h
Проверка: минимальная тестовая задача получена и завершена
Срок аренды и ресурсы

Управляйте сроком окончания, ростом хранилища и подключением устройств отдельно

Продление решает вопрос срока использования, расширение хранилища — ёмкости, а подключение Thunderbolt 5 — конкретного сценария с несколькими устройствами. Это независимые параметры: перед изменением отдельно зафиксируйте текущее состояние и цель.

Продление и дата окончания

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

Где выполнить
Заказ и срок аренды в консоли
Перед операцией
Запишите текущую дату окончания и необходимый период
После операции
Проверьте статус заказа и обновлённую дату окончания

Расширение хранилища

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

+1TB SSD
Постоянно растущие зависимости, кэш и артефакты сборки
+2TB SSD
Несколько проектов, крупные ресурсы или более длительное хранение
Где выполнить
Доступные дополнительные опции в заказе консоли

Подключение Thunderbolt 5

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

Что проверить
Каждый физический узел, участвующий в подключении
Условия проверки
Целевое устройство определяется, канал стабилен, задачи выполняются
Где выполнить
Выберите соответствующую дополнительную опцию при оформлении заказа
Цены на четыре периода аренды дополнительных ресурсов
Дополнительная опция За день За неделю За месяц За квартал
+1TB SSD $2.9 $7.9 $14.6 $39.7
+2TB SSD $5.8 $15.8 $29.2 $79.4
Подключение Thunderbolt 5 (за устройство) $1.1 $2.9 $5.3 $14.4
Краткий словарь терминов

Восемь распространённых терминов с объяснением границ применения

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

Облачный Mac
Ресурс Mac, используемый удалённо через сеть. Облачный Mac ArmCLI — это удалённо подключаемый физический узел на Apple Silicon для разработки, сборки, тестирования и экспериментов.
Физический узел
Фактически предоставленное аппаратное устройство. Данные узла включают дата-центр, имя хоста, сведения для подключения и статус заказа; при диагностике сначала проверьте объект операции.
Выделенный
Один заказ соответствует одному выделенному физическому компьютеру; арендаторы не используют общий экземпляр операционной системы. Пользователь отвечает за собственные процессы, права, ключи и рабочие данные.
Не виртуальная машина
Вычисления выполняются непосредственно на арендованном физическом узле, а не в общем виртуализированном экземпляре операционной системы.
VNC
Способ удалённого просмотра и управления графическим интерфейсом macOS. Подходит для окон, симуляторов и графических инструментов; данные подключения находятся в заказе консоли.
SSH
Протокол для подключения к командной строке, передачи файлов, перенаправления портов и автоматизации. При первом подключении проверьте отпечаток хоста и по возможности используйте аутентификацию по ключу.
self-hosted runner
Исполнитель конвейера, самостоятельно зарегистрированный командой и запущенный на облачном Mac. Получение задачи зависит от статуса подключения, условий меток, прав и конфигурации рабочего каталога.
Кэш сборки
Промежуточные данные, сохраняемые для сокращения повторных загрузок и компиляции. Кэш ускоряет повторные задачи, но требует расчёта ёмкости, стратегии очистки и регулярной проверки.
Учётные данные и безопасность

После восстановления подключения завершите работу с учётными данными

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

Надёжность и безопасность
  1. 01 Ротация ключей При смене сотрудников, потере устройства, ошибочной передаче учётных данных или признаках необычного входа отзовите старые ключи и выпустите новые.
  2. 02 Ограничьте права Задача сборки должна иметь только необходимые для работы права на каталоги, команды и переменные среды; не заменяйте настройку постоянными учётными данными с высокими правами.
  3. 03 Завершите подозрительные сеансы Проверьте текущего пользователя, активные терминалы и фоновые процессы, завершите необъяснимые сеансы и запишите время и связанные задачи.
  4. 04 Обезличьте журналы Сохраните команды, время, коды выхода и контекст ошибки; удалите токены доступа, закрытые ключи, содержимое сертификатов, рабочие данные и внутренние адреса.
  5. 05 Завершите очистку перед окончанием аренды Перенесите код и рабочие данные, отзовите удалённые ключи, удалите временный кэш и конфиденциальные файлы, затем проверьте срок аренды в консоли.
Путь обращения в поддержку

Три шага для отправки воспроизводимой и проверяемой проблемы

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

  1. 01

    Сначала выполните документацию по задаче

    Определите, относится ли проблема к подключению, инструментам, CI/CD, хранилищу или сроку аренды. Запишите выполненные шаги и результат каждого; не меняйте несколько переменных в одном тесте.

  2. 02

    Подготовьте минимальный пакет проблемы

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

  3. 03

    Отправьте заявку через консоль

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

Как описать срочную проблему

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

Готовы начать

Выберите масштаб задачи и настройте выделенный физический Mac

Три класса моделей доступны в пяти дата-центрах: Сингапур, Япония (Токио), Южная Корея (Сеул), Гонконг и восток США. Актуальная доступность отображается в консоли.

3 класса моделей 5 дата-центров Аренда на день, неделю, месяц или квартал