დეველოპერები

თვით-ჰოსტინგ GitHub Actions runner-ის დაყენების სკრიპტი

მიუთითეთ რეპოზიტორი და ლეიბლები და მიიღეთ სკრიპტი, რომელიც runner-ს ცალკე მომხმარებლით დააყენებს და სერვისად გაუშვებს. ტოკენს თქვენს სერვერზე შეიყვანთ და არა აქ.

სრულად თქვენს ბრაუზერში მუშაობს — თქვენს მიერ შეყვანილი არაფერი იგზავნება ჩვენს სერვერებზე.

რეპოზიტორის ან ორგანიზაციის მისამართიჩაანაცვლეთ მაგალითი თქვენი მისამართით. მთელი ორგანიზაციის runner-ისთვის დატოვეთ მხოლოდ ორგანიზაცია.

Runner-ის სახელილეიბლები, მძიმით გამოყოფილიLinux მომხმარებელი

დააყენე Docker იმ ამოცანებისთვის, რომლებსაც ის სჭირდებათ

მხოლოდ კერძო რეპოზიტორიებისთვის. საჯაროში fork-იდან გამოგზავნილ pull request-ს შეუძლია თქვენს სერვერზე კოდის გაშვება.

დაყენების სკრიპტი

#!/usr/bin/env bash
# Installs a self-hosted GitHub Actions runner as a systemd service (Debian, Ubuntu).
# Run as root: bash install-runner.sh
set -euo pipefail

REPO_URL="https://github.com/your-org/your-repo"
RUNNER_NAME="vps-runner-1"
RUNNER_LABELS="vps"
RUNNER_USER="runner"
RUNNER_DIR="/home/$RUNNER_USER/actions-runner"

[ "$(id -u)" -eq 0 ] || { echo "Run this script as root." >&2; exit 1; }
command -v apt-get >/dev/null || { echo "This script supports Debian and Ubuntu only." >&2; exit 1; }
case "$(uname -m)" in
  x86_64) ARCH=x64 ;;
  aarch64) ARCH=arm64 ;;
  *) echo "Unsupported CPU: $(uname -m)" >&2; exit 1 ;;
esac
[ ! -f "$RUNNER_DIR/.runner" ] || { echo "A runner is already configured in $RUNNER_DIR." >&2; exit 1; }

read -rsp "Registration token from GitHub: " RUNNER_TOKEN; echo
[ -n "$RUNNER_TOKEN" ] || { echo "The token is empty." >&2; exit 1; }

apt-get update -y
apt-get install -y curl tar ca-certificates
id "$RUNNER_USER" >/dev/null 2>&1 || useradd -m -s /bin/bash "$RUNNER_USER"

# Latest runner release
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/actions/runner/releases/latest | sed 's|.*/tag/v||')"
FILE="actions-runner-linux-$ARCH-$VERSION.tar.gz"
as_runner() { runuser -u "$RUNNER_USER" -- env HOME="/home/$RUNNER_USER" "$@"; }
as_runner mkdir -p "$RUNNER_DIR"
cd "$RUNNER_DIR"
as_runner curl -fsSL -o "$FILE" "https://github.com/actions/runner/releases/download/v$VERSION/$FILE"
as_runner tar xzf "$FILE"
rm -f "$FILE"
./bin/installdependencies.sh

# Register with GitHub and start as a service
as_runner ./config.sh --unattended --url "$REPO_URL" --token "$RUNNER_TOKEN" --name "$RUNNER_NAME" --labels "$RUNNER_LABELS" --replace
./svc.sh install "$RUNNER_USER"
./svc.sh start
./svc.sh status --no-pager

ხაზი თქვენი workflow-სთვის

runs-on: [self-hosted, vps]

როგორ გავუშვათ

GitHub-ზე გახსენით Settings → Actions → Runners → New self-hosted runner და დააკოპირეთ ტოკენი.
დააკოპირეთ სკრიპტი Debian-ის ან Ubuntu-ს სერვერზე და გაუშვით root-ით: bash install-runner.sh.
ჩასვით ტოკენი, როცა სკრიპტი მოგთხოვთ. ის თქვენს სერვერზე რჩება და ამ გვერდზე არასდროს გადის.
ჩასვით ხაზი runs-on თქვენს workflow-ში.

ნაბიჯ-ნაბიჯ გზამკვლევი: თვით-ჰოსტინგ runner VPS-ზე

გჭირდებათ სერვერი runner-ისთვის? გეგმა Small: 4 vCPU, 4 GB RAM, root წვდომა, თვეში $8.

გეგმა Small

როგორ მუშაობს

თვით-ჰოსტინგ runner თქვენს მანქანაზე მუშაობს: თავად უკავშირდება GitHub-ს, იღებს ამოცანებს და იქვე ასრულებს. სკრიპტი აყენებს საჭირო პაკეტებს, ქმნის ცალკე Linux მომხმარებელს, ჩამოტვირთავს runner-ის უახლეს ვერსიას, არეგისტრირებს და აწყობს systemd სერვისს, რომელიც გადატვირთვის შემდეგაც მუშაობს. სკრიპტი თქვენს ბრაუზერში იქმნება, ამიტომ გაშვებამდე წაიკითხეთ ყველა ხაზი. სერვერს მხოლოდ GitHub-ზე გამავალი წვდომა სჭირდება, გამოყოფილი IP საჭირო არ არის.

ხშირად დასმული კითხვები

სად ვიპოვო რეგისტრაციის ტოკენი?

რეპოზიტორიში გახსენით Settings → Actions → Runners → New self-hosted runner. ტოკენი ერთი საათი მოქმედებს. მთელი ორგანიზაციის runner-ისთვის იგივე გზა გაიარეთ ორგანიზაციის პარამეტრებში.

შეიძლება თვით-ჰოსტინგ runner-ის გამოყენება საჯარო რეპოზიტორით?

GitHub ამას არ გირჩევთ: fork-იდან გამოგზავნილ pull request-ს შეუძლია თქვენს სერვერზე კოდის გაშვება. გამოიყენეთ თვით-ჰოსტინგ runner-ები კერძო რეპოზიტორიებით.

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

არა. Runner მხოლოდ GitHub-ზე გამავალ კავშირებს ხსნის, ამიტომ გამოყოფილი IP-ის გარეშე გეგმაც საკმარისია. სიმძლავრით პროექტების უმეტესობას 4 vCPU და 4 GB RAM ჰყოფნის.

მსგავსი ხელსაწყოები

b64

Base64 ენკოდერი/დეკოდერი

ტექსტი და ფაილები Base64-ში და უკან, URL-safe რეჟიმით.

UUID გენერატორი

UUID v4 და დროის მიხედვით დალაგებული v7, მასობრივად.

*/5

Cron ასისტენტი

ხსნის crontab სტრიქონს და აჩვენებს შემდეგ გაშვებებს.

Аa

ტრანსლიტერაცია

კირილიციდან ლათინურზე: პასპორტის სტანდარტები და URL slug.

ყველა ხელსაწყო →