SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor · اپ ڈیٹ شدہ 2026-11-06

Ubuntu 24.04 پر GitHub Actions runner کیسے سیٹ اپ کریں

Ubuntu 24.04 پر GitHub Actions runner انسٹال کرنے کا مکمل طریقہ سیکھیں۔ اس گائیڈ میں dedicated user، checksum، config.sh، systemd سروس اور fork pull request سیکیورٹی رسک شامل ہیں۔

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, July 30, 2026.

Self-hosted GitHub Actions runner کیا کرتا ہے

Self-hosted GitHub Actions runner ایک ایسا پروگرام ہے جسے آپ اپنے VPS پر انسٹال کرتے ہیں۔ یہ GitHub سے کام (jobs) طلب کرتا ہے اور انہیں آپ کے ہارڈویئر پر چلاتا ہے۔ آپ اسے کسی ایک repository کے ساتھ رجسٹر کرتے ہیں، اسے systemd سروس کے طور پر انسٹال کرتے ہیں، اور یہ ہر reboot کے بعد خود بخود دوبارہ چل پڑتا ہے۔ GitHub جاب کو شیڈول کرتا ہے اور آپ کا سرور کام مکمل کرتا ہے۔

اپنی ملکیت والے سرور پر CI (continuous integration) چلانے کے دو بڑے فائدے ہیں۔ ایک تو build minutes کی پیمائش ختم ہو جاتی ہے، اور دوسرا یہ کہ جاب ان چیزوں تک رسائی حاصل کر سکتی ہے جو صرف آپ کی مشین پر موجود ہیں، جیسے کہ warm build cache یا private network۔ اس کی قیمت سیکیورٹی ہے۔ رنر workflow فائل میں درج ہر ہدایت پر عمل کرتا ہے، اسی صارف کے حقوق کے ساتھ جو آپ نے اسے دیے ہیں، لہذا workflow فائل ڈیزائن کے لحاظ سے remote code execution ہے۔ ایک private repository پر، ہر وہ شخص جسے workflow چلانے کی اجازت ہو، قابل اعتماد ہونا چاہیے، بشمول وہ لوگ جو fork pull requests بھیج سکتے ہیں جو رنر پر چلتی ہیں۔ public repository پر یہ ایک حقیقی خطرہ ہے، اور fork pull requests سے متعلق سیکشن اس میکانزم کی وضاحت کرتا ہے۔

ذیل میں دی گئی تمام ہدایات Ubuntu 24.04 اور runner ورژن 2.338.0 کے لیے ہیں، جو 12 اکتوبر 2026 تک کا موجودہ ریلیز ہے۔ GitHub کا تازہ ترین ریلیز 4 نومبر 2026 تک 2.338.2 ہے؛ ذیل میں دیے گئے کمانڈز اور checksum ورژن 2.338.0 کے مطابق ہی رہیں گے۔

شروع کرنے سے پہلے آپ کو کیا درکار ہے

ایک ایسے VPS سے شروعات کریں جس میں ایک عام ایڈمن اکاؤنٹ اور sudo موجود ہو، یہ وہ حالت ہے جو آپ نئے VPS پر پہلے دس منٹ میں حاصل کرتے ہیں۔ آپ کو کوئی ان باؤنڈ پورٹ کھولنے کی ضرورت نہیں ہے۔ رنر GitHub کے ساتھ ایک آؤٹ باؤنڈ HTTPS (ہائپر ٹیکسٹ ٹرانسفر پروٹوکول سیکیور) کنکشن کھولتا ہے اور کام کے انتظار میں اسے کھلا رکھتا ہے، لہذا GitHub کبھی بھی آپ کے سرور سے براہ راست کنیکٹ نہیں ہوتا ہے۔ آپ کا فائر وال دنیا کے لیے بند رہ سکتا ہے اور جابز پھر بھی موصول ہوتی رہیں گی۔

آپ کو ریپوزٹری پر ایڈمن حقوق کی بھی ضرورت ہے، کیونکہ رجسٹریشن ٹوکن ریپوزٹری کی ترتیبات (settings) میں دکھایا جاتا ہے۔

رنر کے لیے ایک مخصوص صارف بنائیں

رنر کو کبھی بھی root یا اپنے ایڈمن صارف کے طور پر نہ چلائیں۔ ہر جاب رنر صارف کے حقوق حاصل کر لیتی ہے، لہذا اگر رنر صارف sudo استعمال کر سکتا ہے تو sudo کو کال کرنے والا ورک فلو کامیاب ہو جائے گا۔ ایک ایسا غیر مراعات یافتہ (unprivileged) صارف بنائیں جس کی ملکیت میں اس کی ہوم ڈائریکٹری کے سوا کچھ نہ ہو۔ VPS پر کم سے کم مراعات والے صارف اکاؤنٹس عمومی طریقہ کار کا احاطہ کرتا ہے۔ یہاں مخصوص طریقہ درج ہے۔

sudo useradd -m -s /bin/bash gharunner
sudo passwd -l gharunner
sudo chmod 750 /home/gharunner
sudo install -d -m 700 -o gharunner -g gharunner /home/gharunner/actions-runner

passwd -l پاس ورڈ کو لاک کر دیتا ہے، تاکہ کوئی بھی اس کے ذریعے gharunner کے طور پر لاگ ان نہ ہو سکے۔ رنر ڈائریکٹری پر 700 موڈ اہم ہے کیونکہ رنر وہاں اپنی اسناد (credentials) کو سادہ متن (cleartext) میں محفوظ کرتا ہے، اور چیک آؤٹ میں نجی سورس کوڈ ہو سکتا ہے۔

مزید آگے بڑھنے سے پہلے دونوں خصوصیات کی جانچ کریں:

sudo passwd -S gharunner
sudo -l -U gharunner

passwd -S ایک لائن پرنٹ کرتا ہے جو gharunner L سے شروع ہوتی ہے، جہاں L کا مطلب ہے کہ پاس ورڈ لاک ہے۔ sudo -l -U gharunner کو is not allowed to run sudo کے ساتھ جواب دینا چاہیے۔ اگر یہ اس کے بجائے اجازت یافتہ کمانڈز کی فہرست پرنٹ کرتا ہے، تو اکاؤنٹ sudo گروپ میں ہے اور جو تنہائی (isolation) آپ نے ابھی بنائی ہے وہ ختم ہو چکی ہے۔

Runner ڈاؤن لوڈ کریں اور tarball کی جانچ کریں

اب سے runner صارف کے طور پر کام کریں۔

sudo -iu gharunner
cd ~/actions-runner
RUNNER_VERSION=2.338.0
curl -fL -o actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz \
  "https://github.com/actions/runner/releases/download/v${RUNNER_VERSION}/actions-runner-linux-x64-${RUNNER_VERSION}.tar.gz"

اگر architecture کے بارے میں یقین نہ ہو تو پہلے uname -m چلائیں۔ x86_64 اوپر دی گئی linux-x64 فائل استعمال کرتا ہے۔ aarch64 actions-runner-linux-arm64-${RUNNER_VERSION}.tar.gz استعمال کرتا ہے۔

اب ڈاؤن لوڈ کی گئی فائل کی تصدیق کریں۔ ذیل میں دیا گیا SHA256 (secure hash algorithm، 256 bit) 2.338.0 x64 tarball کے لیے ہے۔ GitHub موجودہ release کی یہ قدر release page اور New self-hosted runner screen پر دکھاتا ہے۔ یہ ہر version کے ساتھ تبدیل ہوتی ہے، اس لیے مختلف version انسٹال کرتے وقت یہ قدر وہاں سے copy کریں۔

echo "af4b794c1bc41d73d40535e3fe092a39f9679cd8d965954c2aca25a05ca41d32  actions-runner-linux-x64-2.338.0.tar.gz" | sha256sum -c

درست ڈاؤن لوڈ ایک سطر دکھاتا ہے:

actions-runner-linux-x64-2.338.0.tar.gz: OK

نامکمل یا تبدیل شدہ فائل failure اور warning دکھاتی ہے:

actions-runner-linux-x64-2.338.0.tar.gz: FAILED
sha256sum: WARNING: 1 computed checksum did NOT match

یہ check نظرانداز نہ کریں اور tar کو مسئلہ تلاش کرنے نہ دیں۔ ادھورا archive gzip: stdin: unexpected end of file اور tar: Unexpected EOF in archive کے ساتھ fail ہوتا ہے۔ اس سے معلوم ہوتا ہے کہ فائل خراب ہے، لیکن یہ نہیں معلوم ہوتا کہ فائل درمیان سے کٹ گئی ہے یا اس کی جگہ دوسری فائل رکھ دی گئی ہے۔

tar xzf ./actions-runner-linux-x64-2.338.0.tar.gz
ls

ٹار بال (tarball) میں کیا شامل ہے، اور کیا نہیں

ایکسٹریکشن کے بعد ڈائریکٹری میں config.sh، run.sh، env.sh، safe_sleep.sh، bin/ اور externals/ موجود ہوتے ہیں۔ bin/ میں رنر بائنریز اور bin/installdependencies.sh موجود ہوتے ہیں۔ externals/ میں بنڈل شدہ Node رن ٹائم موجود ہوتا ہے جس پر JavaScript ایکشنز عمل کرتی ہیں۔

ابھی تک یہاں کوئی svc.sh موجود نہیں ہے۔ GitHub کی دستاویزات اسے اسکرپٹ کے طور پر بیان کرتی ہیں "جو رنر کو کامیابی سے شامل کرنے کے بعد تخلیق ہوتا ہے"، کیونکہ یہ ایک ٹیمپلیٹ سے لکھا جاتا ہے جس میں آپ کی ریپوزٹری اور رنر کا نام سروس کے نام کے طور پر شامل ہوتا ہے۔ لہذا ./config.sh سے پہلے sudo ./svc.sh install چلانے پر sudo: ./svc.sh: command not found کی خرابی ظاہر ہوتی ہے۔ پہلے رجسٹر کریں، پھر سروس انسٹال کریں۔

Runner کی dependencies انسٹال کریں

Runner ایک .NET ایپلی کیشن ہے، اس لیے اسے چند shared libraries کی ضرورت ہوتی ہے۔ Runner کے صارف کی shell سے باہر نکلیں اور انہیں sudo کے ساتھ انسٹال کریں، کیونکہ اسکرپٹ سسٹم پیکیج ڈیٹا بیس میں لکھتا ہے۔

exit
cd /home/gharunner/actions-runner
sudo ./bin/installdependencies.sh

Ubuntu 24.04 پر یہ libkrb5-3، zlib1g، liblttng-ust1t64، libssl3t64 اور libicu74 کو pull کرتا ہے۔ اسکرپٹ ہر library کے لیے کئی version names آزماتا ہے اور وہی رکھتا ہے جو آپ کے release میں موجود ہو، اسی لیے یہی اسکرپٹ پرانے Ubuntu اور Debian پر بھی کام کرتا ہے۔

اگر ldd کے ساتھ چیک کی گئی کوئی library موجود نہ ہو، تو ./config.sh runner کو شروع کرنے سے پہلے رک جاتا ہے:

Dependencies is missing for Dotnet Core 6.0
Execute sudo ./bin/installdependencies.sh to install any missing Dotnet Core 6.0 dependencies.

libicu کی عدم موجودگی ایک مختلف پہلی لائن، Libicu's dependencies is missing for Dotnet Core 6.0 کے تحت وہی مشورہ دیتی ہے۔ دونوں ایک ہی جگہ سے آتے ہیں: config.sh شروع ہونے سے پہلے ldd کے ساتھ بنڈل شدہ libraries کو چیک کرتا ہے، اور libicu کو ldconfig کے ساتھ چیک کرتا ہے، تاکہ ایک unresolved link بعد میں الجھا دینے والے کریش کے بجائے اسکرپٹ کو فوراً روک دے۔ یہ چیکس ہر اس پیکیج کا احاطہ نہیں کرتے جو انسٹالر لسٹ کرتا ہے۔ liblttng-ust1t64 کی عدم موجودگی انہیں متحرک (trigger) نہیں کرتی: .NET LTTng ٹریسنگ کو اختیاری طور پر لوڈ کرتا ہے اور جب اس کی ٹریسنگ dependencies دستیاب نہ ہوں تو بھی جاری رہتا ہے۔

اپنے repository کے ساتھ runner رجسٹر کریں

repository سے token حاصل کریں۔ Settings کھولیں، پھر Actions، پھر Runners، اور اس کے بعد New self-hosted runner منتخب کریں۔ صفحے پر registration token دکھائی دے گا۔ یہ token بننے کے ایک گھنٹے بعد expire ہو جاتا ہے، اس لیے اسے paste کرنے کے لیے تیار ہونے پر ہی generate کریں۔

runner user کے طور پر رجسٹر کریں۔ config.sh کو sudo کے تحت چلانے سے انکار کرتا ہے۔

sudo -iu gharunner
cd ~/actions-runner
./config.sh --url https://github.com/YOUR-USER/YOUR-REPO \
  --token PASTE_REGISTRATION_TOKEN_HERE \
  --name vps-runner-1 \
  --labels vps \
  --work _work \
  --unattended \
  --replace

ان flags کا کام۔ --name یہ متعین کرتا ہے کہ repository میں runner کس نام سے ظاہر ہوگا، اس لیے ایسا نام منتخب کریں جسے آپ چھ ماہ بعد بھی پہچان سکیں۔ --labels آپ کے اپنے labels شامل کرتا ہے؛ runner کو بغیر کسی اضافی کارروائی کے پہلے ہی self-hosted، Linux اور X64 حاصل ہوتے ہیں۔ --work اس directory کا نام متعین کرتا ہے جہاں checkouts runner directory کے اندر رکھے جاتے ہیں۔ --unattended interactive prompts کے جواب میں ان کی default values استعمال کرتا ہے۔ جب command کسی script میں ہو تو یہی مطلوب ہوتا ہے۔ --replace اسی نام کی موجودہ registration کو دوبارہ رجسٹر کر لیتا ہے، بجائے اس کے کہ ناکام ہو جائے۔ server دوبارہ بنانے کے وقت یہی مطلوب ہوتا ہے۔

کامیاب execution کا اختتام ان lines پر ہوتا ہے:

√ Runner successfully added
√ Runner connection is good
√ Settings Saved.

اب registration runner directory میں .runner، .credentials اور .credentials_rsaparams کے طور پر محفوظ ہے۔ آخری دو GitHub کے سامنے اس runner کی شناخت کرتے ہیں، اس لیے جو بھی انہیں پڑھ سکتا ہے وہ اس runner کی نقالی کر سکتا ہے۔ اسی وجہ سے directory کا mode 700 ہے اور user کے پاس sudo نہیں ہے۔

رنر کو بطور systemd سروس انسٹال کریں

ٹرمینل میں ./run.sh ایک ٹیسٹ کے لیے ٹھیک ہے، لیکن آپ کے SSH سیشن کے ختم ہوتے ہی یہ بند ہو جاتا ہے۔ سروس کو انسٹال کریں تاکہ رنر بوٹ کے وقت خود بخود شروع ہو جائے۔ VPS پر systemd سروسز اور ٹائمرز یونٹ فائلز کی وضاحت کرتا ہے۔ یہاں svc.sh آپ کے لیے ایک فائل لکھتا ہے۔

exit
cd /home/gharunner/actions-runner
sudo ./svc.sh install gharunner
sudo ./svc.sh start
sudo ./svc.sh status

svc.sh کے لیے root درکار ہے کیونکہ یہ /etc/systemd/system میں ایک یونٹ لکھتا ہے اور اسے فعال کرتا ہے۔ install کے بعد کا آرگومنٹ وہ صارف ہے جس کے تحت سروس چلتی ہے۔ gharunner کو واضح طور پر پاس کریں۔ کسی آرگومنٹ کے بغیر اسکرپٹ $SUDO_USER پر واپس آ جاتی ہے، جو کہ آپ کا ایڈمن اکاؤنٹ ہے، اور پھر ہر جاب ایک ایسے صارف کے طور پر چلتی ہے جو sudo استعمال کر سکتا ہے۔

یونٹ کا نام ریپوزٹری اور رنر کے نام پر رکھا گیا ہے، جو actions.runner.YOUR-USER-YOUR-REPO.vps-runner-1.service کی شکل میں ہے۔ آپ کو اسے کبھی ٹائپ کرنے کی ضرورت نہیں ہے:

systemctl list-units 'actions.runner.*'
sudo journalctl -u 'actions.runner.*' -n 20 --no-pager

ایک درست رنر √ Connected to GitHub لاگ کرتا ہے اور اس کے بعد ایک لائن جو Listening for Jobs پر ختم ہوتی ہے، اور ریپوزٹری کا Runners صفحہ اسے Idle کے طور پر دکھاتا ہے۔ اگر رنر Offline دکھائے تو اس کا مطلب ہے کہ وہ چل نہیں رہا ہے یا پورٹ 443 پر GitHub تک رسائی حاصل نہیں کر سکتا۔

رنر کو جاب بھیجنا

runs-on لیبل کے ذریعے رنر کا انتخاب کرتا ہے۔ self-hosted کے ساتھ اپنا لیبل شامل کریں، تاکہ جاب کسی ایسے رنر پر نہ چلی جائے جس کا آپ نے ارادہ نہیں کیا تھا۔

name: build
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: [self-hosted, linux, vps]
    steps:
      - uses: actions/checkout@v5
      - run: uname -a

اگر جاب Waiting for a runner to pick up this job پر انتظار کر رہی ہو، تو چیک کریں کہ مماثل رنر آن لائن اور فارغ (idle) ہے۔ runs-on میں موجود ہر لیبل کا رنر پر موجود ہونا ضروری ہے، لہذا ایک اضافی لفظ جاب کو تب تک قطار میں رکھے گا جب تک کہ کوئی مماثل رنر دستیاب نہ ہو جائے یا 24 گھنٹے بعد جاب ناکام نہ ہو جائے۔ اس فہرست کا موازنہ ریپوزٹری سیٹنگز میں رنر کے ساتھ دکھائے گئے لیبلز سے کریں۔

خود میزبان (self-hosted) رنرز اور عوامی ریپوزٹریز کا ملاپ کیوں خطرناک ہے

یہ وہ حصہ ہے جسے لوگ نظر انداز کر دیتے ہیں۔ GitHub کی ہدایات واضح ہیں: خود میزبان رنرز کو "عوامی ریپوزٹریز کے لیے تقریباً کبھی استعمال نہیں کیا جانا چاہیے"، اور ان کے بارے میں "یہ ضمانت نہیں دی جا سکتی کہ وہ عارضی اور صاف ستھری ورچوئل مشینوں پر چل رہے ہیں، اور انہیں ورک فلو میں موجود غیر معتبر کوڈ کے ذریعے مستقل طور پر compromised کیا جا سکتا ہے"۔

اس کا طریقہ کار سادہ ہے۔ کسی fork سے آنے والی pull request اپنے ساتھ ورک فلو فائل کی کاپی لاتی ہے۔ اگر آپ کی عوامی ریپوزٹری اپنے رنر پر pull request ورک فلو چلاتی ہے، تو کوئی بھی شخص جو ریپوزٹری کو fork کر سکتا ہے، وہ ایسا ورک فلو تجویز کر سکتا ہے جو آپ کے VPS پر اس کے کمانڈز چلائے۔ انہیں write access کی ضرورت نہیں ہوتی، کیونکہ جو چیز وہ تجویز کر رہے ہوتے ہیں، وہی رن ہوتی ہے۔

منظوری کی ترتیبات (approval settings) اس مسئلے کو حل کیے بغیر کچھ حد تک کم کر دیتی ہیں۔ عوامی ریپوزٹری کے لیے ڈیفالٹ پالیسی یہ ہے کہ پہلی بار حصہ لینے والے کے fork ورک فلو کو ایک مینٹینر منظور کرے۔ GitHub کسی کو تب تک "پہلی بار حصہ لینے والا" شمار کرتا ہے جب تک کہ اس کی کوئی کمٹ یا pull request ریپوزٹری میں ضم (merge) نہ ہو جائے۔ اس کے بعد، ان کی اگلی pull requests بغیر کسی توثیق کے چلتی ہیں، اور GitHub خود خبردار کرتا ہے کہ ایک معمولی سا merge شدہ فکس بھی اس مقصد کے لیے کافی ہے۔ لہذا، یہ رکاوٹ ایک انسان کا diff پڑھنا ہے، اور بلڈ اسکرپٹ میں تین سطح نیچے چھپایا گیا پے لوڈ (payload) نظر انداز کرنا بہت آسان ہے۔

ایک fork pull request کو آپ کے secrets نہیں ملتے، اور اس کا GITHUB_TOKEN صرف پڑھنے (read-only) کے لیے ہوتا ہے۔ یہ GitHub کے اندر نقصان کو محدود کرتا ہے۔ لیکن یہ آپ کے سرور کے لیے کچھ نہیں کرتا۔ حملہ آور کے پاس gharunner کے طور پر شیل (shell) ہوتا ہے، لہذا وہ ہر اس فائل کو پڑھ سکتا ہے جسے وہ صارف پڑھ سکتا ہے، پرائیویٹ نیٹ ورک پر موجود ہر چیز تک پہنچ سکتا ہے، اور ~/.bashrc یا کسی یوزر systemd یونٹ میں کچھ ایسا چھوڑ سکتا ہے جو اگلی جاب کے دوران چلے۔

--ephemeral کے ساتھ رجسٹر کرنے سے رنر ایک جاب قبول کرنے کے بعد خود کو ڈی رجسٹر کر لیتا ہے؛ لیکن یہ اس جاب کے ورک اسپیس کو مٹاتا نہیں ہے۔ یہ صرف تب مددگار ہوتا ہے اگر کوئی چیز ہر جاب کے لیے مشین یا کنٹینر کو دوبارہ تعمیر (rebuild) کرے، کیونکہ رنر صارف کی ہوم ڈائریکٹری میں لکھا گیا بیک ڈور ایک نئی رجسٹریشن کے بعد بھی باقی رہتا ہے۔

ذیل میں دیے گئے اصول مختصر ہیں۔ خود میزبان رنرز کو صرف نجی (private) ریپوزٹریز کے لیے استعمال کریں۔ اگر آپ کو اسے کسی عوامی ریپوزٹری کے ساتھ منسلک کرنا ہی پڑے، تو اس پر fork pull requests نہ چلائیں، اس سرور پر کچھ اور نہ رکھیں، اور مشین کو قابلِ تلف (disposable) سمجھیں۔

Docker jobs، اور وہ گروپ جو درحقیقت root ہے

Container jobs، service containers اور کوئی بھی workflow step جو docker build کو کال کرتا ہے، اسے runner host پر Docker daemon کی ضرورت ہوتی ہے۔ Docker کو معمول کے طریقے سے انسٹال کریں، جس کا احاطہ Docker and Docker Compose on a VPS میں کیا گیا ہے، پھر runner صارف کو docker گروپ میں شامل کریں۔

اس اقدام سے پہلے اس کے مضمرات کو سمجھ لیں۔ docker گروپ کی رکنیت root کے برابر ہے، کیونکہ ایک container / کو bind mount کر سکتا ہے اور اس کے اندر root کے طور پر چل سکتا ہے۔ لہذا، ایک workflow جو Docker socket سے بات کر سکتا ہے، وہ VPS پر موجود ہر فائل کو پڑھ اور لکھ سکتا ہے، بشمول /etc/shadow۔ ایک نجی repository پر جہاں قابل اعتماد contributors موجود ہوں، یہ ایک قابل قبول قیمت ہو سکتی ہے۔ کسی بھی دوسری جگہ، یہ غیر مراعات یافتہ (unprivileged) صارف کے مقصد کو ختم کر دیتا ہے۔ Rootless Docker کنٹینر بلڈز کو runner صارف کے اپنے حقوق کے اندر رکھتا ہے، جس میں storage driver اور networking کی حدود ہوتی ہیں؛ container capabilities میزبان (host) پر مراعات نہیں دیتیں۔

اپ ڈیٹس، اور رنر کو مکمل طور پر ہٹانا

ایک self-hosted رنر بائی ڈیفالٹ خود کو اپ ڈیٹ کرتا ہے۔ یہ ایک نئی ریلیز کی نشاندہی کرتا ہے، اپنی فائلیں تبدیل کرتا ہے اور سروس کو دوبارہ شروع کرتا ہے، لہذا عام طور پر آپ کو کچھ کرنے کی ضرورت نہیں ہوتی۔ خودکار اپ ڈیٹ کو بند کرنے کے لیے، رنر رجسٹر کرتے وقت --disableupdate کو ./config.sh کے ساتھ پاس کریں۔ پہلے سے رجسٹرڈ رنر پر، اس کا مطلب ہے کہ اسے اس فلیگ کے ساتھ دوبارہ رجسٹر کیا جائے۔ یہ آپ کو ہمیشہ کے لیے ایک ہی ورژن پر رہنے کی اجازت نہیں دیتا۔ GitHub کی دستاویزات واضح کرتی ہیں کہ --disableupdate کے ساتھ کنفیگر کردہ رنر کو بھی نئی ریلیز کے 30 دنوں کے اندر دستی طور پر اپ ڈیٹ کرنا پڑتا ہے، ورنہ GitHub اس پر جابز کی قطار لگانا بند کر دیتا ہے۔ ایک اہم سیکیورٹی اپ ڈیٹ اس ڈیڈ لائن کا انتظار کیے بغیر، اپ ڈیٹ کرنے تک جابز کو قطار میں لگنے سے روک سکتی ہے۔

دستی اپ ڈیٹ رجسٹریشن کو برقرار رکھتا ہے، کیونکہ .runner اور .credentials ٹار بال (tarball) میں شامل نہیں ہوتے۔ سروس کو روکیں، نئے ٹار بال کو gharunner کے طور پر ڈاؤن لوڈ اور چیک سم (checksum) کریں، اسے tar xzf کے ساتھ اسی ڈائریکٹری میں ایکسٹریکٹ کریں، اور پھر سروس کو دوبارہ شروع کریں:

cd /home/gharunner/actions-runner
sudo ./svc.sh stop
sudo ./svc.sh start

رنر کو ہٹانے کے لیے، پہلے سروس کو ان انسٹال کریں، پھر ڈی رجسٹر (deregister) کریں۔ ریموول ٹوکن اسی Runners صفحہ سے، رنر کے اپنے Remove بٹن کے نیچے سے حاصل ہوتا ہے۔

cd /home/gharunner/actions-runner
sudo ./svc.sh stop
sudo ./svc.sh uninstall
sudo -iu gharunner
cd ~/actions-runner
./config.sh remove --token PASTE_REMOVAL_TOKEN_HERE

ڈی رجسٹر کیے بغیر ڈائریکٹری کو ڈیلیٹ کرنے سے رنر ریپوزٹری میں Offline کے طور پر درج رہتا ہے۔ یہ تب تک وہاں رہتا ہے جب تک کوئی ایڈمن Force remove this runner پر کلک نہ کرے، یا جب تک GitHub اسے 14 دن تک کنکشن نہ ہونے کے بعد خود بخود ہٹا نہ دے۔

خرابی کی صورتیں، اور وہ پیغامات جو آپ دیکھیں گے

Must not run with sudo۔ جب اسے root کے طور پر چلایا جاتا ہے تو config.sh یہ پیغام دکھا کر بند ہو جاتا ہے۔ یہ جانچ دانستہ رکھی گئی ہے، کیونکہ _work میں root کی ملکیت والی فائلیں service user کے طور پر چلنے والی ہر بعد کی job کو ناکام بنا دیتی ہیں۔ ./config.sh کو gharunner کے طور پر چلائیں۔ RUNNER_ALLOW_RUNASROOT variable اس جانچ کو override کرتا ہے، لیکن اسے استعمال کرنے سے خرابی صرف بعد میں ظاہر ہوتی ہے۔

sudo: ./svc.sh: command not found۔ آپ درست directory میں ہیں۔ svc.sh ابھی موجود نہیں ہے، کیونکہ config.sh نے ابھی registration مکمل نہیں کی۔ Runner کو register کریں، پھر service install کریں۔

Http response code: NotFound from 'POST https://api.github.com/actions/runner-registration'۔ عموماً token درست registration token نہیں ہوتا۔ یا تو یہ expire ہو چکا ہے، کیونکہ اس کی مدت صرف ایک گھنٹہ ہوتی ہے، یا Runners page کے registration token کے بجائے personal access token paste کیا گیا ہے۔ نیا token generate کرکے دوبارہ paste کریں، اور تصدیق کریں کہ --url مکمل repository URL ہے۔

Dependencies is missing for Dotnet Core 6.0۔ sudo ./bin/installdependencies.sh کو runner directory سے root کے طور پر چلائیں، پھر دوبارہ register کریں۔

Reboot کے بعد Runner Offline۔ systemctl is-enabled 'actions.runner.*' چلائیں۔ اگر کوئی چیز فہرست میں شامل نہ ہو تو ./svc.sh install کبھی نہیں چلایا گیا، اس لیے runner صرف آپ کے terminal session کے اندر موجود تھا۔ اگر unit enabled ہے اور runner اب بھی Offline ہے تو journalctl -u 'actions.runner.*' پڑھیں اور outbound HTTPS کی جانچ کریں۔

Disk بھر جاتی ہے۔ Checkouts، build caches اور Docker images _work اور runner user کی home directory میں جمع ہوتے رہتے ہیں، اور انہیں خودکار طور پر prune کرنے والا کوئی عمل موجود نہیں ہوتا۔ du -sh /home/gharunner/actions-runner/_work کو monitor کریں اور scheduled clean-up شامل کریں، اس سے پہلے کہ disk کی دستیاب جگہ ختم ہو جائے۔

FAQ

sudo ./svc.sh install میں command not found کیوں دکھائی دیتا ہے؟

کیونکہ svc.sh runner tarball میں موجود نہیں ہے۔ ./config.sh کی registration مکمل ہونے پر یہ runner directory میں generate ہوتا ہے۔ اس عمل میں repository اور runner name استعمال کر کے service name بنایا جاتا ہے۔ پہلے runner user کے طور پر ./config.sh چلائیں۔ اس کے بعد sudo ./svc.sh install gharunner کو script مل جائے گی، اور یہ /etc/systemd/system میں actions.runner.OWNER-REPO.RUNNER-NAME.service نام کی unit لکھ دے گی۔

کیا self-hosted runner کے لیے firewall port کھولنا ضروری ہے؟

نہیں۔ runner GitHub سے outbound HTTPS connection کھولتا ہے اور jobs کا انتظار کرتے وقت اسے برقرار رکھتا ہے۔ اس لیے GitHub آپ کے VPS سے connection شروع نہیں کرتا۔ outbound 443 کی اجازت دیں اور inbound rules بند رکھیں۔ اگر service چلنے کے باوجود runner Offline دکھائے تو inbound rules کے بجائے outbound filtering اور DNS دیکھیں۔

کیا میں public repository پر self-hosted runner استعمال کر سکتا ہوں؟

آپ ایسا کر سکتے ہیں، لیکن GitHub اس کی سفارش نہیں کرتا۔ fork سے آنے والی pull request اپنی workflow file رکھتی ہے۔ اس لیے جو شخص آپ کی repository کو fork کر سکتا ہے، وہ ایسی commands تجویز کر سکتا ہے جو آپ کی machine پر چلیں۔ default approval prompt صرف ان contributors کا احاطہ کرتا ہے جن کی کوئی commit یا pull request repository میں کبھی merge نہیں ہوئی۔ اگر آپ runner کو public repository سے attach کریں تو اس پر fork pull request workflows disable کریں، اس server پر کوئی اور چیز نہ رکھیں، اور مقررہ schedule کے مطابق machine کو rebuild کریں۔

Http response code: NotFound کے ساتھ registration کیوں ناکام ہوتی ہے؟

credential غلط ہونے پر registration call NotFound واپس دیتی ہے، صرف URL غلط ہونے کی صورت میں نہیں۔ اسی لیے یہ message گمراہ کن ہو سکتا ہے۔ registration tokens دکھائے جانے کے ایک گھنٹے بعد expire ہو جاتے ہیں، اور personal access token اس call کے لیے قبول نہیں کیا جاتا۔ دوبارہ Settings، Actions، Runners، New self-hosted runner کھولیں، تازہ token copy کریں، اور تصدیق کریں کہ --url value ایسی repository کی طرف اشارہ کرتی ہے جہاں آپ کے پاس admin rights ہیں۔

کیا یہ مضمون مفید تھا؟

#github-actions#ci#self-hosted#runner#ubuntu-24-04