Cara men-debug skrip Bash Linux dengan ShellCheck

Apakah Anda mengalami masalah dengan skrip Bash yang Anda tulis untuk PC Linux Anda ? Alih-alih mencari melalui utas yang tak terhitung jumlahnya di StackExchange untuk bantuan pemrograman, pertimbangkan untuk menggunakan alat ShellCheck untuk men-debug skrip Bash Linux dan secara otomatis menemukan kesalahan dalam kode Anda.

Dapatkan ShellCheck

ShellCheck adalah alat yang berguna, tetapi tidak disertakan dengan sistem operasi Linux Anda di luar kotak. Sebaliknya, jika Anda ingin menggunakannya, Anda harus menginstalnya terlebih dahulu. Dalam tutorial ini, kami akan membahas cara menginstal ShellCheck dari berbagai sumber perangkat lunak resmi. Selain itu, kami juga akan menunjukkan cara membuat program bekerja melalui biner Linux generik.

Buka jendela terminal dan perbarui paket Anda. Kemudian, ikuti instruksi yang sesuai dengan sistem operasi Linux Anda.

Ubuntu

ShellCheck ada di sumber perangkat lunak resmi Ubuntu, jadi menginstalnya cukup mudah. Di terminal, gunakan manajer paket Apt dan dapatkan versi terbaru dari ShellCheck yang berfungsi.

sudo apt install shellcheck

Debian

Debian Stable memiliki versi ShellCheck yang lebih lama yang siap dipasang oleh pengguna. Perlu diingat bahwa versi ini tertahan karena cara Debian melakukan sesuatu.

Catatan: ingin versi program ShellCheck yang lebih baru? Ikuti panduan kami dan pelajari tentang cara mendapatkan perangkat lunak yang lebih modern di Debian .

sudo apt-get install shellcheck

Arch Linux

Untuk mendapatkan ShellCheck di Arch Linux, pertama-tama Anda harus mengaktifkan repositori perangkat lunak "Komunitas". Mengaktifkan "Komunitas" memerlukan pengeditan file Pacman.conf. Untuk mengedit file, buka Pacman.conf di Nano.

sudo nano /etc/pacman.conf

Gulir (dengan tombol panah) dan temukan bagian "Komunitas" dari file tersebut. Hapus semua contoh simbol # (sekitar tiga baris). Kemudian, simpan hasil edit dengan menekan Ctrl + O tombol.

Dengan pengeditan baru pada Pacman.conf, tekan Ctrl + X untuk menutup Nano. Kemudian, sinkronkan ulang Pacman untuk mengatur akses ke repositori "Komunitas" Arch Linux.

sudo pacman -Syyuu

Terakhir, instal ShellCheck ke Arch Linux dengan:

sudo pacman -S shellcheck

Fedora

Untuk mendapatkan alat analisis skrip ShellCheck di Fedora Linux, buka terminal dan gunakan alat manajemen paket DNF.

sudo dnf instal ShellCheck

BukaSUSE

Menginstal ShellCheck di OpenSUSE tidak memerlukan langkah khusus, seperti yang ada di sumber perangkat lunak utama distribusi. Untuk mendapatkannya, masukkan perintah paket Zypper berikut di jendela terminal.

sudo zypper menginstal ShellCheck

Linux Umum

Pengguna distribusi Linux yang kurang dikenal yang menginginkan akses ke alat analisis skrip ShellCheck harus menginstal rilis biner universal. Untungnya, rilis biner ini mudah dipasang dan tidak perlu mengutak-atik kode sumber. Untuk membuatnya bekerja, ikuti langkah-langkah di bawah ini!

Langkah 1:   ekspor versi ShellCheck yang akan Anda unduh ke lingkungan terminal Anda.

export scversion= " stabil "  # atau "v0.4.7", atau "terbaru"

Langkah 2: menggunakan alat unduh wget , ambil rilis biner ShellCheck terbaru.

wget " https://storage.googleapis.com/shellcheck/shellcheck- ${scversion} .linux.x86_64.tar.xz "

Langkah 3: ekstrak arsip ShellCheck TarXZ dengan  perintah tar  .

tar --xz -xvf shellcheck- " ${scversion} " .linux.x86_64.tar.xz

Langkah 4: instal ShellCheck ke PC Linux Anda dengan perintah cp .

cp shellcheck- " ${scversion} " /shellcheck /usr/bin/

Debug skrip dengan ShellCheck

Tujuan utama ShellCheck adalah untuk memeriksa skrip (biasanya Bash), mendeteksi perintah yang disalahgunakan dan menawarkan koreksi. Untuk penggunaan dasar, lakukan hal berikut.

Pertama, CD tempat skrip yang ingin Anda periksa ada di PC Linux Anda. Dalam tutorial ini, skrip kita ada di ~/shell-scripts . Anda mungkin berbeda.

cd ~/skrip shell

Jalankan perintah ls dan lihat semua file di direktori saat ini.

Catatan: jika Anda ingin menggunakan ShellCheck di direktori dengan beberapa jenis file, ada baiknya untuk menggabungkan  grep  dan  ls  bersama-sama. Menggunakan dua perintah ini bersama-sama memungkinkan Anda untuk memfilter semua file non-skrip.

ls

Atau, gabungkan dengan grep untuk hanya melihat file skrip.

ls | grep ".sh"
ls | grep ".bash"

Temukan nama file skrip di ls prompt dan sorot nama file dengan mouse. Saat siap, jalankan melalui ShellCheck dan periksa kode Anda.

shellcheck nama-file.sh

atau

shellcheck nama-file.bash

Segera setelah perintah shellcheck berjalan, itu akan mendeteksi masalah dengan kode Anda dan memasukkannya ke terminal prompt. Baca dan pelajari cara meningkatkan pemrograman Anda dengan mengikuti saran yang diberikannya kepada Anda.

Simpan laporan ShellCheck ke file

Mendapatkan laporan instan di terminal untuk pemrograman bash Anda sangat berguna, namun Anda mungkin kehilangannya jika Anda menutup terminal. Untuk menyiasati hilangnya laporan shellcheck Anda, kami sarankan untuk menyimpan output ke file teks, dengan menjalankan program dalam kombinasi dengan fitur >> di terminal.

shellcheck name-of-file.sh >> ~/Documents/shellcheck-report-name-of-file.sh

atau

shellcheck nama-file.bash >> ~/Documents/shellcheck-report-name-of-file.bash

Lihat laporan tersimpan Anda di terminal melalui perintah cat .

cat ~/Documents/shellcheck-report-name-of-file.sh | lagi

atau

cat ~/Documents/shellcheck-report-name-of-file.bash | lagi