هدف ساده است: پوش روی 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نام کاربر، مثلاًdeploySSH_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 خالی است یا برای میزبان دیگری است.