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.
| Tujuan | Tidak idempoten | Idempoten |
|---|---|---|
| Buat direktori | mkdir /opt/app | mkdir -p /opt/app |
| Buat tautan | ln -s a b | ln -sfn a b |
| Tambah pengguna ke grup | echo "user:x:1000:" >> /etc/group | usermod -aG grup user |
| Pasang paket | dpkg -i paket.deb | apt install -y paket |
| Ubah baris konfigurasi | echo "x=1" >> conf | Periksa 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
- Periksa sebelum mengubah
- Pilih opsi perintah yang sudah idempoten
- Aktifkan
set -euo pipefail - Tangani keadaan setengah jadi dengan
trap - Simpan penanda untuk langkah berat
- Uji dengan menjalankan dua kali
- 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.