איך להקים GitHub Actions runner בהתארחות עצמית על VPS

רשמו GitHub Actions runner בהתארחות עצמית על VPS והתקינו אותו כשירות: הורידו את ה-runner כמשתמש שאינו root, רשמו עם טוקן ה-repo שלכם, הריצו svc.sh כך שהוא שורד reboots. פקודות העתק-הדבק.

runner בהתארחות עצמית נותן לכם CI בעלות קבועה עם caches חמים — ללא חיוב לפי דקה, ה-toolchain שלכם, המכונה שלכם. זה ה-how-to להקמה מינימלית; ל-why שאחסון עצמי מנצח דקות מתארחות של GitHub ולפרטי משימות Docker, ראו את המדריך המלא ואת מקרה השימוש VPS ל-GitHub Actions.

1. צרו משתמש שאינו 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. התקינו כשירות (שורד reboots)

אל תריצו ./run.sh בטרמינל — התקינו אותו:

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

ה-runner עכשיו מופיע כ-Idle בממשק GitHub וקולט משימות שמכוונות אליו.

5. השתמשו בו מ-workflow

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

משימות Docker (אופציונלי)

התקינו Docker פעם אחת ו-workflows יכולים לבנות images עם layer cache שנמשך בין הרצות:

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

ראו התקנת Docker על VPS. גודל: Small ($8/חודש) נוח לרוב ה-CI; עלו לקומפילציה כבדה. root בערך תוך דקה, ללא KYC, שלמו בקריפטו.

שאלות נפוצות

איך אני רושם GitHub Actions runner בהתארחות עצמית?

ב-repo שלכם (או ה-org): Settings → Actions → Runners → New self-hosted runner → Linux. GitHub מציג פקודת הורדה וטוקן רישום חד-פעמי. הורידו את ה-runner כמשתמש שאינו root, הריצו ./config.sh עם אותה URL וטוקן, ואז התקינו אותו כשירות עם svc.sh. הצעדים למטה.

למה ה-runner לא יכול לרוץ כ-root?

ה-runner מסרב לרוץ כ-root בעיצוב. צרו משתמש ייעודי שאינו root (adduser runner) והגדירו אותו שם. זה גם מגביל את מה ש-workflow זדוני יכול לגעת בו במכונה שלכם.

איך אני שומר את ה-runner פועל אחרי reboot?

השתמשו בעוזר svc.sh המצורף: sudo ./svc.sh install runner && sudo ./svc.sh start. הוא מתקין unit של systemd כך שה-runner מתחיל ב-boot ומופעל מחדש בכשל, ומופיע כ-Idle בממשק GitHub.

האם אני צריך IP ייעודי ל-runner?

לא. ה-runner מחייג החוצה ל-GitHub דרך HTTPS; שום דבר לא צריך להגיע אליו נכנס. תוכנית NAT (החל מ-$3/חודש) עובדת. קחו IP ייעודי רק אם אתם גם מארחים בעצמכם משהו שמגיש תעבורה.

האם אתם מבקשים תעודה או כרטיס?

לא. אימייל להרשמה, שלמו ב-USDC או USDT — ללא מסמכים, ללא כרטיס. root בערך תוך דקה.

תגובות

אין עדיין תגובות. היו הראשונים.