ڈیولپر

سیلف ہوسٹڈ GitHub Actions رنر کی انسٹال اسکرپٹ

اپنی ریپوزٹری اور لیبل درج کریں اور ایسی اسکرپٹ پائیں جو رنر کو الگ یوزر کے تحت انسٹال کر کے سروس کے طور پر چلائے۔ ٹوکن آپ اپنے سرور پر درج کرتے ہیں، یہاں نہیں۔

مکمل طور پر آپ کے براؤزر میں چلتا ہے — آپ جو کچھ لکھتے ہیں وہ ہمارے سرورز کو نہیں بھیجا جاتا۔

ریپوزٹری یا تنظیم کا URLمثال کی جگہ اپنا پتہ لکھیں۔ پوری تنظیم کے رنر کے لیے صرف تنظیم رکھیں۔

رنر کا ناملیبل، کاما سے الگLinux یوزر

جن کاموں کو ضرورت ہو، ان کے لیے Docker انسٹال کریں

صرف پرائیویٹ ریپوزٹری کے لیے۔ پبلک میں fork سے آیا pull request آپ کے سرور پر کوڈ چلا سکتا ہے۔

انسٹال اسکرپٹ

#!/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 کے لیے لائن

runs-on: [self-hosted, vps]

کیسے چلائیں

GitHub پر ⁦Settings → Actions → Runners → New self-hosted runner⁩ کھولیں اور ٹوکن کاپی کریں۔
اسکرپٹ کو اپنے Debian یا Ubuntu سرور پر کاپی کریں اور root کے طور پر چلائیں: ⁦bash install-runner.sh⁩۔
اسکرپٹ کے پوچھنے پر ٹوکن پیسٹ کریں۔ وہ آپ کے سرور پر رہتا ہے اور اس صفحے سے کبھی نہیں گزرتا۔
⁦runs-on⁩ والی لائن اپنے workflow میں ڈالیں۔

مرحلہ وار گائیڈ: VPS پر سیلف ہوسٹڈ رنر

رنر کے لیے سرور چاہیے؟ Small پلان: ⁦4 vCPU⁩، ⁦4 GB RAM⁩، root رسائی، ‎$8 ماہانہ۔

Small پلان

یہ کیسے کام کرتا ہے

سیلف ہوسٹڈ رنر آپ کی اپنی مشین پر کام کرتا ہے: وہ خود GitHub سے جڑتا ہے، کام لیتا ہے اور وہیں چلاتا ہے۔ اسکرپٹ ضروری پیکیج انسٹال کرتی ہے، الگ Linux یوزر بناتی ہے، رنر کا تازہ ترین ورژن ڈاؤن لوڈ کرتی ہے، اسے رجسٹر کرتی ہے اور ایسی systemd سروس سیٹ کرتی ہے جو ری بوٹ کے بعد بھی چلتی رہے۔ اسکرپٹ آپ کے براؤزر میں بنتی ہے، اس لیے چلانے سے پہلے ہر لائن پڑھ لیں۔ سرور کو صرف GitHub تک باہر جانے والی رسائی درکار ہے، Dedicated IP ضروری نہیں۔

عام سوالات

رجسٹریشن ٹوکن کہاں سے ملے گا؟

اپنی ریپوزٹری میں ⁦Settings → Actions → Runners → New self-hosted runner⁩ کھولیں۔ ٹوکن ایک گھنٹے تک کارآمد رہتا ہے۔ پوری تنظیم کے رنر کے لیے تنظیم کی سیٹنگز میں یہی راستہ اپنائیں۔

کیا سیلف ہوسٹڈ رنر پبلک ریپوزٹری کے ساتھ استعمال کر سکتے ہیں؟

GitHub اس کا مشورہ نہیں دیتا: fork سے آیا pull request آپ کے سرور پر کوڈ چلا سکتا ہے۔ سیلف ہوسٹڈ رنر پرائیویٹ ریپوزٹری کے ساتھ استعمال کریں۔

کیا سرور کو Dedicated IP چاہیے؟

نہیں۔ رنر صرف GitHub کی طرف باہر جانے والے کنکشن کھولتا ہے، اس لیے Dedicated IP کے بغیر پلان کافی ہے۔ طاقت کے لحاظ سے زیادہ تر منصوبوں کے لیے ⁦4 vCPU⁩ اور ⁦4 GB RAM⁩ کافی ہیں۔

سیلف ہوسٹڈ GitHub Actions رنر کی انسٹال اسکرپٹ

کیسے چلائیں

یہ کیسے کام کرتا ہے

عام سوالات

متعلقہ ٹولز