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
| Tahap | Tujuan | Gagal berarti |
|---|---|---|
| Periksa | Sintaks, linting, pemeriksaan tipe | Berhenti sebelum build |
| Bangun | Hasilkan artefak yang dapat dijalankan | Berhenti, tidak ada rilis |
| Uji | Verifikasi perilaku | Berhenti, tidak ada rilis |
| Rilis | Terapkan ke lingkungan target | Kembalikan 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
| Kondisi | Yang perlu ditambahkan |
|---|---|
| Deploy lebih dari sekali sehari | Otomasi pemicu dari repositori |
| Lebih dari tiga server | Konfigurasi terpusat |
| Downtime tidak dapat diterima | Deploy bertahap dengan health check |
| Beberapa orang melakukan deploy | Pencatatan siapa mendeploy apa |
Kesalahan umum
| Kesalahan | Akibat |
|---|---|
| Tidak menyimpan versi sebelumnya | Tidak dapat kembali saat gagal |
| Verifikasi hanya memeriksa proses berjalan | Galat aplikasi lolos |
| Deploy langsung ke produksi tanpa uji | Kesalahan sederhana menjatuhkan layanan |
| Rahasia disimpan di repositori | Kebocoran 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.