Wasanidi

Hati ya kusakinisha runner ya GitHub Actions inayojiendesha

Andika hazina yako na lebo upate hati inayosakinisha runner chini ya mtumiaji wake na kuianzisha kama huduma. Tokeni unaiingiza kwenye seva yako, si hapa.

Inaendeshwa kikamilifu kwenye kivinjari chako — chochote unachoingiza hakitumwi kwenye seva zetu.

URL ya hazina au shirikaBadilisha mfano kwa anwani yako. Kwa runner ya shirika zima, acha shirika pekee.

Jina la runnerLebo, zikitenganishwa kwa komaMtumiaji wa Linux

Sakinisha Docker kwa kazi zinazoihitaji

Kwa hazina za faragha pekee. Kwenye hazina ya umma, pull request kutoka kwenye fork inaweza kuendesha msimbo kwenye seva yako.

Hati ya kusakinisha

#!/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

Mstari kwa workflow yako

runs-on: [self-hosted, vps]

Jinsi ya kuiendesha

Kwenye GitHub fungua Settings → Actions → Runners → New self-hosted runner kisha nakili tokeni.
Nakili hati kwenye seva yako ya Debian au Ubuntu na uiendeshe kama root: bash install-runner.sh.
Bandika tokeni hati inapoiomba. Inabaki kwenye seva yako na haipiti kamwe kwenye ukurasa huu.
Weka mstari wa runs-on kwenye workflow yako.

Mwongozo hatua kwa hatua: runner inayojiendesha kwenye VPS

Unahitaji seva kwa ajili ya runner? Mpango wa Small: 4 vCPU, 4 GB RAM, ufikiaji wa root, $8/mwezi.

Mpango wa Small

Jinsi inavyofanya kazi

Runner inayojiendesha hufanya kazi kwenye mashine yako: inajiunganisha na GitHub, inachukua kazi na kuziendesha hapo. Hati inasakinisha vifurushi vinavyohitajika, inaunda mtumiaji tofauti wa Linux, inapakua toleo jipya la runner, inaisajili na kuweka huduma ya systemd inayoendelea hata baada ya kuwasha upya. Hati inatengenezwa kwenye kivinjari chako, kwa hiyo soma kila mstari kabla ya kuiendesha. Seva inahitaji ufikiaji wa kutoka kwenda GitHub tu, Dedicated IP haihitajiki.

Maswali yanayoulizwa mara kwa mara

Tokeni ya usajili naipata wapi?

Kwenye hazina yako fungua Settings → Actions → Runners → New self-hosted runner. Tokeni inadumu saa moja. Kwa runner ya shirika zima, fuata njia hiyo hiyo kwenye mipangilio ya shirika.

Je, naweza kutumia runner inayojiendesha na hazina ya umma?

GitHub inashauri usifanye hivyo: pull request kutoka kwenye fork inaweza kuendesha msimbo kwenye seva yako. Tumia runner hizi na hazina za faragha.

Je, seva inahitaji Dedicated IP?

Hapana. Runner hufungua miunganisho ya kutoka kwenda GitHub tu, kwa hiyo mpango usio na Dedicated IP unatosha. Kwa nguvu, 4 vCPU na 4 GB RAM zinatosha kwa miradi mingi.

Zana zinazohusiana

b64

Kisimbaji/kisimbuzi cha Base64

Maandishi na faili kwenda Base64 na kurudi, pamoja na chaguo la URL-safe.

Jenereta ya UUID

UUID v4 na v7 zilizopangwa kwa muda, kwa wingi.

*/5

Msaidizi wa Cron

Huelezea mstari wa crontab na kuonyesha utekelezaji unaofuata.

Аa

Uandikaji upya wa herufi

Kisiriliki kwenda Kilatini: viwango vya pasipoti na URL slug.

Zana zote →