Раннеры
Tuist Runners сейчас доступны только по приглашению, пока мы наращиваем мощности. Свяжитесь с нами или напишите нам в Slack-сообществе, чтобы запросить доступ для вашего аккаунта. Цены будут объявлены, когда раннеры станут общедоступными.
Tuist Runners — это управляемые macOS- и Linux-раннеры для ваших пайплайнов GitHub Actions, Buildkite, GitLab CI и Bitrise. Вместо запуска задач на хостинговых машинах вашего CI-провайдера вы направляете задачу на профиль Tuist, и она выполняется во флоте Tuist рядом с тем же кешем, который уже использует ваша команда, без необходимости устанавливать агент раннера и поддерживать инфраструктуру. Чтобы понять, что формирует ваш счёт за CI до смены машин, см. затраты на CI.
Подключение обычно сводится к изменению одной строки в задаче:
jobs:
build:
- runs-on: macos-latest
+ runs-on: tuist-macos
steps:
- uses: actions/checkout@v4
- run: tuist test
steps:
- label: "Test"
command: tuist test
agents:
- queue: macos
+ queue: tuist-macos
Эмуляторы Android на Linux#
Linux-раннеры по умолчанию предоставляют аппаратно ускоренную виртуализацию через /dev/kvm. Используйте обычный Linux-профиль, например tuist-linux, чтобы запускать x86_64 эмуляторы Android, включая Gradle Managed Devices. Для доступа к устройству не нужны специальный профиль раннера, действие настройки KVM, изменение прав или sudo.
Образ раннера включает Android SDK. Установите эмулятор и его библиотеки времени выполнения перед запуском устройства. Для проекта, в котором уже определён Gradle Managed Device с именем pixel6, задача GitHub Actions выглядит так:
jobs:
android-test:
runs-on: tuist-linux
steps:
- uses: actions/checkout@v4
- uses: actions/setup-java@v4
with:
distribution: temurin
java-version: '17'
- name: Install emulator dependencies
run: |
sudo apt-get update -qq
sudo apt-get install -y --no-install-recommends \
libx11-6 libxcomposite1 libxcursor1 libxi6 libxtst6 libxrandr2 \
libxrender1 libpulse0 libnss3 libxkbcommon-x11-0 libxcb-cursor0 \
libasound2 libglu1-mesa
"$ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager" 'emulator'
- name: Check hardware acceleration
run: |
test -r /dev/kvm && test -w /dev/kvm
"$ANDROID_HOME/emulator/emulator" -accel-check
- name: Run instrumented tests
run: ./gradlew :app:pixel6DebugAndroidTest
Используйте версию Java, требуемую вашим Android Gradle Plugin, и замените тестовую задачу на задачу managed-device вашего проекта. Настройте системный образ x86_64. Выберите конфигурацию раннера с достаточным объёмом памяти как для Gradle, так и для эмуляторов; параллельно работающие устройства делят выделенные задаче CPU и память.
Запускайте эмулятор от имени обычного пользователя раннера. sudo в этом примере нужен только для установки пакетов операционной системы.
Эмуляторы используют вложенную виртуализацию, поэтому их время работы может отличаться от физического Android-устройства. Рассматривайте бенчмарки эмулятора как измерения именно этой CI-среды, а не производительности физического устройства.
Ограничения параллелизма#
У каждого аккаунта есть независимые ограничения параллелизма по vCPU и памяти для macOS и Linux. Прежде чем Tuist примет задачу, он проверяет конфигурацию машины задачи против всех задач,currently выполняющихся на этой платформе. Задача начнётся только тогда, когда её vCPU и память поместятся в оставшуюся ёмкость; иначе она останется в очереди, пока ёмкость не освободится. Работа на одной платформе никогда не расходует ёмкость другой платформы.
Аккаунты Air имеют фиксированные ограничения параллелизма. Для аккаунтов Pro и Enterprise Tuist автоматически добавляет запас, исходя из регулярного использования и недавних задач в очереди, которые не могут выполняться одновременно с активными раннерами. Автоматические корректировки только увеличивают лимиты: существующие квоты и контрактный минимальный объём сохраняются. Рост происходит постепенно и ограничен защитными потолками, поэтому внезапный всплеск не даёт неограниченный параллелизм. Более высокий лимит аккаунта не гарантирует немедленную доступность машин.
Раздел Параллелизм в панели управления раннерами показывает пиковое принятое использование vCPU и памяти за каждый час, со ступенчатой линией для лимита, известного на начало каждого часа. Красные полосы достигли этого исторического порога; сами по себе они не доказывают, что задача ждала. Увеличение в течение часа может поднять пик выше линии начала интервала. Текущие лимиты отображаются рядом с каждым графиком. Периоды до начала отслеживания истории не имеют линии лимита вместо предполагаемого исторического значения.
Если рабочие процессы продолжают стоять в очереди на уровне защитного потолка, свяжитесь с нами, указав имя вашего аккаунта, платформу и ожидаемую параллельную нагрузку, чтобы мы могли оценить необходимую ёмкость.
Доступ к сети#
Задачи могут открывать исходящие соединения в публичный интернет. Диапазоны частных адресов (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) заблокированы, и раннеры не принимают входящие соединения.
| Платформа | Исходящие порты |
|---|---|
| Linux | TCP 22 (SSH), 80 (HTTP) и 443 (HTTPS), плюс DNS |
| macOS | Все порты |
SSH покрывает зависимости git@, SSH-подмодули, ключи развёртывания и развёртывания через ssh или scp. Если Linux-воркфлоу требует другой исходящий порт, свяжитесь с нами.
Подключите GitHub, направьте runs-on на профиль Tuist и запустите свою первую задачу во флоте.
Подключите свой кластер, назовите очередь по имени профиля Tuist и направляйте на неё шаги.
Подключите GitLab один раз и выбирайте машину для каждой задачи с помощью тегов пайплайна.
Подключите своё рабочее пространство и запускайте сборки пулов self-hosted раннеров на профилях Tuist.
Запускайте задачи из своего git-форджа или оркестратора одним запросом и отслеживайте их через вебхуки.
Выбирайте платформу, размер и версию Xcode с помощью именованных профилей машин, на которые ссылаетесь из своих задач.
Сохраняйте кеши Xcode, модулей и Gradle, а также любые другие директории между задачами, с приватной записываемой копией для каждого запуска.
Действия графа Once#
Once может выполнять подходящие действия команд графа на Linux-воркерах Tuist, если в аккаунте включено удалённое выполнение и сервер сообщает о совместимых возможностях воркеров. Это выполнение на уровне действий, отдельное от задач CI-провайдеров, описанных выше. См. Удалённое выполнение Once для настройки, требований к образу и проверок совместимости.
Почему Tuist Runners#
Большинство провайдеров CI-раннеров ускоряют задачи, предоставляя более мощные машины и постоянный кеш, обычно в виде общего тома, монтируемого обратно в ваши CI-запуски. Это помогает, но том — это просто диск: он содержит всё, что оставили предыдущие CI-запуски. Он не реплицируется, чтобы держать только самые свежие артефакты рядом с местом сборки, и никогда не достигает других мест, где собирается ваш код.
Сборка больше не происходит в одном месте. Один и тот же код компилируется на ноутбуках разработчиков, в CI и всё чаще агентами написания кода и другими автоматизированными средами. Tuist Runners отличаются тем, что используют один и тот же кеш, из которого все эти среды уже читают и в который пишут, независимо от используемой системы сборки. Артефакты, которые коллега прогрел на своём ноутбуке, которые создал агент или которые оставила предыдущая сборка, становятся попаданием в кеш на раннере, и наоборот. Нет отдельного CI-кеша, который нужно прогревать, и ускорение не ограничивается только CI.
Кроме того, кеш расположен вместе с раннером в одной частной сети, поэтому чтение и запись в кеш остаются внутренними и близкими к вычислительным ресурсам, не пересекая публичный интернет.
В итоге:
- Общий для всех сред. Раннер читает и записывает в тот же кеш, что и машины разработчиков, CI и агенты написания кода, поэтому работа, выполненная где угодно, прогревает кеш везде.
- Расположен рядом с вычислениями. Трафик кеша остаётся во внутренней сети рядом с раннером, а не проходит через публичный вход.
- Единая система, а не надстройка. Кеширование, выборочное тестирование, шардирование тестов и аналитика сборок работают с одним и тем же проектом и аккаунтом, поэтому раннер не является отдельным изолированным хранилищем данных сборок.