CI: сборка прошивок на Gitea Actions (workflow, скрипт, раннер)

2026-10-08 22:28:42 +03:00
parent 157b9761c7
commit b6e6e1b2ec
6 changed files with 495 additions and 0 deletions
@@ -0,0 +1,22 @@
+[Unit]
+Description=Gitea Actions runner (MeshCore firmware builder)
+Documentation=https://docs.gitea.com/usage/actions/act-runner
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+# отдельный пользователь: от его имени выполняются шаги workflow,
+# здесь же живёт кэш PlatformIO
+User=act-runner
+Group=act-runner
+WorkingDirectory=/var/lib/act-runner
+Environment=HOME=/var/lib/act-runner
+ExecStart=/usr/local/bin/act_runner daemon --config /etc/act_runner/config.yaml
+Restart=always
+RestartSec=5
+# сборка прошивок — процесс долгий и прожорливый, но не привилегированный
+NoNewPrivileges=true
+
+[Install]
+WantedBy=multi-user.target
@@ -0,0 +1,30 @@
+# Конфигурация act_runner (Gitea Actions).
+# Подключается в docker-compose.yml как /config.yaml.
+
+log:
+  level: info
+
+runner:
+  file: /data/.runner
+  capacity: 1          # одновременно одна сборка; поднимайте, если на VPS много CPU
+  timeout: 5h          # холодная сборка набора прошивок может идти долго
+  fetch_timeout: 30s
+  fetch_interval: 5s
+  # Метки не задаём здесь: они фиксируются при регистрации раннера
+  # (systemd: act_runner register --labels ubuntu-latest:host,
+  #  docker: переменная GITEA_RUNNER_LABELS в docker-compose.yml)
+
+cache:
+  enabled: true
+  dir: /data/cache
+  host: ""
+  port: 0
+
+container:
+  # job'ы запускаются как sibling-контейнеры через смонтированный docker.sock
+  network: ""
+  privileged: false
+  options: "--add-host=host.docker.internal:host-gateway"
+  workdir_parent: ""
+  valid_volumes: []
+  force_pull: false
@@ -0,0 +1,32 @@
+# act_runner для Gitea: выполняет Gitea Actions на этом сервере.
+#
+# Запуск (из каталога ci/act_runner):
+#   1) получить токен: Gitea → репозиторий → Settings → Actions → Runners → Create new Runner
+#   2) создать .env рядом с этим файлом:
+#        GITEA_INSTANCE_URL=https://git.meshinfo.ru
+#        GITEA_RUNNER_REGISTRATION_TOKEN=<токен из шага 1>
+#        GITEA_RUNNER_NAME=meshcore-builder
+#   3) docker compose up -d
+#   4) проверить: docker compose logs -f
+#
+# Метка ubuntu-latest должна совпадать с runs-on в .gitea/workflows/firmware.yml.
+# Образ job'а — catthehacker/ubuntu:act-22.04: в нём уже есть git, curl, python3,
+# build-essential; PlatformIO ставится шагом workflow и живёт в кэше.
+
+services:
+  act-runner:
+    image: gitea/act_runner:latest
+    container_name: meshcore-act-runner
+    restart: unless-stopped
+    environment:
+      GITEA_INSTANCE_URL: ${GITEA_INSTANCE_URL:?укажите адрес Gitea в .env}
+      GITEA_RUNNER_REGISTRATION_TOKEN: ${GITEA_RUNNER_REGISTRATION_TOKEN:?нужен токен раннера}
+      GITEA_RUNNER_NAME: ${GITEA_RUNNER_NAME:-meshcore-builder}
+      GITEA_RUNNER_LABELS: ${GITEA_RUNNER_LABELS:-ubuntu-latest:docker://catthehacker/ubuntu:act-22.04}
+      CONFIG_FILE: /config.yaml
+    volumes:
+      # состояние раннера (.runner) и локальный кэш Gitea Actions
+      - ./data:/data
+      - ./config.yaml:/config.yaml:ro
+      # job'ы запускаются как соседние контейнеры, поэтому нужен доступ к демону
+      - /var/run/docker.sock:/var/run/docker.sock