شنبه تا چهارشنبه، ۹ تا ۱۸. پشتیبانی فنی ۲۴ ساعته تا ۷ روز پولتان برمی‌گردد انتقال رایگان سایت، بدون قطعی
تازه‌ترین نوشته‌هابلاگتازه‌ترین نوشته‌ها
CI/CD

استقرار خودکار روی سرور با GitHub Actions

خط لوله‌ای که با هر پوش روی main، کد را تست می‌کند و اگر سبز بود روی سرور می‌فرستد. با کلید SSH جدا و دسترسی محدود.

هدف ساده است: پوش روی main باعث شود کد تست شود و اگر قبول شد، روی سرور برود. بدون باز کردن ترمینال.

کلید SSH جدا بساز

کلید شخصی‌ات را به GitHub نده. یک کلید مخصوص استقرار بساز که فقط همین کار را می‌کند:

ssh-keygen -t ed25519 -C "deploy@github-actions" -f ~/.ssh/deploy_ci -N ""

کلید عمومی را روی سرور، برای کاربر استقرار (نه روت) بگذار:

ssh-copy-id -i ~/.ssh/deploy_ci.pub deploy@server.example.com

و در سرور، همان کلید را محدود کن. در ~/.ssh/authorized_keys کاربر deploy، پیش از کلید بنویس:

command="/srv/deploy.sh",no-port-forwarding,no-agent-forwarding,no-pty ssh-ed25519 AAAA...

یعنی هر کسی با این کلید وصل شود، فقط همان اسکریپت اجرا می‌شود و پوسته نمی‌گیرد. اگر کلید لو برود، مهاجم نمی‌تواند هر دستوری بزند.

اسکریپت روی سرور

#!/usr/bin/env bash
set -euo pipefail

cd /srv/myapp
git fetch --all
git reset --hard origin/main
npm ci --omit=dev
npm run build
sudo systemctl restart myapp

set -euo pipefail یعنی اولین خطا اسکریپت را متوقف می‌کند. بدون آن، اگر npm ci شکست بخورد، سرویس با نسخهٔ نیمه‌تمام ری‌استارت می‌شود.

برای اینکه deploy بتواند سرویس را ری‌استارت کند بدون اینکه روت باشد:

sudo visudo -f /etc/sudoers.d/deploy
deploy ALL=(root) NOPASSWD: /bin/systemctl restart myapp

فقط همان یک دستور، نه ALL.

کلیدها را در GitHub بگذار

Settings ← Secrets and variables ← Actions ← New repository secret

  • SSH_KEY محتوای ~/.ssh/deploy_ci (کلید خصوصی، کامل)
  • SSH_HOST نشانی سرور
  • SSH_USER نام کاربر، مثلاً deploy
  • SSH_KNOWN_HOSTS خروجی ssh-keyscan server.example.com

آخری را نادیده نگیر. بدون آن مجبور می‌شوی بررسی اثر انگشت سرور را خاموش کنی، و آن‌وقت در برابر حملهٔ مرد میانی باز هستی.

فایل خط لوله

.github/workflows/deploy.yml:

name: test and deploy

on:
  push:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "22"
          cache: npm
      - run: npm ci
      - run: npm test

  deploy:
    needs: test
    runs-on: ubuntu-latest
    # فقط از شاخهٔ اصلی. بدون این، هر پوشی روی هر شاخه‌ای مستقر می‌شود.
    if: github.ref == 'refs/heads/main'
    concurrency:
      group: production
      cancel-in-progress: false
    steps:
      - name: آماده کردن SSH
        run: |
          mkdir -p ~/.ssh
          echo "${{ secrets.SSH_KEY }}" > ~/.ssh/id_ed25519
          chmod 600 ~/.ssh/id_ed25519
          echo "${{ secrets.SSH_KNOWN_HOSTS }}" > ~/.ssh/known_hosts

      - name: استقرار
        run: ssh ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }} true

چند چیز که ارزش توضیح دارند:

needs: test یعنی استقرار فقط بعد از سبز شدن تست اجرا می‌شود.

concurrency با cancel-in-progress: false جلوی اجرای هم‌زمان دو استقرار را می‌گیرد. دو پوش پشت سر هم می‌توانند وسط کار همدیگر بیفتند و سرور را در حالت نیمه‌کاره بگذارند.

دستور آخر true است، نه نام اسکریپت. چون روی سرور کلید را با command= قفل کرده‌ایم، هر چه بفرستی نادیده گرفته می‌شود و همان اسکریپت اجرا می‌شود.

اولین بار که کار نکرد

لاگ Actions معمولاً می‌گوید کجا ایستاده. دو خطای رایج:

Permission denied (publickey) یعنی کلید عمومی روی سرور نیست یا در authorized_keys کاربر اشتباهی گذاشته شده.

Host key verification failed یعنی SSH_KNOWN_HOSTS خالی است یا برای میزبان دیگری است.

این نوشته کمکتان کرد؟ نه، هنوز سوال دارم

نوشته‌های مرتبط