ডেভেলপার

সেল্ফ-হোস্টেড GitHub Actions রানারের ইনস্টল স্ক্রিপ্ট

আপনার রিপোজিটরি ও লেবেল লিখুন, পেয়ে যান এমন স্ক্রিপ্ট যা রানারকে আলাদা ইউজারের অধীনে ইনস্টল করে সার্ভিস হিসেবে চালু করে। টোকেন আপনি সার্ভারে দেবেন, এখানে নয়।

পুরোটাই আপনার ব্রাউজারে চলে — আপনি যা লেখেন তার কিছুই আমাদের সার্ভারে পাঠানো হয় না।

রিপোজিটরি বা সংস্থার URLউদাহরণের জায়গায় নিজের ঠিকানা দিন। পুরো সংস্থার রানারের জন্য শুধু সংস্থা রাখুন।

রানারের নামলেবেল, কমা দিয়ে আলাদাLinux ইউজার

যে জবের দরকার, তার জন্য Docker ইনস্টল করুন

শুধু প্রাইভেট রিপোজিটরির জন্য। পাবলিকে ফর্ক থেকে আসা 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-এ বসান।

ধাপে ধাপে গাইড: VPS-এ সেল্ফ-হোস্টেড রানার

রানারের জন্য সার্ভার দরকার? Small প্ল্যান: 4 vCPU, 4 GB RAM, root অ্যাক্সেস, মাসে $8।

Small প্ল্যান

কীভাবে কাজ করে

সেল্ফ-হোস্টেড রানার আপনার নিজের মেশিনে কাজ করে: নিজেই GitHub-এ সংযুক্ত হয়, জব নেয় এবং সেখানেই চালায়। স্ক্রিপ্টটি প্রয়োজনীয় প্যাকেজ ইনস্টল করে, আলাদা Linux ইউজার তৈরি করে, রানারের সর্বশেষ রিলিজ ডাউনলোড করে, রেজিস্টার করে এবং এমন systemd সার্ভিস সেট করে যা রিবুটের পরও চলে। স্ক্রিপ্টটি আপনার ব্রাউজারে তৈরি হয়, তাই চালানোর আগে প্রতিটি লাইন পড়ে নিন। সার্ভারের শুধু GitHub-এ আউটগোয়িং অ্যাক্সেস লাগে, Dedicated IP দরকার নেই।

প্রায়ই জিজ্ঞাসিত প্রশ্ন

রেজিস্ট্রেশন টোকেন কোথায় পাব?

আপনার রিপোজিটরিতে Settings → Actions → Runners → New self-hosted runner খুলুন। টোকেন এক ঘণ্টা বৈধ থাকে। পুরো সংস্থার রানারের জন্য সংস্থার সেটিংসে একই পথ ধরুন।

পাবলিক রিপোজিটরির সঙ্গে কি সেল্ফ-হোস্টেড রানার ব্যবহার করা যায়?

GitHub এটি নিষেধ করে: ফর্ক থেকে আসা pull request আপনার সার্ভারে কোড চালাতে পারে। সেল্ফ-হোস্টেড রানার প্রাইভেট রিপোজিটরির সঙ্গে ব্যবহার করুন।

সার্ভারে কি Dedicated IP লাগবে?

না। রানার শুধু GitHub-এ আউটগোয়িং সংযোগ খোলে, তাই Dedicated IP ছাড়া প্ল্যানই যথেষ্ট। ক্ষমতার দিক থেকে বেশিরভাগ প্রকল্পে 4 vCPU ও 4 GB RAM যথেষ্ট।

সেল্ফ-হোস্টেড GitHub Actions রানারের ইনস্টল স্ক্রিপ্ট

কীভাবে চালাবেন

কীভাবে কাজ করে

প্রায়ই জিজ্ঞাসিত প্রশ্ন

সম্পর্কিত টুল