Sviluppo

Script di installazione per runner GitHub Actions self-hosted

Indica il repository e le etichette e ottieni uno script che installa il runner con un utente dedicato e lo avvia come servizio. Il token lo inserisci sul tuo server, non qui.

Funziona interamente nel tuo browser: niente di ciò che inserisci viene inviato ai nostri server.

URL del repository o dell'organizzazioneSostituisci l'esempio con il tuo indirizzo. Per un runner di tutta l'organizzazione, lascia solo l'organizzazione.

Nome del runnerEtichette, separate da virgoleUtente Linux

Installa Docker per i job che ne hanno bisogno

Solo per repository privati. In uno pubblico, una pull request da un fork può eseguire codice sul tuo server.

Script di installazione

#!/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

Riga per il tuo workflow

runs-on: [self-hosted, vps]

Come avviarlo

Su GitHub apri Settings → Actions → Runners → New self-hosted runner e copia il token.
Copia lo script sul tuo server Debian o Ubuntu ed eseguilo come root: bash install-runner.sh.
Incolla il token quando lo script lo chiede. Resta sul tuo server e non passa mai da questa pagina.
Inserisci la riga runs-on nel tuo workflow.

Guida passo-passo: runner self-hosted su un VPS

Ti serve un server per il runner? Piano Small: 4 vCPU, 4 GB di RAM, accesso root, 8 $/mese.

Piano Small

Come funziona

Un runner self-hosted lavora sulla tua macchina: si collega a GitHub, prende i job e li esegue lì. Lo script installa i pacchetti necessari, crea un utente Linux separato, scarica l'ultima versione del runner, lo registra e configura un servizio systemd che sopravvive ai riavvii. Lo script viene creato nel tuo browser, quindi leggi ogni riga prima di eseguirlo. Al server basta l'accesso in uscita verso GitHub, l'IP dedicato non è necessario.

Domande frequenti

Dove trovo il token di registrazione?

Nel repository apri Settings → Actions → Runners → New self-hosted runner. Il token vale un'ora. Per un runner di tutta l'organizzazione, segui lo stesso percorso nelle impostazioni dell'organizzazione.

Posso usare un runner self-hosted con un repository pubblico?

GitHub lo sconsiglia: una pull request da un fork può eseguire codice sul tuo server. Usa i runner self-hosted con repository privati.

Il server ha bisogno di un IP dedicato?

No. Il runner apre solo connessioni in uscita verso GitHub, quindi va bene un piano senza IP dedicato. Quanto alla potenza, 4 vCPU e 4 GB di RAM bastano per la maggior parte dei progetti.

Strumenti correlati

b64

Encoder/decoder Base64

Testo e file in Base64 e ritorno, opzione URL-safe.

Generatore di UUID

UUID v4 e v7 ordinati nel tempo, in blocco.

*/5

Assistente cron

Spiega una riga di crontab e mostra le prossime esecuzioni.

Аa

Traslitterazione

Dal cirillico al latino: standard dei passaporti e slug URL.

Tutti gli strumenti →