Cum configurezi un runner GitHub Actions propriu pe un VPS

Înregistrează un runner GitHub Actions propriu pe un VPS și instalează-l ca serviciu: descarci runnerul ca utilizator non-root, îl înregistrezi cu tokenul repository-ului, rulezi svc.sh ca să supraviețuiască repornirilor. Comenzi gata de copiat.

Un runner propriu îți dă CI la cost fix, cu cache-uri calde — fără facturare pe minut, cu uneltele tale, pe mașina ta. Acesta e ghidul minim de configurare; pentru motivele pentru care un runner propriu bate minutele găzduite de GitHub și pentru detalii despre joburile Docker, vezi ghidul complet și cazul de utilizare VPS pentru GitHub Actions.

1. Creează un utilizator non-root (runnerul refuză root)

adduser --disabled-password --gecos "" runner
su - runner

2. Descarcă runnerul

În GitHub: Settings → Actions → Runners → New self-hosted runner → Linux — de acolo primești exact comanda de descărcare și un token de unică folosință. Apoi:

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L \
  https://github.com/actions/runner/releases/latest/download/actions-runner-linux-x64.tar.gz
tar xzf actions-runner-linux-x64.tar.gz

3. Înregistrează-l la repository

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

4. Instalează-l ca serviciu (supraviețuiește repornirilor)

Nu rula ./run.sh într-un terminal — instalează-l:

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

Runnerul apare acum ca Idle în interfața GitHub și preia joburile care îl vizează.

5. Folosește-l dintr-un workflow

jobs:
  build:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Joburi Docker (opțional)

Instalează Docker o singură dată, iar workflow-urile pot construi imagini cu cache-ul de straturi păstrat între rulări:

sudo apt install -y docker.io
sudo usermod -aG docker runner

Vezi instalarea Docker pe un VPS. Dimensionare: Small ($8/lună) e comod pentru majoritatea CI-urilor; treci mai sus pentru compilări grele. Root în aproximativ un minut, fără KYC, plată cripto.

Întrebări frecvente

Cum înregistrez un runner GitHub Actions propriu?

În repository (sau organizație): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub îți arată o comandă de descărcare și un token de înregistrare de unică folosință. Descarci runnerul ca utilizator non-root, rulezi ./config.sh cu URL-ul și tokenul acela, apoi îl instalezi ca serviciu cu svc.sh. Pașii sunt mai jos.

De ce nu poate rula runnerul ca root?

Runnerul refuză să ruleze ca root, prin design. Creează un utilizator dedicat, non-root (adduser runner), și configurează-l acolo. Asta limitează și ce ar putea atinge pe mașina ta un workflow rău intenționat.

Cum țin runnerul pornit după o repornire?

Folosește scriptul inclus svc.sh: sudo ./svc.sh install runner && sudo ./svc.sh start. Instalează o unitate systemd, astfel încât runnerul pornește la boot, repornește după o cădere și apare ca Idle în interfața GitHub.

Am nevoie de un IP dedicat pentru un runner?

Nu. Runnerul se conectează el spre GitHub prin HTTPS; nimic nu trebuie să ajungă la el din exterior. Un plan NAT (de la $3/lună) merge. Ia un IP dedicat doar dacă găzduiești și ceva care servește trafic.

Cereți act de identitate sau card?

Nu. E-mail la înregistrare, plată în USDC sau USDT — fără documente, fără card. Root în aproximativ un minut.

Comentarii

Încă nu există comentarii. Fii primul.