MiniDebug M4 — выделенная физическая машина: вычислительные ресурсы устройства не разделяются с другими заказами. Ниже реальные задачи разобраны по входным данным, шагам выполнения, результатам и типичным точкам отказа, чтобы вы могли оценить пригодность для текущих процессов iOS, CI, AI и творчества.
Надёжная автоматическая сборка — это не одна команда. Нужно зафиксировать версию исходного кода, состояние зависимостей, выбранный Xcode, входные данные для подписи, параметры экспорта и назначение артефактов. Любой сбой должен находиться по логам.
Входные данные: Адрес репозитория, ветка, хеш коммита, конфигурация сборки и целевая Scheme. Webhook или задача из очереди передаёт только идентификаторы — скрипт не должен на ходу угадывать ветку.
Точка отказа: Коммит не найден, подмодули не синхронизированы, недостаточно прав или одна задача прочитала изменившийся указатель ветки.
Входные данные: Package.resolved, Podfile.lock или другие файлы блокировки. Ключ кэша как минимум должен включать хеш сводки блокировки зависимостей, версию Xcode и целевую архитектуру.
Точка отказа: Изменение файла блокировки, несовместимость кэша с инструментами, недействительные учётные данные приватной зависимости или нехватка места на диске.
Входные данные: Путь к Workspace или Project, Scheme, Configuration, Destination и путь к архиву. Сначала выведите версию инструментов, затем запускайте архивацию.
Точка отказа: Ошибка компиляции, провал тестов, несовместимость целевой версии, загрязнённые производные данные или зависимость скрипта сборки от локального абсолютного пути.
Входные данные: Сертификаты, профили и необходимые переменные окружения с минимально возможным набором прав. Материалы передаются в начале задачи и удаляются после её завершения.
Точка отказа: Несоответствие сертификата и профиля, неправильный диапазон прав, проблемы со сроком действия или ошибочное использование одного временного хранилища ключей несколькими задачами.
Входные данные: Файл архива и конфигурация ExportOptions. После экспорта запишите имя файла, размер, хеш проверки и время создания, а не просто проверяйте наличие каталога.
Точка отказа: Конфликт метода экспорта с настройками подписи, отсутствие прав на каталог вывода или подавленный скриптом ненулевой код выхода.
Результат: Артефакты сборки, файл архива, отчёт о тестах, логи сборки, хеш коммита и идентификатор задачи. Очищайте рабочий каталог только после успешной загрузки.
Точка отказа: Прерывание загрузки, конфликт имён артефактов, чувствительные поля в логах или очистка до подтверждения результата.
Суть фермы сборки не в одновременном запуске задач, а в объяснимости очереди, меток узлов, границ кэша и возврата результатов. Один MiniDebug M4 подходит для контролируемого канала выполнения; дополнительные параллельные задачи следует распределять по физическим узлам, соответствующим разным заказам.
Кэш зависимостей можно использовать повторно по хешу файла блокировки, версии Xcode и архитектуре. DerivedData, временное хранилище ключей, каталог экспорта и незакоммиченные изменения нельзя напрямую использовать между репозиториями.
Ожидание, выполнение, загрузка и завершение — состояния планировщика; успешная компиляция, провал тестов и ошибка подписи — результаты задачи. Раздельная запись позволяет понять, связана проблема с ёмкостью или проектом.
Регистрация Runner — лишь подключение. Стабильность определяют точность меток, контролируемый параллелизм на машине, очистка после задачи и возможность связать логи сбоя с записью запуска соответствующего рабочего процесса.
Рекомендуется сохранить системные метки и добавить поддерживаемые в долгосрочной перспективе метки возможностей, например macos и arm64, xcode-current и signing-ready. Не добавляйте в метки узла временные названия проектов или краткосрочные ветки.
runs-on:
- self-hosted
- macos
- arm64
- xcode-currentДо регистрации проверьте область действия Runner, границы доступа к репозиториям и рабочий каталог. Учётная запись должна иметь только права, необходимые для сборки, не использоваться для обычного удалённого доступа и не содержать долгосрочные учётные данные непосредственно в файлах скриптов.
Не запускайте одновременно две задачи с записью в один рабочий каталог. Перед началом проверьте оставшиеся процессы и свободное место на диске; после завершения удалите копии исходного кода, временные файлы экспорта, временное хранилище ключей и переменные окружения уровня проекта.
При необходимости параллелизма распределяйте разные задачи по разным физическим узлам, а не позволяйте шагам подписи, архивации и очистки перезаписывать друг друга в одном каталоге.
Сбор логов должен продолжаться при ошибке и как минимум возвращать вывод xcodebuild, результаты тестов, свободное место на диске, версии инструментов и идентификатор задачи. Перед загрузкой удаляйте токены, содержимое приватных ключей, пароли сертификатов и чувствительные переменные репозитория.
Разделяйте недоступность Runner, тайм-аут задачи, выход скрипта и сбой загрузки артефактов, чтобы все проблемы не отображались как «сборка завершилась ошибкой».
Индивидуальному разработчику обычно не нужно автоматизировать всё сразу. Надёжнее чётко определить границу между графическими операциями и задачами командной строки, чтобы исправление, проверка, архивация и подготовка артефактов перед TestFlight могли быть отменены.
Выполните изменения кода, базовые тесты и коммит, отправьте фиксированную ветку и запишите условия проверки устройства и ожидаемый результат.
Результат: хеш коммита, описание изменений, охват тестамиПроверьте Scheme, целевую версию и настройки проекта, обработайте предупреждения, требующие визуальной оценки, и убедитесь, что конфигурация подписи соответствует текущему выпуску.
Результат: подтверждённое состояние проекта и параметры выпускаВыполните скриптовую архивацию, экспорт и проверку, сохранив полный лог. При проблеме вернитесь к соответствующим входным данным, а не исправляйте вручную неизвестное состояние на неисправной машине.
Результат: файл архива, пакет экспорта, хеш проверкиГрафический интерфейс отвечает только за настройки и проверки, требующие решения человека; архивацию, экспорт, повторный запуск и именование артефактов передайте скриптам. После каждой ручной правки фиксируйте изменение проекта или различия, чтобы следующую сборку можно было воспроизвести.
MiniDebug M4 оснащён M4, 16 ГБ RAM и SSD 256 ГБ. Сначала проверьте соответствие модели и данных доступным ресурсам, затем записывайте загрузку, память, длительный инференс и качество вывода, не смешивая результаты с разными параметрами.
Запишите формат модели, версию квантования, версию среды выполнения, хеш коммита, входные образцы и случайные параметры. Идентифицируйте файлы моделей хешем проверки, чтобы одинаковые имена не скрывали разное содержимое.
Первая загрузка включает чтение модели и инициализацию, поэтому её нельзя смешивать со стабильной фазой работы. Для каждой серии используйте одинаковые длину входа, размер пакета, число повторов и параметры сэмплирования.
Версии квантования следует сравнивать не только по скорости. Сохраняйте вывод для одинаковых входных данных, оценку качества, ошибочные образцы и сведения о среде, а затем экспортируйте результаты в машиночитаемом виде и итог эксперта.
{
"machine": "MiniDebug M4 / M4 / 16GB / 256GB",
"model_variant": "project-defined",
"input_set": "fixed-evaluation-set",
"measurements": [
"load_time",
"first_output_time",
"total_time",
"peak_memory"
],
"artifacts": ["result.csv", "runtime.log", "notes.md"]
}Узким местом аудио- и видеозадач могут быть передача материалов, совместимость плагинов, удалённое изображение, ёмкость диска или параметры экспорта. Разделение этапов помогает не принять задержки соединения за вычислительную проблему хоста.
Сначала создайте список материалов, указав число файлов, общий размер, структуру каталогов и хеши проверки. Синхронизируйте только прокси-файлы или исходные материалы, необходимые на текущем этапе, а затем проверьте отсутствие файлов.
Контрольная точка:Путь проекта не должен зависеть от локальной буквы диска, ссылки на медиа должны восстанавливаться, а на базовом SSD 256 ГБ должно оставаться место для кэша проекта и экспорта.
Откройте проект через графическое подключение и проверьте шрифты, плагины, ссылки на медиа, параметры сэмплирования и целевой формат вывода. При слабом соединении сначала снизьте качество и разрешение удалённого изображения, не меняя параметры экспорта проекта.
Контрольная точка:Разделяйте качество удалённого предпросмотра и итогового файла; при отсутствии плагина остановите пакетные задачи, чтобы не создавать неполные результаты.
Зафиксируйте пресет экспорта, имена файлов и целевой каталог, затем выполняйте задачи по списку. Для каждой задачи сохраняйте статус выхода, длительность, размер вывода и сведения об ошибках.
Контрольная точка:Перед началом длительной задачи проверьте свободное место на диске; количество параллельных задач проверяйте постепенно с учётом памяти, чтения материалов и нагрузки кодирования.
Выборочно проверьте изображение, аудиодорожки, длительность, разрешение и заголовки файлов, затем создайте хеши проверки. После подтверждения полного получения локально удалите временные файлы в облаке.
Результат:Итоговые файлы, логи экспорта, список ошибок, хеши проверки и локальная запись о получении.
Узел выбирают не только по расположению команды. Учитывайте также репозиторий кода, источники зависимостей, удалённых операторов и конечную цель поставки. Ниже приведены ориентиры, а не гарантированные сетевые характеристики: фактическое качество соединения зависит от локальной сети пользователя и межрегионального маршрута.
| Узел | Предпочтительное расположение команды | Расположение репозитория и зависимостей | Типичное направление поставки | Проверка перед заказом |
|---|---|---|---|---|
| Сингапур | Команды и участники совместной работы в Юго-Восточной Азии | Сначала тестируйте, если репозиторий, артефакты или зависимости в основном находятся в Юго-Восточной Азии | Ежедневные сборки, удалённая разработка и возврат результатов для команд Юго-Восточной Азии | Проверьте получение репозитория, загрузку зависимостей и удалённое графическое подключение |
| Япония (Токио) | Команды в Японии и соседних регионах Восточной Азии | Сначала тестируйте, если пути доступа к коду и зависимостям проходят преимущественно через Японию | Сборка iOS, проверка подписи и удалённые операции в Xcode для японских команд | Проверьте стабильность интерактивного соединения с узлом и загрузку больших файлов |
| Южная Корея (Сеул) | Команды в Южной Корее и Северо-Восточной Азии | Рассматривайте, если доступ к репозиториям и внутренним ресурсам из Южной Кореи прямее | Непрерывная интеграция, самостоятельно размещаемый Runner и региональная доставка артефактов | Проверьте обратное подключение Runner, получение зависимостей и загрузку логов |
| Гонконг | Команды, работающие между Южным Китаем и Юго-Восточной Азией | Сначала сравните этот вариант, если код, материалы и операторы распределены между Южным Китаем и Юго-Восточной Азией | Межрегиональная совместная разработка, удалённые графические задачи и обработка материалов | Отдельно протестируйте маршруты из офисной и домашней сети |
| Восток США | Команды на востоке Северной Америки и совместные команды с Западной Европой | Рассматривайте, если репозиторий, CI-панель или система поставки в основном расположены на востоке Северной Америки | Очереди сборки, возврат результатов и совместные проверки в рабочем часовом поясе Северной Америки | Проверьте три маршрута: к репозиторию, хранилищу артефактов и удалённому оператору |
Ниже приведены фрагменты для построения структуры скрипта, а не готовая конфигурация для любого проекта. Перед сохранением в репозиторий проверьте Workspace, Scheme, версию Xcode, конфигурацию экспорта, материалы подписи, метки Runner и каталог артефактов с учётом типа проекта.
set -euo pipefail
PROJECT_ROOT="/path/to/project"
WORKSPACE="$PROJECT_ROOT/Example.xcworkspace"
SCHEME="Example"
ARCHIVE_PATH="$PROJECT_ROOT/output/Example.xcarchive"
xcodebuild -version
xcodebuild \
-workspace "$WORKSPACE" \
-scheme "$SCHEME" \
-configuration Release \
-destination "generic/platform=iOS" \
-archivePath "$ARCHIVE_PATH" \
clean archiveЗамените путь к проекту, Workspace, Scheme, Configuration, Destination и каталог архива. Скрипт должен сохранять ненулевой код выхода и до запуска проверять требуемую версию Xcode.
lane :build_release do
setup_ci
build_app(
workspace: "Example.xcworkspace",
scheme: "Example",
configuration: "Release",
output_directory: "output"
)
sh("shasum -a 256 output/*")
endЗамените Workspace, Scheme, каталог вывода и настройки экспорта для проекта. Передавайте материалы подписи через контролируемые переменные или на уровне задачи, не записывайте их непосредственно в Fastfile.
name: ios-build
on:
workflow_dispatch:
jobs:
archive:
runs-on:
- self-hosted
- macos
- arm64
- xcode-current
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Build
run: ./scripts/archive.sh
- name: Collect diagnostics
if: always()
run: ./scripts/collect-diagnostics.shНастройте файл по фактическим меткам Runner, политике репозитория и пути к скриптам. Зафиксируйте версии используемых действий, задайте тайм-аут задачи и обеспечьте выполнение сбора диагностики даже при сбое сборки.
Начните с фиксированного коммита, выполнения одной задачи, архивирования логов и проверки артефактов, затем постепенно добавляйте кэширование, передачу материалов подписи и планирование очереди. Доступна аренда на день, неделю, месяц или квартал; расчёты по заказу выполняются в долларах США.
Оплата доступна только через USDT-TRC20 и Visa / Mastercard / Amex (через Stripe); фактически доступный платёжный шлюз определяется панелью управления.