Deploy otomatis ke VPS dengan GitHub Actions dan SSH
Membuat pipeline CI/CD sederhana yang menjalankan lint dan build, lalu men-deploy ke VPS lewat SSH, dengan kunci deploy terbatas, known_hosts yang diverifikasi, dan pencegahan deploy ganda.
- published
- reading time
- 3 min
Deploy manual biasanya berjalan seperti ini: SSH ke server, git pull, build, restart layanan, lalu berharap tidak ada langkah yang terlewat. Prosesnya mudah di minggu pertama, tapi mulai bermasalah saat ada lebih dari satu orang yang men-deploy, atau saat Anda lupa menjalankan migrasi database.
GitHub Actions bisa mengotomatiskan seluruh proses ini. Setiap push ke branch main akan menjalankan pemeriksaan kode, lalu men-deploy ke server jika semuanya lulus. Artikel ini membangun pipeline tersebut langkah demi langkah, dengan perhatian khusus pada keamanan kunci SSH.
Arsitektur
Pendekatan yang dipakai di sini adalah pull-based deploy via SSH:
- GitHub Actions menjalankan lint dan build untuk memastikan kode tidak rusak.
- Jika lulus, Actions terhubung ke server lewat SSH.
- Server menarik kode terbaru dari git, lalu membangun dan menjalankan ulang container Docker.
Pendekatan ini sederhana dan cocok untuk satu atau beberapa server. Untuk skala lebih besar, biasanya image Docker dibangun di CI, dikirim ke registry, lalu server hanya menarik image jadi. Prinsip keamanannya tetap sama.
Langkah 1: user deploy di server
Jangan memakai akun root atau akun pribadi Anda untuk deploy otomatis. Buat user khusus:
sudo adduser --disabled-password --gecos "" deploy
sudo usermod -aG docker deployPerlu dicatat, anggota grup docker secara efektif punya akses setara root di server. Ini masih jauh lebih baik daripada memakai root langsung, tapi kunci SSH user ini tetap harus dijaga ketat.
Pastikan user deploy bisa mengakses repository. Untuk repository privat, buat deploy key baru di server dan daftarkan di Settings > Deploy keys repository GitHub dengan akses read-only.
Langkah 2: kunci SSH khusus untuk GitHub Actions
Buat pasangan kunci baru di komputer lokal. Jangan memakai ulang kunci pribadi Anda.
ssh-keygen -t ed25519 -C "github-actions-deploy" -f ./gha_deploy -N ""Tambahkan kunci publiknya ke server, dengan pembatasan:
command="/home/deploy/bin/deploy.sh",no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty ssh-ed25519 AAAA... github-actions-deployOpsi command= adalah bagian terpenting. Apa pun perintah yang dikirim oleh klien, server hanya akan menjalankan deploy.sh. Jika kunci ini bocor, penyerang hanya bisa memicu deploy, bukan membuka shell di server.
Langkah 3: script deploy
#!/usr/bin/env bash
set -euo pipefail
cd /srv/myapp
git fetch --prune origin
git reset --hard origin/main
docker compose up -d --build --remove-orphans
docker image prune -f
echo "deploy selesai: $(git rev-parse --short HEAD)"chmod +x /home/deploy/bin/deploy.shset -euo pipefail membuat script langsung berhenti jika ada perintah yang gagal, sehingga Actions akan melaporkan deploy gagal, bukan diam-diam berhasil setengah jalan.
git reset --hard origin/main memastikan kode di server persis sama dengan branch main, termasuk jika ada yang mengedit file langsung di server. Jika server Anda menyimpan file lokal yang tidak ada di git, seperti upload pengguna, pastikan file tersebut berada di luar direktori repository atau tercantum di .gitignore.
Langkah 4: simpan rahasia di GitHub
Di repository, buka Settings > Secrets and variables > Actions, lalu tambahkan:
| Nama | Isi |
|---|---|
DEPLOY_HOST | IP atau hostname server |
DEPLOY_KEY | Isi file gha_deploy (kunci privat) |
DEPLOY_KNOWN_HOSTS | Hasil ssh-keyscan server |
Ambil known_hosts dari jaringan yang Anda percaya, lalu cocokkan fingerprint-nya dengan yang ada di server:
ssh-keyscan -t ed25519 IP_SERVER
# bandingkan dengan, di server:
ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pubBanyak tutorial memakai StrictHostKeyChecking=no agar praktis. Hindari pengaturan itu, karena koneksi SSH jadi tidak bisa mendeteksi serangan man-in-the-middle, dan kunci deploy Anda bisa dikirim ke server palsu.
Setelah disimpan di GitHub, hapus file gha_deploy dari komputer lokal.
Langkah 5: workflow
name: deploy
on:
push:
branches: [main]
workflow_dispatch:
concurrency:
group: deploy-production
cancel-in-progress: false
jobs:
check:
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 run lint
- run: npm run build
deploy:
needs: check
runs-on: ubuntu-latest
environment: production
steps:
- name: Siapkan SSH
run: |
install -m 700 -d ~/.ssh
echo "${{ secrets.DEPLOY_KEY }}" > ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519
echo "${{ secrets.DEPLOY_KNOWN_HOSTS }}" > ~/.ssh/known_hosts
- name: Deploy
run: ssh deploy@${{ secrets.DEPLOY_HOST }}Beberapa catatan:
concurrencymencegah dua deploy berjalan bersamaan jika ada dua push berurutan. Deploy kedua menunggu deploy pertama selesai.needs: checkmemastikan deploy hanya berjalan jika lint dan build lulus.environment: productionmemungkinkan Anda menambahkan aturan persetujuan manual atau membatasi branch yang boleh deploy di Settings > Environments.workflow_dispatchmenambahkan tombol untuk menjalankan deploy secara manual dari tab Actions.- Perintah
sshtidak perlu argumen tambahan, karena server akan menjalankandeploy.shberdasarkan opsicommand=.
Langkah 6: rollback
Karena server selalu mengikuti origin/main, rollback dilakukan lewat git:
git revert HEAD
git push origin mainPipeline akan berjalan dan men-deploy versi sebelumnya. Riwayat git tetap rapi dan semua orang di tim tahu apa yang terjadi. Hindari memperbaiki langsung di server, karena perubahan itu akan hilang pada deploy berikutnya.
Migrasi database
Jika aplikasi membutuhkan migrasi, jalankan di dalam deploy.sh setelah container baru dibangun, misalnya docker compose run --rm app npm run migrate. Usahakan migrasi selalu kompatibel ke belakang (backward compatible), misalnya menambah kolom dulu dan menghapus kolom lama di rilis berikutnya. Dengan begitu, rollback kode tidak membutuhkan rollback database.
Penutup
Pipeline ini kurang dari 50 baris, tapi mengubah deploy dari ritual manual yang rawan lupa menjadi proses yang konsisten dan tercatat. Setiap deploy punya log di tab Actions, setiap perubahan bisa dilacak ke commit tertentu, dan kunci SSH yang dipakai hanya bisa melakukan satu hal. Mulailah dengan versi sederhana ini, lalu tambahkan pengujian otomatis dan notifikasi saat tim dan aplikasi Anda tumbuh.