Dezvoltare

Script de instalare pentru un runner GitHub Actions propriu

Completează repository-ul și etichetele și primești un script care instalează runnerul sub un utilizator separat și îl pornește ca serviciu. Tokenul îl introduci pe server, nu aici.

Rulează integral în browser — nimic din ce introduci nu ajunge pe serverele noastre.

URL-ul repository-ului sau al organizațieiÎnlocuiește exemplul cu adresa ta. Pentru un runner al întregii organizații, păstrează doar organizația.

Numele runneruluiEtichete, separate prin virgulăUtilizator Linux

Instalează Docker pentru joburile care au nevoie de el

Doar pentru repository-uri private. Într-unul public, un pull request dintr-un fork poate rula cod pe serverul tău.

Script de instalare

#!/usr/bin/env bash
# Installs a self-hosted GitHub Actions runner as a systemd service (Debian, Ubuntu).
# Run as root: bash install-runner.sh
set -euo pipefail

REPO_URL="https://github.com/your-org/your-repo"
RUNNER_NAME="vps-runner-1"
RUNNER_LABELS="vps"
RUNNER_USER="runner"
RUNNER_DIR="/home/$RUNNER_USER/actions-runner"

[ "$(id -u)" -eq 0 ] || { echo "Run this script as root." >&2; exit 1; }
command -v apt-get >/dev/null || { echo "This script supports Debian and Ubuntu only." >&2; exit 1; }
case "$(uname -m)" in
  x86_64) ARCH=x64 ;;
  aarch64) ARCH=arm64 ;;
  *) echo "Unsupported CPU: $(uname -m)" >&2; exit 1 ;;
esac
[ ! -f "$RUNNER_DIR/.runner" ] || { echo "A runner is already configured in $RUNNER_DIR." >&2; exit 1; }

read -rsp "Registration token from GitHub: " RUNNER_TOKEN; echo
[ -n "$RUNNER_TOKEN" ] || { echo "The token is empty." >&2; exit 1; }

apt-get update -y
apt-get install -y curl tar ca-certificates
id "$RUNNER_USER" >/dev/null 2>&1 || useradd -m -s /bin/bash "$RUNNER_USER"

# Latest runner release
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/actions/runner/releases/latest | sed 's|.*/tag/v||')"
FILE="actions-runner-linux-$ARCH-$VERSION.tar.gz"
as_runner() { runuser -u "$RUNNER_USER" -- env HOME="/home/$RUNNER_USER" "$@"; }
as_runner mkdir -p "$RUNNER_DIR"
cd "$RUNNER_DIR"
as_runner curl -fsSL -o "$FILE" "https://github.com/actions/runner/releases/download/v$VERSION/$FILE"
as_runner tar xzf "$FILE"
rm -f "$FILE"
./bin/installdependencies.sh

# Register with GitHub and start as a service
as_runner ./config.sh --unattended --url "$REPO_URL" --token "$RUNNER_TOKEN" --name "$RUNNER_NAME" --labels "$RUNNER_LABELS" --replace
./svc.sh install "$RUNNER_USER"
./svc.sh start
./svc.sh status --no-pager

Linie pentru workflow

runs-on: [self-hosted, vps]

Cum îl rulezi

Pe GitHub deschide Settings → Actions → Runners → New self-hosted runner și copiază tokenul.
Copiază scriptul pe serverul Debian sau Ubuntu și rulează-l ca root: bash install-runner.sh.
Lipește tokenul când scriptul îl cere. Rămâne pe serverul tău și nu trece niciodată prin această pagină.
Pune linia runs-on în workflow-ul tău.

Ghid pas cu pas: runner propriu pe un VPS

Ai nevoie de un server pentru runner? Planul Small: 4 vCPU, 4 GB RAM, acces root, $8/lună.

Planul Small

Cum funcționează

Un runner propriu lucrează pe mașina ta: se conectează singur la GitHub, preia joburile și le execută acolo. Scriptul instalează pachetele necesare, creează un utilizator Linux separat, descarcă cea mai nouă versiune a runnerului, o înregistrează și configurează un serviciu systemd care rezistă la reporniri. Scriptul se generează în browser, așa că citește fiecare linie înainte să-l rulezi. Serverul are nevoie doar de acces de ieșire către GitHub, IP-ul dedicat nu este necesar.

Întrebări frecvente

De unde iau tokenul de înregistrare?

În repository deschide Settings → Actions → Runners → New self-hosted runner. Tokenul este valabil o oră. Pentru un runner al întregii organizații, urmează aceeași cale în setările organizației.

Pot folosi un runner propriu cu un repository public?

GitHub nu recomandă: un pull request dintr-un fork poate rula cod pe serverul tău. Folosește runnere proprii cu repository-uri private.

Are nevoie serverul de IP dedicat?

Nu. Runnerul deschide doar conexiuni de ieșire către GitHub, deci merge un plan fără IP dedicat. Ca putere, 4 vCPU și 4 GB RAM ajung pentru majoritatea proiectelor.

Unelte similare

b64

Codificator/decodor Base64

Text și fișiere în Base64 și înapoi, cu opțiune URL-safe.

Generator UUID

UUID v4 și v7 ordonat în timp, în serie.

*/5

Ajutor pentru expresii cron

Explică o linie crontab și arată următoarele rulări.

Аa

Transliterare

Din chirilică în latină: standarde de pașaport și slug-uri URL.

Toate uneltele →