Skrip yang baik dapat dijalankan berkali-kali dengan hasil yang sama. Skrip yang buruk menggandakan baris konfigurasi setiap kali dijalankan, atau gagal di tengah jalan dan meninggalkan sistem pada keadaan setengah jadi.

Idempoten berarti: menjalankan sekali atau sepuluh kali menghasilkan keadaan akhir yang identik. Ini bukan kemewahan, melainkan syarat agar otomasi dapat dipercaya.

Pola 1 — Periksa sebelum mengubah

Kesalahan paling umum adalah menambahkan sesuatu tanpa memeriksa apakah sudah ada.

Buruk:

echo "export PATH=/opt/app/bin:$PATH" >> ~/.bashrc

Setiap kali dijalankan, satu baris baru ditambahkan. Setelah sepuluh kali, berkas berisi sepuluh baris identik.

Baik:

grep -qxF 'export PATH=/opt/app/bin:$PATH' ~/.bashrc \
  || echo 'export PATH=/opt/app/bin:$PATH' >> ~/.bashrc

Opsi -x mencocokkan seluruh baris, -F memperlakukan pola sebagai teks biasa sehingga karakter khusus tidak ditafsirkan.

Pola 2 — Gunakan perintah yang sudah memahami keadaan

Banyak perintah sudah idempoten bila opsinya tepat.

TujuanTidak idempotenIdempoten
Buat direktorimkdir /opt/appmkdir -p /opt/app
Buat tautanln -s a bln -sfn a b
Tambah pengguna ke grupecho "user:x:1000:" >> /etc/groupusermod -aG grup user
Pasang paketdpkg -i paket.debapt install -y paket
Ubah baris konfigurasiecho "x=1" >> confPeriksa lalu ganti, atau pakai sed -i berpola

Pola 3 — Berhenti saat ada kesalahan

Tanpa pengaturan ini, skrip akan melanjutkan meskipun langkah sebelumnya gagal, dan berakhir pada keadaan yang tidak masuk akal.

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

# -e : berhenti bila ada perintah gagal
# -u : berhenti bila memakai variabel yang belum didefinisikan
# -o pipefail : kegagalan di tengah pipeline ikut terdeteksi

set -u sangat berguna: salah ketik nama variabel langsung terdeteksi, bukan menghasilkan string kosong yang diam-diam merusak perintah.

Pola 4 — Tangani keadaan setengah jadi

Skrip bisa terhenti di tengah karena listrik padam atau koneksi putus. Sediakan jalur pembersihan.

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

TMPDIR=$(mktemp -d)
cleanup() {
  rm -rf "$TMPDIR"
}
trap cleanup EXIT

# ... pekerjaan utama memakai $TMPDIR ...

trap ... EXIT menjalankan pembersihan apa pun hasilnya: sukses, gagal, atau dihentikan pengguna.

Pola 5 — Buat penanda untuk langkah berat

Untuk langkah yang memakan waktu lama, simpan penanda agar tidak diulang.

PENANDA=/var/lib/app/migrasi-selesai

if [ ! -f "$PENANDA" ]; then
  echo "Menjalankan migrasi basis data..."
  jalankan_migrasi
  mkdir -p "$(dirname "$PENANDA")"
  date -Iseconds > "$PENANDA"
else
  echo "Migrasi sudah pernah dijalankan, dilewati."
fi

Hati-hati: penanda harus dihapus bila migrasi gagal di tengah, atau bila Anda ingin menjalankannya ulang.

Pola 6 — Uji dengan menjalankan dua kali

Cara termudah memverifikasi idempotensi adalah menjalankannya dua kali berturut-turut dan membandingkan keadaan sistem.

# Jalankan sekali
./skrip.sh
sebelum=$(find /etc /opt -newer /tmp/penanda -type f 2>/dev/null | sort)

# Jalankan lagi
./skrip.sh
sesudah=$(find /etc /opt -newer /tmp/penanda -type f 2>/dev/null | sort)

if [ "$sebelum" = "$sesudah" ]; then
  echo "Idempoten: tidak ada perubahan pada eksekusi kedua"
else
  echo "PERINGATAN: eksekusi kedua mengubah sesuatu"
  diff <(echo "$sebelum") <(echo "$sesudah")
fi

Pola 7 — Beri keluaran yang bisa dibaca

Skrip yang akan dijalankan orang lain harus menjelaskan apa yang dilakukannya.

log() { printf '[%s] %s\n' "$(date +%H:%M:%S)" "$*"; }

log "Memeriksa paket yang diperlukan"
if ! command -v curl >/dev/null 2>&1; then
  log "curl belum ada, memasang"
  apt install -y curl
fi
log "Selesai"

Ringkasan

  1. Periksa sebelum mengubah
  2. Pilih opsi perintah yang sudah idempoten
  3. Aktifkan set -euo pipefail
  4. Tangani keadaan setengah jadi dengan trap
  5. Simpan penanda untuk langkah berat
  6. Uji dengan menjalankan dua kali
  7. Beri keluaran yang jelas

Skrip idempoten mengubah otomasi dari sesuatu yang ditakuti menjadi sesuatu yang dapat diandalkan. Anda dapat menjalankannya kapan saja tanpa perlu mengingat apakah sudah pernah dijalankan.