Skrip dalam Bash dengan set -euo pipefail, trap dan logging

Kemaskini terakhir: 17/12/2025
Pengarang Ishak
  • Mengaktifkan `set -euo pipefail` dan IFS selamat membolehkan skrip bash gagal lebih awal dan mengelakkan ralat senyap semasa mengendalikan kod keluar dan pembolehubah yang tidak ditakrifkan.
  • Menggunakan perangkap untuk ERR dan isyarat seperti INT atau TERM memudahkan untuk merekodkan kerosakan, melakukan pembersihan terkawal dan memastikan sistem dalam keadaan yang konsisten.
  • Sistem pembalakan berpusat dengan tahap dan cap waktu meningkatkan kebolehkesanan, penyahpepijatan dan penyepaduan skrip dalam persekitaran DevOps dan CI/CD.
  • Gabungan pengaturcaraan pertahanan, pengesahan input dan amalan penyahpepijatan yang baik menjadikan skrip bash boleh dipercayai dalam pengeluaran.

Apakah gumpalan binari atau proprietari dalam Linux?

Mengautomasikan tugas dengan Bash membuat semua perbezaan antara sistem yang memerlukan pemantauan berterusan dan sistem yang hanya berjalan sendiri dan memberi amaran kepada anda apabila ada masalah . Dalam persekitaran DevOps dan pentadbiran sistem, skrip yang baik bukan sekadar merangkaikan arahan : ia juga tentang mencegah kegagalan senyap, mendayakan penyahpepijatan pantas dan meninggalkan jejak log yang jelas untuk memahami apa yang berlaku dan bila.

Apabila anda mula bekerja dengan serius dengan skrip, anda mendapati bahawa Bash, secara lalai, agak permisif: jika ada masalah, skrip biasanya berterusan seolah-olah tiada apa yang berlaku, menggunakan pembolehubah kosong atau hasil yang tidak lengkap . Ini membawa kepada kisah-kisah seram seperti sandaran terpenggal (yang mana adalah dinasihatkan untuk disegerakkan dengan rsync pada Linux ), pemadaman besar-besaran disebabkan oleh laluan yang dibina dengan buruk, atau penggunaan yang kelihatan berjaya tetapi gagal di pertengahan jalan. Itulah sebabnya sangat masuk akal untuk mempelajari cara menggunakan `set -euo`, `pipefail`, `trap` dan sistem pengelogan yang baik dengan betul.

Mengapa Bash kekal penting dalam DevOps

Dalam kerja harian sistem dan DevOps, Bash kekal sebagai alat pilihan: pada pelayan Linux , kontena, mesin CI/CD, skrip penyelenggaraan… Kelebihan terbesarnya ialah anda tidak bergantung pada pemasangan runtime atau pustaka luaran ; dengan shell yang disertakan dengan sistem, anda boleh mengautomasikan segala-galanya daripada pemeriksaan kesihatan hinggalah kepada pelaksanaan yang lengkap.

Kuasa itu datang dengan satu kekurangan: dengan skrip yang ditulis dengan buruk, terlalu mudah untuk arahan gagal sementara skrip yang lain berterusan seolah-olah semuanya berjalan dengan sempurna . Tambahkan pada tugas kritikal itu (sandaran, penggiliran log, pemadaman fail, pelaksanaan berjadual), dan risikonya bukanlah teori: lambat laun, sesuatu akan rosak tanpa anda sedari.

Itulah sebabnya sangat penting, selain daripada automasi, anda memasukkan pengendalian ralat, penyahpepijatan dan pembalakan berstruktur dari awal lagi . Dan di situlah tiga elemen memainkan peranan yang diulang dalam semua contoh skrip Bash moden yang baik: `set -euo pipefail`, `trap` dan sistem pembalakan yang konsisten.

Contoh praktikal: skrip pemantauan dengan pengendalian ralat yang ketat

Satu corak yang sangat berguna adalah untuk mencipta skrip pemantauan yang mengumpul maklumat sistem utama (CPU, memori, cakera, rangkaian, proses, log terkini, dsb.) dan yang juga gagal dengan selamat, meninggalkan kesan yang jelas dalam fail log . Skrip jenis ini boleh digunakan secara manual, daripada cron atau sebagai sokongan dalam saluran paip CI/CD.

Idea umum Idea umum adalah untuk mempunyai skrip dengan:

  • Mod ketat diaktifkan Gunakan `set -euo pipefail` untuk gagal lebih awal dan tidak terus berjalan pada keadaan yang tidak konsisten.
  • perangkap pada ERR dan isyarat seperti INT atau TERM untuk merekodkan kesilapan dan membersihkan sebelum pergi.
  • Fungsi pembalakan berpusat yang menulis untuk mengkonsole fail dengan cap waktu dan tahap (INFO, AMARAN, RALAT).
  • Pemeriksaan modular Log CPU, memori, cakera, rangkaian dan sistem.
  • Pemasangan kebergantungan pilihan seperti sysstat, lm-sensors atau net-tools, yang disesuaikan dengan Debian/Ubuntu atau RHEL/CentOS/Fedora.

Dalam skrip jenis ini, adalah perkara biasa untuk melihat sesuatu seperti:

  • Pembolehubah warna untuk mengetengahkan amaran dan kesilapan dalam terminal (MERAH, HIJAU, KUNING, BIRU, NC).
  • Laluan seperti /var/log/system-monitor.log untuk log umum dan /var/log/system-metrics.log untuk metrik berkala.
  • Ambang yang boleh dikonfigurasikan amaran: contohnya, ALERT_CPU_THRESHOLD=80, ALERT_MEM_THRESHOLD=80, ALERT_DISK_THRESHOLD=85.
  • Un selang pemantauan MONITOR_INTERVAL untuk mengulangi pemeriksaan setiap X saat jika anda menjalankan skrip dalam satu gelung.

Dengan asas itu, skrip yang mantap dibina yang bukan sahaja mengumpul maklumat, tetapi juga bertindak balas dengan betul terhadap kegagalan, meninggalkan bukti yang jelas dan boleh diintegrasikan ke dalam proses yang lebih besar.

Aktifkan mod ketat: tetapkan -euo pipefail dan selamatkan IFS

Kebanyakan masalah "pelik" dalam Bash berpunca daripada fakta bahawa shell, secara lalai, tidak menganggapnya serius jika arahan gagal atau pembolehubah tidak wujud . Untuk memaksa tingkah laku yang lebih selamat, orang ramai sering mengaktifkan apa yang ramai panggil "mod Bash ketat".

  Ketahui cara Mencetak ke PDF atau Simpan Sebagai PDF dalam Microsoft Excel

Komponen asas mod ketat itu ialah:

  • set -e: menyebabkan skrip tamat sebaik sahaja arahan mengembalikan kod keluar bukan 0, kecuali dalam beberapa konteks khas (jika, sementara, &&, ||…).
  • tetapkan -u o kata nama set -o: menyebabkan ralat apabila anda cuba menggunakan pembolehubah yang tidak ditakrifkan, dan bukannya menganggapnya sebagai rentetan kosong.
  • set -o pipefail: menjadikan kod keluar dalam saluran paip yang merupakan kod arahan pertama yang gagal, bukan hanya yang terakhir.
  • IFS=$'\n\t': mengehadkan pemisah medan dalaman kepada pemisah baris dan tab untuk mengelakkan ruang daripada dipecahkan untuk gelung pada senarai fail atau yang serupa.

Menggabungkan semuanya menghasilkan sesuatu yang sangat biasa dalam pengepala skrip yang serius:

set -euo pipefail
IFS=$'\n\t'
kepala katil yang selamat

Ini menghalang situasi di mana arahan perantaraan dalam saluran paip gagal, tetapi skrip diteruskan kerana arahan terakhir mengembalikan 0. Ia juga menghalang pembolehubah yang salah eja atau tidak ditakrifkan daripada menjadi rentetan kosong secara senyap, yang selalunya menjadi punca laluan yang salah atau syarat logik yang tidak pernah dipenuhi.

Perangkap set -e: mengapa ia bukan sihir dan boleh merosakkan skrip anda

Walaupun sangat berguna, `set -e` bukanlah penyelesaian yang mudah . ​​Kelakuannya mempunyai nuansa yang boleh mengelirukan jika anda tidak memahami cara ia berfungsi. Contohnya, beberapa binaan seperti:

  • Perintah dalam if, while o until.
  • Ungkapan dengan && y || untuk kawalan aliran.
  • Pengembangan aritmetik tertentu.

Ia tidak mencetuskan "keluar segera" seperti yang anda jangkakan. Contoh klasik ialah pengembangan aritmetik dengan post-increment :

((contador++))

Pengembangan aritmetik mengembalikan nilai yang ditafsirkan oleh Bash sebagai kod keluar. Dalam kes pasca-tambahan, apabila ungkapan mengembalikan 0, ia dianggap berjaya, tetapi pada masa lain ia mungkin mengembalikan 1, yang, dengan ` set -e`, menyebabkan skrip tamat serta-merta . Sesuatu yang kelihatan tidak berbahaya seperti kaunter dalam gelung boleh menyebabkan skrip anda keluar lebih awal.

Sebaliknya, konstruk seperti ((++i)) atau ((i+=1)) bertindak secara berbeza dan tidak mencetuskan masalah yang sama. Ini menunjukkan bahawa dengan `set -e` anda perlu sangat biasa dengan konstruk yang anda gunakan , kerana terdapat banyak kes sempadan.

Oleh itu, beberapa penulis dan pentadbir yang berpengalaman mengesyorkan penggunaan set -e terutamanya dalam fasa pengujian , sebagai cara yang agresif untuk mencari titik lemah, tetapi dalam pengeluaran mereka lebih suka pendekatan yang lebih eksplisit: menyemak kod keluar dengan tangan dan memutuskan dengan tepat bila dan bagaimana untuk membatalkan skrip.

perangkap: menangkap ralat dan isyarat untuk membersihkan dan log dengan betul

Perintah `trap` merupakan satu lagi peranan penting apabila kita bercakap tentang skrip pertahanan dalam Bash. Pada asasnya, ia membolehkan anda menentukan arahan atau fungsi yang ingin anda laksanakan apabila shell menerima isyarat atau peristiwa khas (seperti ERR atau EXIT).

Kegunaan tipikal Kegunaan tipikal trap dalam skrip robust ialah:

  • perangkap 'fungsi_pengendalian_ralat' ERR: melaksanakan logik pengendalian ralat sebaik sahaja arahan gagal.
  • perangkap 'fungsi_pembersihan' INT TERM: bertindak balas terhadap isyarat seperti CTRL+C (SIGINT) atau hentikan permintaan (SIGTERM).
  • perangkap 'fungsi_penyelesaian' KELUAR: laksanakan blok setelah keluar dari skrip, tidak kira sama ada ia berjalan lancar atau tidak.

Bayangkan skrip yang, setelah menerima CTRL+C, bukannya berhenti secara tiba-tiba, memanggil fungsi pembersihan yang memadam fail sementara, menutup sambungan atau meninggalkan mesej yang jelas dalam log:

trap 'limpieza' TERM INT
function limpieza(){
echo "Ejecutando limpieza, el usuario uso CTRL + C"
# ... lógica de limpieza ...
}
tindakan pencegahan

Corak ini amat berguna dalam proses yang panjang (sandaran, ETL, penggunaan) di mana anda mahu dapat menghentikannya secara terkawal tanpa meninggalkan sistem dalam keadaan yang tidak konsisten.

Apa yang anda boleh dan tidak boleh tangkap dengan perangkap ERR

Contoh biasa: Ramai panduan mencadangkan penggunaan sesuatu seperti:

trap 'echo "Error en línea $LINENO" >&2' ERR garisan tangkapan

untuk merekodkan kerosakan dengan nombor taliannya. Tidak mengapa, tetapi penting untuk memahami batasannya . Perangkap boleh:

  • Laksanakan kod tambahan apabila ERR dicetuskanContohnya, menulis ke log dengan tarikh, skrip dan baris.
  • Akses kod keluar arahan terakhir dengan $?.
  • Untuk tahu baris skrip dengan $LINENO, sangat berguna untuk penyahpepijatan.

Apa yang tidak boleh dilakukan oleh perangkap ERR ialah "menyelamatkan" output ralat standard (stderr) arahan yang telah dijalankan, melainkan anda telah mengalihkannya sebelum ini ke fail atau deskriptor yang kemudiannya boleh anda baca. Ralat itu sendiri ialah aliran teks, bukan satu nilai.

  Ketahui cara Memasukkan Imej Ke Dalam Sel Excel

Sesetengah corak melibatkan pengalihan output stderr keseluruhan skrip ke log sementara dan, dalam perangkap, menambah pengepala dengan tarikh, fail dan nombor baris supaya blok ralat boleh dikaitkan dengan titik dalam skrip tempat kegagalan berlaku. Ia lebih banyak kerja, tetapi apabila sesuatu ranap dalam pengeluaran, anda menghargai mempunyai konteks.

Log masuk Bash: hanya merekodkan apa yang perlu, diformat dan tanpa mengeruhkan keadaan

Jika anda mengautomasikan walaupun tugas yang paling kritikal, anda perlu tahu apa yang berlaku, bila dan apakah hasilnya . Itulah sebabnya hampir semua contoh skrip yang serius akhirnya menyertakan fungsi pengelogan berpusat untuk menyeragamkan format.

Fungsi tipikal mungkin kelihatan seperti ini:

log_message() {
local level="$1"
local message="$2"
local timestamp=$(date "+%Y-%m-%d %H:%M:%S")
echo -e "${timestamp} ${message}" | tee -a "$LOG_FILE"
}
format bersatu

Contoh: Dengan sesuatu seperti ini, anda boleh menghubungi:

  • log_message "INFO" "Memulakan pemeriksaan CPU"
  • log_message "AMARAN" "Penggunaan cakera melebihi 85%"
  • log_message "RALAT" "Tidak dapat menyambung ke pangkalan data"

dan sentiasa kekalkan format yang sama, dengan tarikh dan aras ditanda dengan jelas. Menggunakan `tee -a` juga membolehkan anda melihat mesej pada skrin dan menyimpannya ke fail log secara serentak, yang sangat mudah untuk kegunaan interaktif dan analisis kemudian.

Satu lagi amalan yang baik adalah untuk memisahkan log aktiviti (apa yang dilakukan oleh skrip) dan log metrik atau hasil (CPU, RAM, penggunaan cakera, dll.) ke dalam fail yang berbeza. Contohnya:

  • /var/log/monitor-sistem.log untuk acara dan mesej.
  • /var/log/sistem-metrik.log untuk rekod status berkala.

Ini memudahkan penyepaduan. Ini kemudiannya memudahkan penyuapan alatan luaran, penghurai atau penyelesaian kebolehcerapan tanpa mencampurkan mesej manusia dengan data mesin.

Semakan status sistem: CPU, memori, cakera, rangkaian dan log

Satu penggunaan Bash yang sangat biasa dalam persekitaran Linux adalah untuk melaksanakan skrip "pemeriksaan sistem pantas" yang mengumpulkan maklumat asas yang diperlukan untuk mendiagnosis masalah sekaligus . Skrip jenis ini biasanya merangkumi beberapa blok:

  • Beban CPU: memakai mpstat jika ia tersedia (terima kasih kepada pakej sysstat), atau dengan menggunakan top dalam mod kelompok untuk mendapatkan ringkasan penggunaan CPU.
  • Proses teratas setiap CPU: dengan ps aux --sort=-%cpu | head -n N untuk melihat sumber yang paling banyak digunakan.
  • Ruang cakera: dengan df -h, memberi perhatian khusus kepada partition root dan sebarang volum kritikal aplikasi atau pangkalan data (lihat bagaimana kosongkan ruang dalam Linux).
  • RAM dan memori SWAP: melalui free -huntuk melihat berapa banyak yang digunakan dan sama ada penggunaan swap yang berlebihan sedang digunakan.
  • Status rangkaian: menyemak sambungan luaran dengan ping ke IP yang diketahui (biasanya 8.8.8.8) dan menyenaraikan antara muka aktif dengan ip addr showdan menggunakan alat seperti netcat (nc/ncat) untuk ujian yang lebih lanjut.
  • Log sistem terkini: melukis garisan terakhir dengan journalctl -n atau setaraf, untuk mengesan ralat perkhidmatan sebelum skrip dijalankan.

Hasilnya biasanya disimpan dalam fail log atau dipaparkan dalam format pada skrin, berfungsi sebagai gambaran ringkas tentang kesihatan sistem yang boleh anda semak sendiri atau sepadukan ke dalam alat pemantauan.

Pemasangan kebergantungan automatik dan pemeriksaan keistimewaan

Prasyarat Satu butiran penting bagi banyak skrip pentadbiran ialah, sebelum melakukan sesuatu yang serius, ia mengesahkan bahawa dua syarat dipenuhi:

  • Skrip sedang berjalan seperti akar (atau melalui selatan).
  • Alat-alat yang diperlukan telah dipasang bergantung pada sistem pengendalian.

pengesahan akar Pengesahan akar biasanya dilakukan dengan $EUID:

check_root() {
if ; then
log_message "ERROR" "Este script necesita privilegios de root para instalar paquetes."
log_message "WARNING" "Por favor, ejecute con sudo."
exit 1
fi
}
Ia gagal jika anda tidak mempunyai root.

Dengan cara ini anda mengelakkan ralat kemudian disebabkan oleh kebenaran yang tidak mencukupi dan menghantar mesej yang jelas kepada pengguna dari awal.

mengesan distro Pemasangan kebergantungan biasanya disokong oleh /etc/os-release untuk mengesan keluarga taburan:

  • En Debian / Ubuntu ia digunakan apt-get untuk memasang pakej seperti sysstat, lm-sensors, net-tools.
  • En CentOS / RHEL / Fedora akan ditarik dnf o yum dengan pakej yang setara (lm_sensors, net-tools, dll.).

Eksport amaran, cron dan log: membawa skrip ke pengeluaran

Sebaik sahaja anda mempunyai skrip semakan atau automasi yang agak mantap, langkah logik seterusnya adalah mengintegrasikannya ke dalam rutin harian anda :

  • Makluman melalui e-mel, Slack atau saluran lainContohnya, jika penggunaan cakera melebihi 90%, anda menghantar e-mel menggunakan mailx atau Slack webhook. Corak biasa adalah untuk menyemak nilai dengan df/awk/sed dan, jika ia melebihi ambang tertentu, cetuskan pemberitahuan.
  • Pelaksanaan berkala dengan cron: tambah entri seperti ini 0 8 * * * /ruta/a/script.sh supaya ia berjalan setiap hari pada waktu tertentu.
  • Mengalihkan output ke fail log: laksanakan ./script.sh > /var/log/system-check.log 2>&1 jika anda ingin merekodkan semua output standard dan ralat ke satu fail.
  Konfigurasikan tindakan pantas dalam Pusat Tindakan Windows

Adalah penting untuk memahami bahawa jika skrip anda direka bentuk untuk berhenti pada ralat pertama menggunakan `set -euo pipefail`, ini bermakna kerja cron atau saluran paip CI/CD yang memanggilnya akan melihat kod keluar bukan sifar dengan jelas apabila terdapat kegagalan, membolehkan anda mencetuskan aliran pemulihan, menandakan binaan sebagai gagal dan sebagainya.

Penyahpepijatan dalam Bash: tetapkan jejak -x, -v, -ny ke fail

Bash tidak mempunyai penyahpepijat seperti beberapa bahasa lain, tetapi ia menyediakan beberapa pilihan penyahpepijatan yang sangat berkuasa yang, apabila digunakan dengan betul, menjimatkan banyak jam "mengapa ini berlaku?":

  • set -x o set -o xtrace: memaparkan setiap arahan yang dilaksanakan dengan semua parameternya telah dikembangkan. Sesuai untuk melihat nilai sebenar yang diambil oleh pembolehubah.
  • tetapkan -v o set -o verbose: Mencetak baris skrip semasa ia dibaca, walaupun sebelum pengembangan. Berguna untuk memahami aliran.
  • tetapkan -n o tetapkan -o noexec: menganalisis sintaks tanpa melaksanakan kod, sesuai untuk menangkap petikan, pendakap atau kurungan yang hilang.
  • tetapkan -uSeperti yang telah disebutkan, ia gagal apabila pembolehubah yang tidak ditakrifkan digunakan, yang sangat berguna semasa penyahpepijatan ralat logik.

Selain itu, anda boleh mengehadkan kesan pilihan ini kepada serpihan skrip tertentu dengan membalutnya dengan `set -x` / `set +x`, contohnya:

set -x
# bloque problemático
read -p "Pass Dir name : " D_OBJECT
read -p "Pass File name : " F_OBJECT
set +x
jejak masa

#!/bin/bash
exec 6> salida_debug.log
BASH_XTRACEFD="6"
set -x
# ... resto del script ...
lencongan jejak

Oleh itu, semua maklumat penyahpepijatan disimpan dalam output_debug.log , dan anda hanya boleh terus melihat output "normal" skrip dalam terminal.

Contoh tipikal pepijat dengan pembolehubah yang tidak ditakrifkan

Satu masalah yang sangat biasa apabila anda tidak menggunakan `set -u` ialah menggunakan pembolehubah yang tidak wujud tanpa disedari. Bayangkan skrip yang meminta nama objek dan kemudian menyemak sama ada ia fail atau direktori, tetapi menggunakan nama pembolehubah yang salah:

#!/bin/bash
read -p "Nombre del Objeto : " OBJECT
if ]; then
echo "$OBJECT es un archivo"
elif ]; then
echo "$OBJECT es un directorio"
fi
ralat berubah-ubah

Oleh kerana $OBJECT1 tidak ditakrifkan , Bash mengembangkannya kepada rentetan kosong; ujian -fy -d tidak mengembalikan ralat, ia hanya gagal, dan skrip keluar dengan kod 0. Tiada apa yang "berlaku," tetapi secara logiknya hasilnya bukanlah seperti yang dijangkakan.

Jika anda menjalankan skrip dengan `bash -u scriptname` atau menggunakan `set -u` , anda akan serta-merta mendapat ralat "Unbound variable", yang akan membawa anda terus ke kesalahan jenis. Digabungkan dengan `bash -x scriptname` atau `set -x`, anda juga akan melihat baris dan nilai tertentu digunakan, menjadikan penyahpepijatan lebih mudah.

Mencipta Bekas Ringan dengan Podman di Linux
Artikel berkaitan:
Bekas Ringan dengan Podman di Linux: Panduan Praktikal
Ishak

Isaac

Penulis yang bersemangat tentang dunia bait dan teknologi secara umum. Saya suka berkongsi pengetahuan saya melalui penulisan, dan itulah yang akan saya lakukan dalam blog ini, menunjukkan kepada anda semua perkara yang paling menarik tentang alat, perisian, perkakasan, trend teknologi dan banyak lagi. Matlamat saya adalah untuk membantu anda mengemudi dunia digital dengan cara yang mudah dan menghiburkan.