# Раннеры {#runners}

> [!IMPORTANT]
> **Только по приглашению**
>
> Tuist Runners сейчас доступны только по приглашению, пока мы наращиваем мощности. [Свяжитесь с нами](mailto:contact@tuist.dev) или напишите нам в [Slack-сообществе](https://slack.tuist.dev), чтобы запросить доступ для вашего аккаунта. Цены будут объявлены, когда раннеры станут общедоступными.


Tuist Runners — это управляемые macOS- и Linux-раннеры для ваших пайплайнов GitHub Actions, Buildkite, GitLab CI и Bitrise. Вместо запуска задач на хостинговых машинах вашего CI-провайдера вы направляете задачу на <.localized_link href="/guides/features/runners/profiles">профиль</.localized_link> Tuist, и она выполняется во флоте Tuist рядом с тем же <.localized_link href="/guides/features/cache">кешем</.localized_link>, который уже использует ваша команда, без необходимости устанавливать агент раннера и поддерживать инфраструктуру. Чтобы понять, что формирует ваш счёт за CI до смены машин, см. [затраты на CI](https://tuist.dev/solutions/ci-costs).

Подключение обычно сводится к изменению одной строки в задаче:

::: code-group

```diff [GitHub Actions]
 jobs:
   build:
-    runs-on: macos-latest
+    runs-on: tuist-macos
     steps:
       - uses: actions/checkout@v4
       - run: tuist test
```

```diff [Buildkite]
 steps:
   - label: "Test"
     command: tuist test
     agents:
-      queue: macos
+      queue: tuist-macos
```
<!-- -->
:::

## Эмуляторы Android на Linux {#android-emulators}

Linux-раннеры по умолчанию предоставляют аппаратно ускоренную виртуализацию через `/dev/kvm`. Используйте обычный Linux-<.localized_link href="/guides/features/runners/profiles">профиль</.localized_link>, например `tuist-linux`, чтобы запускать x86_64 эмуляторы Android, включая Gradle Managed Devices. Для доступа к устройству не нужны специальный профиль раннера, действие настройки KVM, изменение прав или `sudo`.

Образ раннера включает Android SDK. Установите эмулятор и его библиотеки времени выполнения перед запуском устройства. Для проекта, в котором уже определён Gradle Managed Device с именем `pixel6`, задача GitHub Actions выглядит так:

```yaml
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-среды, а не производительности физического устройства.

## Ограничения параллелизма {#concurrency-limits}

У каждого аккаунта есть независимые ограничения параллелизма по vCPU и памяти для macOS и Linux. Прежде чем Tuist примет задачу, он проверяет <.localized_link href="/guides/features/runners/profiles#machine-shapes">конфигурацию машины</.localized_link> задачи против всех задач,currently выполняющихся на этой платформе. Задача начнётся только тогда, когда её vCPU и память поместятся в оставшуюся ёмкость; иначе она останется в очереди, пока ёмкость не освободится. Работа на одной платформе никогда не расходует ёмкость другой платформы.

Аккаунты Air имеют фиксированные ограничения параллелизма. Для аккаунтов Pro и Enterprise Tuist автоматически добавляет запас, исходя из регулярного использования и недавних задач в очереди, которые не могут выполняться одновременно с активными раннерами. Автоматические корректировки только увеличивают лимиты: существующие квоты и контрактный минимальный объём сохраняются. Рост происходит постепенно и ограничен защитными потолками, поэтому внезапный всплеск не даёт неограниченный параллелизм. Более высокий лимит аккаунта не гарантирует немедленную доступность машин.

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

Если рабочие процессы продолжают стоять в очереди на уровне защитного потолка, [свяжитесь с нами](mailto:contact@tuist.dev), указав имя вашего аккаунта, платформу и ожидаемую параллельную нагрузку, чтобы мы могли оценить необходимую ёмкость.

## Доступ к сети {#network-access}

Задачи могут открывать исходящие соединения в публичный интернет. Диапазоны частных адресов (`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-воркфлоу требует другой исходящий порт, [свяжитесь с нами](mailto:contact@tuist.dev).

<.home_cards>
  <.home_card
    title="GitHub Actions"
    details="Подключите GitHub, направьте runs-on на профиль Tuist и запустите свою первую задачу во флоте."
    link="/guides/features/runners/ci-providers/github-actions"
/>
  <.home_card
    title="Buildkite"
    details="Подключите свой кластер, назовите очередь по имени профиля Tuist и направляйте на неё шаги."
    link="/guides/features/runners/ci-providers/buildkite"
/>
  <.home_card
    title="GitLab CI"
    details="Подключите GitLab один раз и выбирайте машину для каждой задачи с помощью тегов пайплайна."
    link="/guides/features/runners/ci-providers/gitlab-ci"
/>
  <.home_card
    title="Bitrise"
    details="Подключите своё рабочее пространство и запускайте сборки пулов self-hosted раннеров на профилях Tuist."
    link="/guides/features/runners/ci-providers/bitrise"
/>
  <.home_card
    title="API"
    details="Запускайте задачи из своего git-форджа или оркестратора одним запросом и отслеживайте их через вебхуки."
    link="/guides/features/runners/ci-providers/api"
/>
  <.home_card
    title="Профили"
    details="Выбирайте платформу, размер и версию Xcode с помощью именованных профилей машин, на которые ссылаетесь из своих задач."
    link="/guides/features/runners/profiles"
/>
  <.home_card
    title="Тома кеша"
    details="Сохраняйте кеши Xcode, модулей и Gradle, а также любые другие директории между задачами, с приватной записываемой копией для каждого запуска."
    link="/guides/features/runners/cache-volumes"
/>
</.home_cards>

## Действия графа Once {#once-graph-actions}

Once может выполнять подходящие действия команд графа на Linux-воркерах Tuist, если в аккаунте включено удалённое выполнение и сервер сообщает о совместимых возможностях воркеров. Это выполнение на уровне действий, отдельное от задач CI-провайдеров, описанных выше. См. <.localized_link href="/guides/features/runners/once">Удалённое выполнение Once</.localized_link> для настройки, требований к образу и проверок совместимости.

## Почему Tuist Runners {#why-tuist-runners}

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

Сборка больше не происходит в одном месте. Один и тот же код компилируется на ноутбуках разработчиков, в CI и всё чаще агентами написания кода и другими автоматизированными средами. Tuist Runners отличаются тем, что используют один и тот же <.localized_link href="/guides/features/cache">кеш</.localized_link>, из которого все эти среды уже читают и в который пишут, независимо от используемой системы сборки. Артефакты, которые коллега прогрел на своём ноутбуке, которые создал агент или которые оставила предыдущая сборка, становятся попаданием в кеш на раннере, и наоборот. Нет отдельного CI-кеша, который нужно прогревать, и ускорение не ограничивается только CI.

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

В итоге:

- **Общий для всех сред.** Раннер читает и записывает в тот же кеш, что и машины разработчиков, CI и агенты написания кода, поэтому работа, выполненная где угодно, прогревает кеш везде.
- **Расположен рядом с вычислениями.** Трафик кеша остаётся во внутренней сети рядом с раннером, а не проходит через публичный вход.
- **Единая система, а не надстройка.** Кеширование, <.localized_link href="/guides/features/selective-testing">выборочное тестирование</.localized_link>, <.localized_link href="/guides/features/test-sharding">шардирование тестов</.localized_link> и <.localized_link href="/guides/features/build-insights">аналитика сборок</.localized_link> работают с одним и тем же проектом и аккаунтом, поэтому раннер не является отдельным изолированным хранилищем данных сборок.
