SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor · अपडेटेड 2026-11-07

Ubuntu 24.04 वर Self-hosted GitHub Actions Runner सेटअप

Ubuntu 24.04 वर GitHub Actions runner कसे सेट करावे हे शिका. यात डेडिकेटेड युजर, चेकसम पडताळणी, config.sh कमांड, systemd सर्व्हिस आणि फोर्क पुल रिक्वेस्टचे सुरक्षा धोके समाविष्ट आहेत.

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) विचारणा करतो आणि ती कामे तुमच्या हार्डवेअरवर पूर्ण करतो. तुम्ही तो एका रिपॉझिटरीसाठी रजिस्टर करता, systemd सर्व्हिस म्हणून इन्स्टॉल करता आणि रीबूटनंतर तो आपोआप पुन्हा सुरू होतो. GitHub कामाचे वेळापत्रक ठरवते, तर तुमचा सर्व्हर ते काम पूर्ण करतो.

तुमच्या मालकीच्या सर्व्हरवर CI (continuous integration) चालवणे दोन कारणांसाठी फायदेशीर ठरते. बिल्ड मिनिटांची मोजणी थांबते आणि अशा गोष्टींपर्यंत जॉब पोहोचू शकतो ज्या फक्त तुमच्या मशीनला उपलब्ध आहेत, जसे की वॉर्म बिल्ड कॅशे किंवा प्रायव्हेट नेटवर्क. याची किंमत सुरक्षेच्या स्वरूपात मोजावी लागते. रनर वर्कफ्लो फाइलमध्ये दिलेली कोणतीही आज्ञा तुम्ही दिलेल्या युजरच्या अधिकारात कार्यान्वित करतो, त्यामुळे वर्कफ्लो फाइल ही डिझाइननुसारच रिमोट कोड एक्झिक्युशन (RCE) असते. प्रायव्हेट रिपॉझिटरीवर, ज्यांना वर्कफ्लो चालवण्याची परवानगी आहे अशा सर्वांवर विश्वास असणे आवश्यक आहे, ज्यामध्ये अशा लोकांचाही समावेश होतो जे फोर्क पुल रिक्वेस्ट सबमिट करू शकतात आणि त्या रनरवर चालतात. पब्लिक रिपॉझिटरीवर हा एक मोठा धोका आहे आणि फोर्क पुल रिक्वेस्टवरील विभाग या यंत्रणेचे स्पष्टीकरण देतो.

खालील सर्व माहिती Ubuntu 24.04 आणि runner version 2.338.0 साठी आहे, जे 12 October 2026 पर्यंतचे अधिकृत रिलीज आहे. 4 November 2026 पर्यंत GitHub चे लेटेस्ट रिलीज 2.338.2 आहे; खालील कमांड्स आणि चेकसम 2.338.0 या आवृत्तीसाठीच निश्चित (pinned) ठेवले आहेत.

सुरू करण्यापूर्वी आवश्यक गोष्टी

एका VPS पासून सुरुवात करा ज्यामध्ये सामान्य ॲडमिन खाते आणि sudo प्रवेश आहे, जी स्थिती तुम्हाला नवीन VPS वरील पहिली दहा मिनिटे मध्ये मिळते. तुम्हाला कोणताही इनबाउंड पोर्ट उघडण्याची गरज नाही. रनर GitHub कडे एक आउटबाउंड HTTPS (हायपरटेक्स्ट ट्रान्सफर प्रोटोकॉल सिक्युअर) कनेक्शन उघडतो आणि कामाची प्रतीक्षा करत असताना ते चालू ठेवतो, त्यामुळे GitHub कधीही तुमच्या सर्व्हरशी थेट कनेक्ट होत नाही. तुमचा फायरवॉल जगासाठी बंद राहू शकतो आणि तरीही जॉब्स प्राप्त होतात.

तुम्हाला रिपॉझिटरीवर ॲडमिन अधिकार असणे देखील आवश्यक आहे, कारण नोंदणी टोकन रिपॉझिटरी सेटिंग्जमध्ये दर्शविले जाते.

रनरसाठी एक समर्पित वापरकर्ता तयार करा

रनर कधीही root म्हणून किंवा तुमच्या स्वतःच्या ॲडमिन वापरकर्त्याच्या खात्यातून चालवू नका. प्रत्येक जॉब रनर वापरकर्त्याचे अधिकार वारशाने घेतो, त्यामुळे जर रनर वापरकर्ता sudo वापरू शकत असेल, तर sudo कॉल करणारा वर्कफ्लो यशस्वी होतो. एक असा अनप्रिव्हिलेज्ड (कमी अधिकार असलेला) वापरकर्ता तयार करा ज्याच्याकडे स्वतःच्या होम डिरेक्टरीव्यतिरिक्त कशाचीही मालकी नसेल. 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 मोड असणे महत्त्वाचे आहे कारण रनर आपली क्रेडेन्शियल्स तिथे प्लेनटेक्स्टमध्ये साठवतो आणि चेकआउटमध्ये खाजगी सोर्स कोड असू शकतो.

पुढे जाण्यापूर्वी दोन्ही गुणधर्मांची खात्री करा:

sudo passwd -S gharunner
sudo -l -U gharunner

passwd -S एक ओळ प्रिंट करते जी gharunner L ने सुरू होते, जिथे L चा अर्थ पासवर्ड लॉक आहे असा होतो. sudo -l -U gharunner ने is not allowed to run sudo असे उत्तर दिले पाहिजे. जर त्याऐवजी परवानगी असलेल्या कमांड्सची यादी प्रिंट झाली, तर ते खाते sudo ग्रुपमध्ये आहे आणि तुम्ही तयार केलेले आयसोलेशन (विलगीकरण) नष्ट झाले आहे.

Runner डाउनलोड करा आणि tarball तपासा

यापुढील काम runner user म्हणून करा.

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 file स्वीकारते. aarch64 actions-runner-linux-arm64-${RUNNER_VERSION}.tar.gz स्वीकारते.

आता डाउनलोड केलेली file पडताळा. खालील SHA256 (secure hash algorithm, 256 bit) ही 2.338.0 x64 tarball साठीची आहे. GitHub release page आणि New self-hosted runner screen वर सध्याच्या release साठीचे मूल्य दाखवते. प्रत्येक version सोबत ते बदलते. त्यामुळे वेगळी version install करताना तेथून मूल्य copy करा.

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

डाउनलोड योग्य असल्यास एक ओळ दिसते:

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

अपूर्ण किंवा बदललेली file असल्यास failure आणि warning दिसतात:

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

ही तपासणी वगळून समस्या शोधण्याचे काम tar वर सोडू नका. अर्धवट लिहिलेल्या archive मुळे gzip: stdin: unexpected end of file आणि tar: Unexpected EOF in archive अपयशी होतात. यावरून file खराब आहे हे समजते, पण ती अपूर्ण राहिली आहे की बदलून ठेवली आहे हे समजत नाही.

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

टार्बॉलमध्ये काय समाविष्ट आहे आणि काय नाही

एक्सट्रॅक्शननंतर डिरेक्टरीमध्ये 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) डिपेंडन्सीज इन्स्टॉल करा

रनर हे एक .NET ॲप्लिकेशन आहे, त्यामुळे त्याला काही शेअर्ड लायब्ररीजची आवश्यकता असते. रनर युजरच्या शेलमधून बाहेर पडा आणि sudo वापरून त्या इन्स्टॉल करा, कारण स्क्रिप्ट सिस्टम पॅकेज डेटाबेसमध्ये बदल करते.

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

Ubuntu 24.04 वर हे libkrb5-3, zlib1g, liblttng-ust1t64, libssl3t64 आणि libicu74 खेचून घेते. स्क्रिप्ट प्रत्येक लायब्ररीसाठी अनेक व्हर्जन नावांचा प्रयत्न करते आणि तुमच्या रिलीजमध्ये उपलब्ध असलेले व्हर्जन निवडते, म्हणूनच हीच स्क्रिप्ट जुन्या Ubuntu आणि Debian वर देखील काम करते.

जर ldd ने तपासलेली एखादी लायब्ररी गहाळ असेल, तर रनर सुरू करण्यापूर्वी ./config.sh थांबते:

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 सह बंडल केलेल्या लायब्ररीज तपासते आणि libicu हे ldconfig सह तपासते. त्यामुळे, नंतर गोंधळात टाकणारा क्रॅश होण्याऐवजी, न सुटलेली लिंक (unresolved link) स्क्रिप्टला आधीच थांबवते. हे चेक इन्स्टॉलरने सूचीबद्ध केलेल्या प्रत्येक पॅकेजला कव्हर करत नाहीत. गहाळ liblttng-ust1t64 मुळे हे चेक ट्रिगर होत नाहीत: .NET हे LTTng ट्रेसिंग ऐच्छिक (optionally) लोड करते आणि ट्रेसिंगच्या डिपेंडन्सीज उपलब्ध नसल्यास ते सुरू राहते.

रिपॉझिटरीसह runner नोंदणी करा

रिपॉझिटरीमधून token मिळवा. Settings, त्यानंतर Actions, त्यानंतर Runners आणि मग New self-hosted runner उघडा. त्या पृष्ठावर registration token दिसतो. तो तयार केल्यानंतर एक तासाने कालबाह्य होतो. त्यामुळे तो paste करण्यासाठी तयार असताना token तयार करा.

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 मुळे runner रिपॉझिटरीमध्ये कसा दिसेल ते ठरते. त्यामुळे सहा महिन्यांनंतरही ओळखता येईल असे नाव निवडा. --labels तुमचे स्वतःचे labels जोडतो. runner ला self-hosted, Linux आणि X64 हे labels आधीपासूनच मिळतात. --work checkout files ज्या directory मध्ये ठेवले जातील तिचे नाव देतो. ही directory runner directory च्या आत असते. --unattended interactive prompts साठी त्यांची default values वापरतो. command script मध्ये ठेवला असताना हेच अपेक्षित असते. --replace त्याच नावाची विद्यमान registration आढळल्यास अपयशी होण्याऐवजी तिच्यावर ताबा घेतो. server पुन्हा तयार करताना हेच अपेक्षित असते.

यशस्वी run च्या शेवटी या ओळी दिसतात:

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

आता registration runner directory मध्ये .runner, .credentials आणि .credentials_rsaparams म्हणून साठवली जाते. शेवटच्या दोन files GitHub कडे या runner ची ओळख सिद्ध करतात. त्यामुळे त्या files वाचू शकणारी कोणतीही व्यक्ती runner चे अनुकरण करू शकते. याच कारणामुळे directory चा mode 700 आहे आणि user कडे sudo अधिकार नाही.

runner ला systemd सर्व्हिस म्हणून इन्स्टॉल करणे

./run.sh टर्मिनलमध्ये वापरणे एका चाचणीसाठी ठीक आहे, परंतु SSH सेशन बंद होताच ते थांबते. सर्व्हिस इन्स्टॉल करा जेणेकरून बूट होताना runner आपोआप सुरू होईल. 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 वापरू शकतो.

युनिटचे नाव रिपॉझिटरी आणि runner वरून actions.runner.YOUR-USER-YOUR-REPO.vps-runner-1.service या स्वरूपात ठेवले जाते. तुम्हाला ते पूर्ण टाइप करण्याची गरज नाही:

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

एक कार्यरत runner √ Connected to GitHub आणि त्यानंतर Listening for Jobs ने संपणारी ओळ लॉग करते, आणि रिपॉझिटरीच्या Runners पेजवर तो Idle म्हणून दिसतो. जर runner 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 runners आणि public repositories का एकत्र वापरू नयेत

हा तो भाग आहे जो लोक दुर्लक्षित करतात. GitHub चे मार्गदर्शन स्पष्ट आहे: self-hosted runners "public repositories साठी जवळजवळ कधीही वापरू नयेत", आणि "ते ephemeral clean virtual machines वर चालण्याची कोणतीही खात्री देत नाहीत, आणि workflow मधील untrusted code मुळे ते कायमस्वरूपी compromised होऊ शकतात".

याची कार्यपद्धती सोपी आहे. Fork कडून आलेली pull request स्वतःची workflow file ची प्रत घेऊन येते. जर तुमची public repository तुमच्या runner वर pull request workflows चालवत असेल, तर कोणीही जो repository fork करू शकतो, तो अशी workflow सुचवू शकतो जी त्यांच्या commands तुमच्या VPS वर चालवेल. त्यांना write access ची गरज नसते, कारण ते जे सुचवत आहेत तीच गोष्ट रन होत असते.

Approval settings मुळे हा धोका कमी होतो पण तो पूर्णपणे संपत नाही. Public repository साठीची default policy maintainer ला पहिल्यांदाच योगदान देणाऱ्याच्या fork workflow ला approve करण्यास सांगते. GitHub एखाद्या व्यक्तीला पहिल्यांदाच योगदान देणारा तेव्हाच मानतो जोपर्यंत त्यांची कोणतीही commit किंवा pull request repository मध्ये merge झालेली नसते. त्यानंतर, त्यांच्या पुढील pull requests कोणत्याही सूचनेशिवाय चालतात, आणि GitHub स्वतः इशारा देते की एक साधा merge केलेला fix तिथे पोहोचण्यासाठी पुरेसा आहे. त्यामुळे, मानवी स्तरावर diff वाचणे हाच एक अडथळा असतो, आणि build script मध्ये तीन स्तरांखाली लपवलेला payload शोधणे कठीण असते.

Fork pull request ला तुमचे secrets मिळत नाहीत, आणि तिचे GITHUB_TOKEN read-only असते. हे GitHub मधील नुकसान मर्यादित करते. पण तुमच्या सर्व्हरसाठी याचा काहीही उपयोग होत नाही. हल्लेखोराकडे gharunner म्हणून shell असते, त्यामुळे ते त्या user ला वाचता येणारी प्रत्येक फाईल वाचू शकतात, VPS च्या private network वर पोहोचू शकतात, आणि ~/.bashrc मध्ये किंवा पुढच्या job दरम्यान चालणाऱ्या user systemd unit मध्ये काहीतरी मागे सोडू शकतात.

--ephemeral सह register केल्यामुळे runner एक job स्वीकारतो आणि नंतर deregister होतो; पण ते त्या job चे workspace पुसत नाही. जर प्रत्येक job साठी मशीन किंवा कंटेनर पुन्हा तयार (rebuild) होत असेल तरच याचा उपयोग होतो, कारण runner user च्या home directory मध्ये लिहिलेला backdoor नवीन registration नंतरही टिकून राहतो.

खालील नियम छोटे आहेत. Self-hosted runners private repositories साठी वापरा. जर तुम्हाला ते public repository ला जोडणे अनिवार्य असेल, तर त्यावर fork pull requests चालवू नका, त्या सर्व्हरवर इतर काहीही ठेवू नका, आणि त्या मशीनला disposable (फेकून देण्यायोग्य) समजा.

Docker जॉब्स आणि खऱ्या अर्थाने root असलेला ग्रुप

कंटेनर जॉब्स, सर्व्हिस कंटेनर आणि docker build कॉल करणारी कोणतीही वर्कफ्लो स्टेप यासाठी रनर होस्टवर Docker डेमनची आवश्यकता असते. Docker नेहमीच्या पद्धतीने इन्स्टॉल करा, ज्याची माहिती Docker and Docker Compose on a VPS मध्ये दिली आहे, त्यानंतर रनर युजरला docker ग्रुपमध्ये ॲड करा.

हे करण्यापूर्वी त्याचे परिणाम समजून घ्या. docker ग्रुपचे सदस्यत्व असणे म्हणजे root असण्यासारखेच आहे, कारण एखादा कंटेनर / ला bind mount करू शकतो आणि त्यामध्ये root म्हणून रन होऊ शकतो. त्यामुळे जो वर्कफ्लो Docker सॉकेटशी संवाद साधू शकतो, तो VPS वरील /etc/shadow सह प्रत्येक फाईल वाचू आणि लिहू शकतो. विश्वासू योगदानकर्ते असलेल्या खाजगी रिपॉझिटरीसाठी ही किंमत स्वीकारार्ह असू शकते. इतर कोणत्याही ठिकाणी यामुळे अनप्रिव्हिलेज्ड युजर असण्याचा उद्देशच संपतो. Rootless Docker कंटेनर बिल्ड्सना रनर युजरच्या स्वतःच्या अधिकारांच्या मर्यादेत ठेवते, ज्यामध्ये स्टोरेज ड्रायव्हर आणि नेटवर्किंगच्या मर्यादा असतात; कंटेनर कॅपॅबिलिटीज होस्टवर कोणतेही विशेष अधिकार प्रदान करत नाहीत.

अपडेट्स आणि रनर सुरक्षितपणे काढून टाकणे

सेल्फ-होस्टेड रनर डीफॉल्टनुसार स्वतःला अपडेट करतो. जेव्हा त्याला नवीन रिलीज आढळते, तेव्हा तो स्वतःच्या फाइल्स बदलतो आणि सर्व्हिस रीस्टार्ट करतो, त्यामुळे तुम्हाला सहसा काहीही करण्याची गरज नसते. सेल्फ-अपडेट बंद करण्यासाठी, रनर रजिस्टर करताना ./config.sh ला --disableupdate हा फ्लॅग द्या; जर तुम्ही रनर आधीच रजिस्टर केला असेल, तर याचा अर्थ तुम्हाला तो फ्लॅग वापरून पुन्हा रजिस्टर करावा लागेल. यामुळे तुम्ही कायमस्वरूपी एकाच व्हर्जनवर राहू शकत नाही. GitHub चे डॉक्युमेंटेशन स्पष्टपणे सांगते की --disableupdate सह कॉन्फिगर केलेल्या रनरला नवीन रिलीजच्या 30 दिवसांच्या आत हाताने अपडेट करावेच लागते, अन्यथा GitHub त्यावर जॉब्स क्यू (queue) करणे थांबवते. एखादे गंभीर सुरक्षा अपडेट (critical security update) त्या मुदतीची वाट न पाहता, तुम्ही अपडेट करेपर्यंत जॉब्स क्यू करणे थांबवू शकते.

मॅन्युअल अपडेट केल्याने रजिस्ट्रेशन कायम राहते, कारण .runner आणि .credentials हे टार्बॉलमध्ये नसतात. सर्व्हिस थांबवा, नवीन टार्बॉल डाउनलोड करा आणि gharunner वापरून त्याचे चेकसम तपासा, त्यानंतर tar xzf वापरून त्याच डिरेक्टरीमध्ये ते एक्सट्रॅक्ट करा आणि शेवटी सर्व्हिस पुन्हा सुरू करा:

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

रनर काढून टाकण्यासाठी, आधी सर्व्हिस अनइन्स्टॉल करा आणि त्यानंतर डीरजिस्टर करा. रिमूव्हल टोकन त्याच 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 वर क्लिक करत नाही किंवा 14 दिवस कनेक्शन नसल्यामुळे GitHub तो आपोआप काढून टाकत नाही, तोपर्यंत तो तिथेच राहतो.

अपयशाच्या स्थिती आणि दिसणारे संदेश

Must not run with sudo. root म्हणून चालवल्यावर config.sh हा संदेश दाखवतो आणि बंद होतो. ही तपासणी जाणीवपूर्वक केली आहे, कारण _work मधील root-owned फाइल्स 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 नसतो. तो कालबाह्य झालेला असू शकतो, कारण त्याची validity केवळ one hour असते. किंवा Runners page वरील registration token ऐवजी personal access token paste केलेला असू शकतो. नवीन token तयार करून तो पुन्हा paste करा. तसेच --url ही पूर्ण repository URL आहे का ते तपासा.

Dependencies is missing for Dotnet Core 6.0. runner directory मधून root म्हणून sudo ./bin/installdependencies.sh चालवा आणि त्यानंतर पुन्हा register करा.

रीबूटनंतर Runner Offline. systemctl is-enabled 'actions.runner.*' चालवा. काहीही सूचीबद्ध न झाल्यास ./svc.sh install कधीच चालवले गेले नव्हते. त्यामुळे runner फक्त तुमच्या terminal session मध्येच अस्तित्वात होता. unit enabled असूनही runner Offline असल्यास journalctl -u 'actions.runner.*' वाचा आणि outbound HTTPS तपासा.

डिस्क भरून जाते. Checkouts, build caches आणि Docker images _work अंतर्गत तसेच runner user च्या home मध्ये साठत जातात. त्यांना आपोआप prune करणारी कोणतीही प्रक्रिया नसते. du -sh /home/gharunner/actions-runner/_work वर लक्ष ठेवा आणि डिस्क स्वतः निर्णय घेण्यापूर्वी scheduled clean-up जोडा.

FAQ

sudo ./svc.sh install मध्ये command not found असे का दिसते?

कारण svc.sh runner tarball मध्ये नाही. ./config.sh चे registration पूर्ण झाल्यावर ते runner directory मध्ये तयार होते. Service name तयार करण्यासाठी ते तुमचे repository आणि runner 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 ची प्रतीक्षा करताना तो connection सुरू ठेवतो. त्यामुळे GitHub तुमच्या VPS कडे connection सुरू करत नाही. Outbound 443 ला परवानगी द्या आणि inbound rules बंद ठेवा. Service चालू असतानाही runner Offline दाखवत असेल, तर inbound rules ऐवजी outbound filtering आणि DNS तपासा.

सार्वजनिक repository वर self-hosted runner वापरता येतो का?

होय, परंतु GitHub तसे न करण्याचा सल्ला देते. Fork कडून आलेल्या pull request मध्ये त्याची स्वतःची workflow file असते. त्यामुळे तुमचे repository fork करू शकणारी कोणतीही व्यक्ती तुमच्या मशीनवर चालणाऱ्या commands सुचवू शकते. Default approval prompt मध्ये फक्त असे contributors समाविष्ट असतात ज्यांचा कोणताही commit किंवा pull request repository मध्ये merge झालेला नाही. Public repository ला runner जोडल्यास त्यावर fork pull request workflows disable करा, त्या server वर इतर काहीही ठेवू नका आणि ठराविक कालावधीनंतर मशीन पुन्हा तयार करा.

Http response code: NotFound सह registration का अपयशी ठरते?

Credential चुकीचा असतानाही registration call NotFound उत्तर देते. URL चुकीचा असतानाच हे घडते असे नाही. त्यामुळे हा message दिशाभूल करणारा ठरतो. Registration tokens दाखवल्यानंतर one hour ने 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