Tim kecil sering menunda otomasi deploy karena mengira memerlukan sistem yang rumit. Padahal sebagian besar manfaat datang dari empat langkah sederhana: periksa, bangun, uji, dan rilis dengan jalur mundur.

Artikel ini membahas pipeline minimal yang dapat dibangun dalam satu hari dan dipelihara tanpa tim khusus.

Empat tahap yang wajib ada

TahapTujuanGagal berarti
PeriksaSintaks, linting, pemeriksaan tipeBerhenti sebelum build
BangunHasilkan artefak yang dapat dijalankanBerhenti, tidak ada rilis
UjiVerifikasi perilakuBerhenti, tidak ada rilis
RilisTerapkan ke lingkungan targetKembalikan ke versi sebelumnya

Contoh skrip pipeline

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

VERSI="${1:-$(git rev-parse --short HEAD)}"
echo "== Deploy versi $VERSI"

# ---------- 1. Periksa ----------
echo "[1/4] Pemeriksaan statis"
if command -v shellcheck >/dev/null; then
  shellcheck scripts/*.sh
fi
if [ -f package.json ]; then
  npm ci --silent
  npm run lint --if-present
fi

# ---------- 2. Bangun ----------
echo "[2/4] Membangun artefak"
if [ -f package.json ]; then
  npm run build --if-present
fi
tar -czf "/tmp/rilis-$VERSI.tar.gz" dist/ 2>/dev/null || true

# ---------- 3. Uji ----------
echo "[3/4] Menjalankan uji"
if [ -f package.json ]; then
  npm test --if-present
fi

# ---------- 4. Rilis ----------
echo "[4/4] Menerapkan"
TARGET=/opt/app/current
CADANGAN=/opt/app/previous

# Simpan versi sebelumnya untuk jalur mundur
if [ -d "$TARGET" ]; then
  rm -rf "$CADANGAN"
  cp -a "$TARGET" "$CADANGAN"
fi

# Terapkan versi baru
mkdir -p "$TARGET"
tar -xzf "/tmp/rilis-$VERSI.tar.gz" -C "$TARGET" --strip-components=1

# Muat ulang layanan
sudo systemctl reload app || sudo systemctl restart app

# Verifikasi
sleep 2
kode=$(curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:8080/healthz)
if [ "$kode" != "200" ]; then
  echo "Verifikasi gagal (kode $kode), mengembalikan versi sebelumnya"
  rm -rf "$TARGET"
  cp -a "$CADANGAN" "$TARGET"
  sudo systemctl restart app
  exit 1
fi

echo "Deploy $VERSI selesai"

Mengapa verifikasi setelah rilis penting

Pipeline yang berhenti pada "perintah berhasil dijalankan" belum tentu berhasil. Layanan bisa saja berjalan tetapi mengembalikan galat. Pemeriksaan kesehatan setelah rilis menangkap kegagalan yang tidak terdeteksi oleh kode keluar perintah.

Jalur mundur yang benar-benar berfungsi

Jalur mundur harus diuji, bukan diasumsikan. Uji dengan sengaja menerapkan versi rusak, lalu pastikan pengembalian berhasil.

# Uji jalur mundur secara sengaja
# 1. Buat perubahan yang menyebabkan verifikasi gagal
# 2. Jalankan pipeline
# 3. Pastikan skrip mengembalikan versi sebelumnya dan layanan kembali normal

Yang tidak perlu untuk tim kecil

  • Orkestrasi container penuh — bila Anda hanya punya dua server, ini berlebihan
  • Lingkungan staging terpisah penuh — cukup satu lingkungan uji yang menyerupai produksi
  • Deploy biru-hijau otomatis — bermanfaat, tetapi bukan prioritas pertama
  • Metrik DORA lengkap — mulai dari dua: frekuensi deploy dan waktu pemulihan

Kapan menambah kerumitan

KondisiYang perlu ditambahkan
Deploy lebih dari sekali sehariOtomasi pemicu dari repositori
Lebih dari tiga serverKonfigurasi terpusat
Downtime tidak dapat diterimaDeploy bertahap dengan health check
Beberapa orang melakukan deployPencatatan siapa mendeploy apa

Kesalahan umum

KesalahanAkibat
Tidak menyimpan versi sebelumnyaTidak dapat kembali saat gagal
Verifikasi hanya memeriksa proses berjalanGalat aplikasi lolos
Deploy langsung ke produksi tanpa ujiKesalahan sederhana menjatuhkan layanan
Rahasia disimpan di repositoriKebocoran kredensial

Kesimpulan

Pipeline yang baik bukan yang paling canggih, melainkan yang dipercaya. Bila tim yakin deploy dapat dikembalikan dalam hitungan menit, frekuensi rilis akan naik dengan sendirinya. Mulailah dari empat tahap di atas, tambahkan kerumitan hanya ketika ada alasan nyata.