Jinsi ya kusanidi runner ya GitHub Actions inayojipangisha kwenye VPS

Sajili runner ya GitHub Actions inayojipangisha kwenye VPS na uisakinishe kama huduma: pakua runner ukiwa mtumiaji asiye root, sajili kwa tokeni ya repo yako, endesha svc.sh ili idumu kupitia kuwasha upya. Amri za kunakili-bandika.

Runner inayojipangisha inakupa CI ya gharama thabiti na kache za joto — hakuna bili ya kwa dakika, msururu wako wa zana, mashine yako. Huu ni mwongozo wa usanidi wa chini kabisa; kwa nini kujipangisha kunashinda dakika zinazopangishwa na GitHub na maelezo ya kazi za Docker, angalia mwongozo kamili na matumizi ya VPS kwa GitHub Actions.

1. Tengeneza mtumiaji asiye root (runner hukataa root)

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

2. Pakua runner

Katika GitHub: Settings → Actions → Runners → New self-hosted runner → Linux, ambayo hukupa upakuaji kamili na tokeni ya mara moja. Kisha:

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

3. Isajili kwa repo yako

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

4. Sakinisha kama huduma (hudumu kupitia kuwasha upya)

Usiendeshe ./run.sh kwenye terminal — isakinishe:

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

Runner sasa inaonekana kama Idle katika kiolesura cha GitHub na huchukua kazi zinazoilenga.

5. Itumie kutoka kwa workflow

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

Kazi za Docker (hiari)

Sakinisha Docker mara moja, na workflow zinaweza kujenga image huku kache ya tabaka ikidumu kati ya utendaji:

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

Angalia sakinisha Docker kwenye VPS. Ukubwa: Small ($8/mwezi) ni rahisi kwa CI nyingi; panda juu kwa uandaaji mzito. Root kwa takribani dakika moja, bila KYC, malipo kwa crypto.

Maswali

Nasajilije runner ya GitHub Actions inayojipangisha?

Kwenye repo yako (au org): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub inaonyesha amri ya kupakua na tokeni ya usajili ya mara moja. Pakua runner ukiwa mtumiaji asiye root, endesha ./config.sh na URL na tokeni hiyo, kisha isakinishe kama huduma kwa svc.sh. Hatua ziko chini.

Kwa nini runner haiwezi kuendesha kama root?

Runner hukataa kuendesha kama root kwa muundo. Tengeneza mtumiaji maalum asiye root (adduser runner) na uisakinishe hapo. Hilo pia hupunguza kile ambacho workflow hasidi ingeweza kugusa kwenye mashine yako.

Namuwezaje runner iendelee kufanya kazi baada ya kuwasha upya?

Tumia msaidizi svc.sh unaokuja nao: sudo ./svc.sh install runner && sudo ./svc.sh start. Husakinisha kitengo cha systemd ili runner ianze wakati wa kuwasha na kuanza upya inaposhindwa, na kuonekana kama Idle katika kiolesura cha GitHub.

Je, nahitaji IP maalum kwa runner?

Hapana. Runner hupiga simu kwenda nje kwa GitHub kupitia HTTPS; hakuna kinachohitaji kuifikia kwa kuingia. Mpango wa NAT (kuanzia $3/mwezi) unafanya kazi. Chukua IP maalum tu ikiwa pia unajipangishia kitu kinachohudumia trafiki.

Mnahitaji kitambulisho au kadi?

Hapana. Barua pepe ya kujisajili, malipo kwa USDC au USDT — hakuna nyaraka, hakuna kadi. Root kwa takribani dakika moja.

Maoni

Bado hakuna maoni. Kuwa wa kwanza.