په VPS کې د self-hosted GitHub Actions runner د تنظیمولو څرنګوالی

په VPS کې یو self-hosted GitHub Actions runner ثبت کړئ او د خدمت په توګه یې نصب کړئ: runner د non-root کارن په توګه ښکته کړئ، د خپل repo ټوکن سره یې ثبت کړئ، svc.sh چل کړئ ترڅو له بیا-پیلونو ژوندی پاتې شي. کاپي-پیسټ کمانډونه.

یو self-hosted runner تاسو ته د تودو کیشونو سره ثابت-لګښت CI درکوي — د هرې دقیقې بلینګ نشته، ستاسو toolchain، ستاسو ماشین. دا لږترلږه د تنظیم لارښود دی؛ چې ولې self-hosting د GitHub-hosted دقیقو څخه غوره دی او د Docker-دندې توضیحات لپاره بشپړ لارښود او د GitHub Actions لپاره د VPS کارونې قضیه وګورئ.

۱. یو non-root کارن جوړ کړئ (runner له root څخه انکار کوي)

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

۲. runner ښکته کړئ

په GitHub کې: Settings → Actions → Runners → New self-hosted runner → Linux، چې تاسو ته دقیق ښکته کول او د یو ځل ټوکن درکوي. بیا:

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

۳. دا د خپل repo سره ثبت کړئ

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

۴. د خدمت په توګه نصب کړئ (له بیا-پیلونو ژوندی پاتې کیږي)

./run.sh په ترمینل کې مه چلوئ — نصب یې کړئ:

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

runner اوس په GitHub UI کې د Idle په توګه ښکاري او هغه دندې اخلي چې دا یې په نښه کوي.

۵. له یوه workflow څخه یې وکاروئ

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

د Docker دندې (اختیاري)

Docker یو ځل نصب کړئ، او workflow-ونه کولی شي عکسونه جوړ کړي په داسې حال کې چې د پرت کیش د چلولو ترمنځ پاتې کیږي:

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

په VPS کې د Docker نصبول وګورئ. اندازه: Small ($8/میاشت) د ډیرو CI لپاره آرام دی؛ د درنې کمپایلیشن لپاره پورته لاړ شئ. نږدې په یوه دقیقه کې root، بې له KYC، په کریپټو تادیه.

پوښتنې

د self-hosted GitHub Actions runner څنګه ثبت کړم؟

ستاسو په repo (یا org) کې: Settings → Actions → Runners → New self-hosted runner → Linux. GitHub د ښکته کولو کمانډ او د یو ځل ثبت ټوکن ښیي. runner د non-root کارن په توګه ښکته کړئ، د هغه URL او ټوکن سره ./config.sh چل کړئ، بیا یې د svc.sh سره د خدمت په توګه نصب کړئ. مرحلې لاندې دي.

runner ولې د root په توګه نه شي چلیدلی؟

runner د ډیزاین له مخې د root په توګه له چلیدو انکار کوي. یو ځانګړی non-root کارن جوړ کړئ (adduser runner) او هلته یې تنظیم کړئ. دا هغه هم محدودوي چې یو بدنیت workflow ستاسو په ماشین کې څه لمس کولی شي.

له بیا-پیلولو وروسته runner څنګه روان وساتم؟

له ورسره راغلي svc.sh مرستندوی وکاروئ: sudo ./svc.sh install runner && sudo ./svc.sh start. دا د systemd یوه واحده نصبوي ترڅو runner په بوټ کې پیل شي او په ناکامۍ کې بیا پیل شي، او په GitHub UI کې د Idle په توګه ښکاره شي.

ایا زه د runner لپاره ځانګړي IP ته اړتیا لرم؟

نه. runner د HTTPS له لارې بهر GitHub ته زنګ وهي؛ هیڅ شی ورته د راتلونکي په توګه رسیدو ته اړتیا نلري. د NAT پلان (له $3/میاشت څخه) کار کوي. ځانګړی IP یوازې هغه وخت واخلئ چې تاسو یو داسې شی هم self-host کوئ چې ترافیک خدمت کوي.

ایا تاسو پیژندپاڼه یا کارت غواړئ؟

نه. د نوم لیکنې لپاره یو بریښنالیک، په USDC یا USDT کې تادیه — هیڅ سند نشته، هیڅ کارت نشته. نږدې په یوه دقیقه کې root.

تبصرې

لا تبصرې نشته. لومړی اوسئ.