Самостійно розміщені runner GitHub Actions у ЄС

Як встановити runner GitHub Actions на новому хості

Linux x64, у порядку, який документує GitHub. Реєстраційний токен генерується для кожного runner і спливає через годину після відкриття сторінки, тож беріть його останнім.

1. 1

   Створіть для нього непривілейованого користувача

   sudo adduser --disabled-password --gecos "" runner
   sudo -iu runner

   Runner виконує те, що каже йому workflow, тож він не має бути root і не має ділити домашній каталог ні з чим іншим. Усе нижче виконується від цього користувача.

2. 2

   Завантажте й розпакуйте runner

   mkdir actions-runner && cd actions-runner
   curl -O -L https://github.com/actions/runner/releases/download/v2.336.0/actions-runner-linux-x64-2.336.0.tar.gz
   echo "04cf0be1aff4c3ec3554466c39124ca250e3effd8873bb7e8d68535aa9505d5d  actions-runner-linux-x64-2.336.0.tar.gz" | shasum -a 256 -c
   tar xzf ./actions-runner-linux-x64-2.336.0.tar.gz

   Ця версія і ця контрольна сума - ті, що опубліковані з випуском v2.336.0. Перевірте, чи немає новішої, на сторінці випусків, перш ніж це копіювати: далі runner оновлює себе сам, але перше завантаження перевіряєте ви.

3. 3

   Налаштуйте його на репозиторій або організацію

   ./config.sh --url https://github.com/YOUR-ORG/YOUR-REPO --token AXXXXXXXXXXXXXXXXXXXXXXXXX --labels self-hosted,linux,x64,eu

   Токен візьміть у Settings, потім Actions, потім Runners, потім New self-hosted runner - він обмежений у часі й спливає через годину після видачі. Спрямуйте URL на організацію замість репозиторію, щоб ділити один runner між репозиторіями.

4. 4

   Запустіть як службу

   sudo ./svc.sh install runner
   sudo ./svc.sh start
   sudo ./svc.sh status

   svc.sh приймає користувача, від якого має працювати служба, - саме тому користувача runner створено першим. Скористайтеся натомість ./run.sh, якщо хочете лише побачити, як приходить одне завдання, перш ніж зважитися на службу.

5. 5

   Не дайте needrestart убивати завдання посеред роботи

   echo '$nrconf{override_rc}{qr(^actions\.runner\..+\.service$)} = 0;' | sudo tee /etc/needrestart/conf.d/actions_runner_services.conf

   У Debian та Ubuntu needrestart перезапускає служби, чиї бібліотеки оновлено, - зокрема й runner посеред завдання. GitHub документує саме цей файл як спосіб його виключити.

6. 6

   Спрямуйте на нього workflow

   name: smoke
   on: [push]
   jobs:
     build:
       runs-on: [self-hosted, linux, x64, eu]
       steps:
         - uses: actions/checkout@v6
         - run: cat /etc/os-release

   runs-on збігається з кожною міткою у списку, тож завдання, яке просить чотири мітки, потрапляє лише на runner, що несе всі чотири. Якщо воно лишається в черзі, бракує однієї мітки - а завдання, що чекає понад 24 години, зазнає невдачі.

Звірено з офіційною документацією 2026-08-15 — читати першоджерело