Skip to content

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:

  1. GitHub Actions menjalankan lint dan build untuk memastikan kode tidak rusak.
  2. Jika lulus, Actions terhubung ke server lewat SSH.
  3. 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 deploy

Perlu 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:

/home/deploy/.ssh/authorized_keys
command="/home/deploy/bin/deploy.sh",no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty ssh-ed25519 AAAA... github-actions-deploy

Opsi 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

/home/deploy/bin/deploy.sh
#!/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.sh

set -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:

NamaIsi
DEPLOY_HOSTIP atau hostname server
DEPLOY_KEYIsi file gha_deploy (kunci privat)
DEPLOY_KNOWN_HOSTSHasil 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.pub

Banyak 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

.github/workflows/deploy.yml
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:

  • concurrency mencegah dua deploy berjalan bersamaan jika ada dua push berurutan. Deploy kedua menunggu deploy pertama selesai.
  • needs: check memastikan deploy hanya berjalan jika lint dan build lulus.
  • environment: production memungkinkan Anda menambahkan aturan persetujuan manual atau membatasi branch yang boleh deploy di Settings > Environments.
  • workflow_dispatch menambahkan tombol untuk menjalankan deploy secara manual dari tab Actions.
  • Perintah ssh tidak perlu argumen tambahan, karena server akan menjalankan deploy.sh berdasarkan opsi command=.

Langkah 6: rollback

Karena server selalu mengikuti origin/main, rollback dilakukan lewat git:

git revert HEAD
git push origin main

Pipeline 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.

Deploy otomatis ke VPS dengan GitHub Actions dan SSH · Rafli Anggoro