როგორ დავაყენოთ self-hosted GitHub Actions runner VPS-ზე

დაარეგისტრირე self-hosted GitHub Actions runner VPS-ზე და დააინსტალე როგორც სერვისი: ჩამოტვირთე runner როგორც non-root მომხმარებელი, დაარეგისტრირე შენი repo ტოკენით, გაუშვი svc.sh, რომ გადატვირთვებს გადაურჩეს. copy-paste ბრძანებები.

self-hosted runner გაძლევს ფიქსირებული-ღირებულების CI-ს თბილი ქეშებით — არ არის წუთობრივი ბილინგი, შენი toolchain, შენი მანქანა. ეს არის მინიმალური დაყენების გზამკვლევი; რატომ ჯობია self-hosting GitHub-ის მიერ ჰოსტირებულ წუთებს და Docker-ის სამუშაოების დეტალები იხ. სრული გზამკვლევი და VPS GitHub Actions-ისთვის გამოყენების ქეისი.

1. შექმენი non-root მომხმარებელი (runner უარს ამბობს root-ზე)

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

2. ჩამოტვირთე 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

3. დაარეგისტრირე ის შენს repo-სთან

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

4. დააინსტალე როგორც სერვისი (გადატვირთვებს გადაურჩება)

არ გაუშვა ./run.sh ტერმინალში — დააინსტალე ის:

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

runner ახლა GitHub-ის ინტერფეისში Idle-ად გამოჩნდება და იღებს სამუშაოებს, რომლებიც მას მიმართავს.

5. გამოიყენე ის workflow-დან

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

Docker სამუშაოები (არასავალდებულო)

დააინსტალე Docker ერთხელ, და workflow-ებს შეუძლიათ image-ების აგება, სადაც ფენების ქეში გაშვებებს შორის რჩება:

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

იხ. Docker-ის დაყენება VPS-ზე. ზომა: Small ($8/თვე) კომფორტულია CI-ის უმეტესობისთვის; ასწიე მძიმე კომპილაციისთვის. root დაახლოებით ერთ წუთში, KYC-ის გარეშე, გადახდა კრიპტოთი.

ხდკ

როგორ დავარეგისტრირო self-hosted GitHub Actions runner?

შენს repo-ში (ან org): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub აჩვენებს ჩამოტვირთვის ბრძანებას და ერთჯერად რეგისტრაციის ტოკენს. ჩამოტვირთე runner როგორც non-root მომხმარებელი, გაუშვი ./config.sh იმ URL-ითა და ტოკენით, შემდეგ დააინსტალე როგორც სერვისი 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-ის ინტერფეისში Idle-ად გამოჩნდეს.

მჭირდება გამოყოფილი IP runner-ისთვის?

არა. runner გარეთ ურეკავს GitHub-ს HTTPS-ით; მისკენ შემომავალი არაფერი უნდა მიაღწიოს. NAT გეგმა ($3/თვე-დან) მუშაობს. გამოყოფილი IP აიღე მხოლოდ თუ ასევე self-host-ავ რაღაცას, რაც ტრაფიკს ემსახურება.

ითხოვთ პირადობას ან ბარათს?

არა. ელფოსტა რეგისტრაციისთვის, გადახდა USDC-ით ან USDT-ით — დოკუმენტების გარეშე, ბარათის გარეშე. root დაახლოებით ერთ წუთში.

კომენტარები

ჯერ არ არის კომენტარები. იყავით პირველი.