nested-runner

Self-hosted раннеры GitHub Actions, которые сами крутятся внутри GitHub Actions (ubuntu-latest). Матрёшка.

Зачем: доказать, что так можно. Кто потащит в прод — тот лох.

Как это работает

Заводит в целевом репо эфемерный runner scale set и слушает его очередь. Пришёл job — контроллер забирает его и диспатчит runner.yml у себя. Тот поднимает внутри ubuntu-latest, регистрирует его в scale set целевого репо по JIT-конфигу, отрабатывает один job и умирает. Больше NESTED_MAX раннеров одновременно не бывает. docker compose down сносит scale set, раннеров и висящие запуски.

Что нажать

1. Создать токен

Аккаунт должен быть админом целевого репозитория и коллабаратором этого.

Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (classic).

Имя nested, no expiration, скоупы repo и workflow.

2. Положить compose-файл

mkdir -p /opt/nested-runner && nano /opt/nested-runner/compose.yml:

services:
  nested-runner:
    image: ghcr.io/wprhvso/nested-runner:latest
    container_name: nested-runner
    restart: unless-stopped
    stop_grace_period: 2m
    command: ["owner/target"]
    environment:
      GH_TOKEN: ${GH_TOKEN:?нужен токен в .env}
      # GH_REPO: wprhvso/nested-runner
      # NESTED_SCALE_SET: nested
      # NESTED_MAX: 20
      # NESTED_WORKFLOW: runner.yml
      # NESTED_DEBUG: 1

Токен — рядом, в /opt/nested-runner/.env:

GH_TOKEN=ghp_...

chmod 600 /opt/nested-runner/.env

Целевых репозиториев можно перечислить сразу несколько: command: ["owner/a", "owner/b"].

3. Запустить

env -C /opt/nested-runner docker compose up -d

Логи:

env -C /opt/nested-runner docker compose logs -f

Снести:

env -C /opt/nested-runner docker compose down

4. Поправить runs-on во всех нужных workflow

runs-on: nested

Использовать массивы в runs-on нельзя.

5. Проверить запуском своего workflow

Обновление

env -C /opt/nested-runner docker compose pull && env -C /opt/nested-runner docker compose up -d

Команды