Geliştirici

Kendi barındırdığınız GitHub Actions runner için kurulum betiği

Deponuzu ve etiketlerinizi girin; runner'ı ayrı bir kullanıcı altında kuran ve hizmet olarak başlatan bir betik alın. Token'ı burada değil, sunucunuzda girersiniz.

Tamamen tarayıcınızda çalışır — girdiğiniz hiçbir şey sunucularımıza gönderilmez.

Depo veya kuruluş adresiÖrneği kendi adresinizle değiştirin. Tüm kuruluşa ait bir runner için yalnızca kuruluşu bırakın.

Runner adıEtiketler, virgülle ayrılmışLinux kullanıcısı

Gerektiren işler için Docker'ı kur

Yalnızca özel depolar için. Herkese açık bir depoda, fork'tan gelen bir pull request sunucunuzda kod çalıştırabilir.

Kurulum betiği

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

Workflow için satır

runs-on: [self-hosted, vps]

Nasıl çalıştırılır

GitHub'da Settings → Actions → Runners → New self-hosted runner sayfasını açın ve token'ı kopyalayın.
Betiği Debian veya Ubuntu sunucunuza kopyalayın ve root olarak çalıştırın: bash install-runner.sh.
Betik istediğinde token'ı yapıştırın. Sunucunuzda kalır ve asla bu sayfadan geçmez.
runs-on satırını workflow dosyanıza ekleyin.

Adım adım kılavuz: VPS'te kendi barındırdığınız runner

Runner için sunucu mu gerekiyor? Small planı: 4 vCPU, 4 GB RAM, root erişimi, aylık 8 $.

Small planı

Nasıl çalışır

Kendi barındırdığınız runner kendi makinenizde çalışır: GitHub'a kendisi bağlanır, işleri alır ve orada yürütür. Betik gerekli paketleri kurar, ayrı bir Linux kullanıcısı oluşturur, runner'ın en yeni sürümünü indirir, kaydeder ve yeniden başlatmalardan etkilenmeyen bir systemd hizmeti ayarlar. Betik tarayıcınızda oluşturulur, bu yüzden çalıştırmadan önce her satırı okuyun. Sunucunun yalnızca GitHub'a giden erişime ihtiyacı vardır, özel IP gerekmez.

Sık sorulan sorular

Kayıt token'ını nereden alırım?

Deponuzda Settings → Actions → Runners → New self-hosted runner sayfasını açın. Token bir saat geçerlidir. Tüm kuruluşa ait bir runner için kuruluş ayarlarında aynı yolu izleyin.

Kendi barındırdığım runner'ı herkese açık bir depoyla kullanabilir miyim?

GitHub bunu önermez: bir fork'tan gelen pull request sunucunuzda kod çalıştırabilir. Bu runner'ları özel depolarla kullanın.

Sunucunun özel IP'ye ihtiyacı var mı?

Hayır. Runner yalnızca GitHub'a giden bağlantılar açar, bu yüzden özel IP'siz bir plan yeterlidir. Güç olarak çoğu proje için 4 vCPU ve 4 GB RAM yeterlidir.

Benzer araçlar

b64

Base64 kodlayıcı/çözücü

Metin ve dosyaları Base64'e ve geri çevirin, URL-safe seçeneği.

UUID üretici

UUID v4 ve zamana göre sıralı v7, toplu olarak.

*/5

Cron yardımcısı

Bir crontab satırını açıklar ve sonraki çalışmaları gösterir.

Аa

Harf çevirisi

Kiril'den Latin'e: pasaport standartları ve URL slug'ları.

Tüm araçlar →