Bash Scripting အကောင်းဆုံးအလေ့အကျင့်များ- ယုံကြည်စိတ်ချရသောနှင့် စွမ်းဆောင်ရည် Bash Scripts များအတွက် အမြန်လမ်းညွှန်

manapi မှ Shell နောက်ခံပုံ

bash script များကို အမှားရှာခြင်းသည် ကောက်ရိုးပုံအတွင်း အပ်တစ်ချောင်းကို ရှာဖွေခြင်းနှင့် တူသည်၊ အထူးသဖြင့် တည်ဆောက်ပုံ၊ မှတ်တမ်းနှင့် ယုံကြည်စိတ်ချရမှုဆိုင်ရာ ပြဿနာများကို အချိန်နှင့်တစ်ပြေးညီ ထည့်သွင်းစဉ်းစားခြင်းမရှိဘဲ လက်ရှိ codebase တွင် ထပ်တိုးအသစ်များ ပေါ်လာသည့်အခါတွင် ဖြစ်သည်။ သင့်ကိုယ်ပိုင်အမှားတွေကြောင့် ဒါမှမဟုတ် ရှုပ်ထွေးတဲ့ script တွေကို စီမံခန့်ခွဲတဲ့အခါ ဒီလိုအခြေအနေမျိုးမှာ သင်တွေ့နိုင်ပါတယ်။

အဖွဲ့ Mail.ru တိမ်တိုက်ဖြေရှင်းချက် သင်၏ script များကို ပိုကောင်းအောင် ရေးရန်၊ အမှားရှာရန်နှင့် ထိန်းသိမ်းရန် ကူညီပေးမည့် အကြံပြုချက်များဖြင့် ဆောင်းပါးတစ်ပုဒ်ကို ဘာသာပြန်ပါ။ ယုံသည်ဖြစ်စေ၊ မယုံသည်ဖြစ်စေ အချိန်တိုင်းအလုပ်လုပ်နိုင်သော သန့်ရှင်းပြီး အသုံးပြုရန် အဆင်သင့်သုံးနိုင်သော bash ကုဒ်ကိုရေးခြင်းသည် ကျေနပ်အားရမှုထက် သာလွန်သည် ။

ဆောင်းပါးတွင် စာရေးသူသည် လွန်ခဲ့သည့်နှစ်အနည်းငယ်အတွင်း သူလေ့လာသင်ယူခဲ့သည့်အရာများအပြင် သတိပြုမိစေသော အမှားအချို့ကိုလည်း မျှဝေပါသည်။ ဆော့ဖ်ဝဲလ်ဆော့ဖ်ဝဲလ်ဆော့ဖ်ဝဲလ်ဆော့ဖ်ဝဲရေးသားသူတိုင်းသည် ၎င်းတို့၏အသက်မွေးဝမ်းကြောင်းတွင် တစ်ချိန်ချိန်တွင်၊ လုပ်ရိုးလုပ်စဉ်အလုပ်များကို အလိုအလျောက်ပြန်ဖြစ်စေရန်အတွက် scripts များနှင့်အလုပ်လုပ်သောကြောင့် အရေးကြီးပါသည်။

ထောင်ချောက် ကိုင်တွယ်သူများ

ကျွန်တော်ကြုံတွေ့ဖူးသော bash script အများစုသည် script execute လုပ်နေစဉ်အတွင်း မမျှော်လင့်ထားသော အရာတစ်ခုဖြစ်ပေါ်လာသောအခါ ထိရောက်သော ရှင်းလင်းရေးယန္တရားကို မသုံးပါ။

အူတိုင်မှ အချက်ပြမှုကို လက်ခံခြင်းကဲ့သို့သော ပြင်ပမှ အံ့အားသင့်မှုများ ဖြစ်ပေါ်လာနိုင်သည်။ ဇာတ်ညွှန်းများသည် ထုတ်လုပ်ရေးစနစ်များပေါ်တွင် လုပ်ဆောင်ရန် လုံလောက်သော ယုံကြည်စိတ်ချရကြောင်း သေချာစေရန် အဆိုပါကိစ္စများကို ကိုင်တွယ်ရန် အလွန်အရေးကြီးပါသည်။ ဤကဲ့သို့သော အခြေအနေများကို တုံ့ပြန်ရန်အတွက် ထွက်ပေါက်လက်ကိုင်များကို ကျွန်ုပ်မကြာခဏအသုံးပြုသည်-

function handle_exit() {
  // Add cleanup code here
  // for eg. rm -f "/tmp/${lock_file}.lock"
  // exit with an appropriate status code
}
  
// trap <HANDLER_FXN> <LIST OF SIGNALS TO TRAP>
trap handle_exit 0 SIGHUP SIGINT SIGQUIT SIGABRT SIGTERM

trap အချက်ပြမှုများရှိပါက ခေါ်သည့် ရှင်းလင်းရေးလုပ်ဆောင်ချက်ကို မှတ်ပုံတင်ရန် ကူညီပေးသည့် shell built-in command တစ်ခုဖြစ်သည်။ သို့သော် ထိုကဲ့သို့သော ကိုင်တွယ်သူများနှင့် အထူးဂရုစိုက်သင့်သည်။ SIGINTဇာတ်ညွှန်းပျက်သွားစေသည်။

ထို့အပြင် ကိစ္စအများစုတွင် သင်သာ ဖမ်းသင့်သည်။ EXITဒါပေမယ့် အိုင်ဒီယာကတော့ အချက်ပြတစ်ခုချင်းစီအတွက် script ရဲ့ အမူအကျင့်တွေကို သင်အမှန်တကယ် စိတ်ကြိုက်ပြင်ဆင်နိုင်ပါတယ်။

Built-in set လုပ်ဆောင်ချက်များ - အမှားအယွင်းပေါ် အမြန်ရပ်စဲခြင်း။

အမှားများ ဖြစ်ပေါ်လာသည်နှင့် တပြိုင်နက် တုံ့ပြန်ရန်နှင့် အမြန်လုပ်ဆောင်ခြင်းကို ရပ်ရန် အလွန်အရေးကြီးပါသည်။ ဤကဲ့သို့သော command ကိုဆက်လက်လုပ်ဆောင်ခြင်းထက်ပိုမိုဆိုးရွားနိုင်သည်-

rm -rf ${directory_name}/*

variable ကို သတိပြုပါ။ directory_name မသတ်မှတ်။

ထိုသို့သောအခြေအနေများကိုကိုင်တွယ်ရန် built-in လုပ်ဆောင်ချက်များကိုအသုံးပြုရန်အရေးကြီးပါသည်။ setထိုသို့သောအဖြစ် set -o errexit, set -o pipefail သို့မဟုတ် set -o nounset ဇာတ်ညွှန်းရဲ့အစမှာ။ သင်၏ script သည် သုညမဟုတ်သော ထွက်ပေါက်ကုဒ်၊ သတ်မှတ်မထားသော ကိန်းရှင်များကို အသုံးပြုမှု၊ ပိုက်တစ်ခုမှ ဖြတ်သွားသော မမှန်ကန်သော ညွှန်ကြားချက်များနှင့် အခြားအရာများနှင့် ကြုံတွေ့သည်နှင့် တပြိုင်နက် ဤလုပ်ဆောင်ချက်များသည် ထွက်သွားကြောင်း သေချာစေသည်-

#!/usr/bin/env bash

set -o errexit
set -o nounset
set -o pipefail

function print_var() {
  echo "${var_value}"
}

print_var

$ ./sample.sh
./sample.sh: line 8: var_value: unbound variable

မှတ်ချက်: Built-in အစရှိတဲ့ Function တွေပါ။ set -o errexit"အကြမ်း" ပြန်ပေးကုဒ် (သုညမဟုတ်သော အခြား) "အကြမ်း" ရှိနေသည်နှင့် တပြိုင်နက်၊ ဇာတ်ညွှန်းမှ ထွက်ပါမည်။ ထို့ကြောင့် စိတ်ကြိုက် အမှားအယွင်း ကိုင်တွယ်ခြင်းကို မိတ်ဆက်ရန် ပိုကောင်းသည်၊ ဥပမာ၊

#!/bin/bash
error_exit() {
  line=$1
  shift 1
  echo "ERROR: non zero return code from line: $line -- $@"
  exit 1
}
a=0
let a++ || error_exit "$LINENO" "let operation returned non 0 code"
echo "you will never see me"
# run it, now we have useful debugging output
$ bash foo.sh
ERROR: non zero return code from line: 9 -- let operation returned non 0 code

ဤနည်းဖြင့် scripts များရေးသားခြင်းသည် သင့်အား script အတွင်းရှိ command များအားလုံး၏ အပြုအမူနှင့် ပတ်သက်၍ ပိုမိုသတိထားရန်နှင့် ၎င်းသည် သင့်အား မအံ့သြမီတွင် အမှားအယွင်းတစ်ခု ဖြစ်နိုင်ခြေကို ကြိုတင်ခန့်မှန်းရန် တွန်းအားပေးပါသည်။

ဖွံ့ဖြိုးတိုးတက်မှုအတွင်း အမှားအယွင်းများကို ရှာဖွေရန် ShellCheck

ပေါင်းစည်းရကျိုးနပ်ပါတယ်။ ရှဲ သင်၏ bash ကုဒ်ကို အကောင်းဆုံး အလေ့အကျင့်များနှင့် ဆန့်ကျင်၍ စစ်ဆေးရန် သင်၏ ဖွံ့ဖြိုးတိုးတက်မှုနှင့် စမ်းသပ်မှု ပိုက်လိုင်းများတွင်

တီထွင်နေစဉ်အတွင်း လွဲချော်သွားနိုင်သည့် ကုဒ်ရှိ အထားအသို၊ အဓိပ္ပာယ်နှင့် အချို့သော အမှားအယွင်းများကို ရယူရန် ကျွန်ုပ်၏ ဒေသဆိုင်ရာ ဖွံ့ဖြိုးတိုးတက်မှု ပတ်ဝန်းကျင်များတွင် ၎င်းကို အသုံးပြုပါသည်။ ၎င်းသည် သင်၏ bash scripts များအတွက် static analysis tool တစ်ခုဖြစ်ပြီး ၎င်းကိုအသုံးပြုရန် အထူးအကြံပြုလိုပါသည်။

သင့်ကိုယ်ပိုင် ထွက်ပေါက်ကုဒ်များကို အသုံးပြုခြင်း။

POSIX ရှိ ပြန်ပေးကုဒ်များသည် သုည သို့မဟုတ် တစ်ခုမျှသာမဟုတ်ဘဲ သုည သို့မဟုတ် သုညမဟုတ်သော တန်ဖိုးတစ်ခုဖြစ်သည်။ အမျိုးမျိုးသောအမှားအယွင်းကိစ္စများအတွက် စိတ်ကြိုက်အမှားကုဒ်များ (201-254 အကြား) ကို ပြန်ပေးရန် ဤအင်္ဂါရပ်များကို အသုံးပြုပါ။

အမှားအယွင်း အမျိုးအစားကို အတိအကျ သိရှိနားလည်ပြီး လျော်ညီစွာ တုံ့ပြန်ရန် သင့်အား ခြုံငုံထားသည့် အခြား script များမှ ဤအချက်အလက်ကို အသုံးပြုနိုင်ပါသည်။

#!/usr/bin/env bash

SUCCESS=0
FILE_NOT_FOUND=240
DOWNLOAD_FAILED=241

function read_file() {
  if ${file_not_found}; then
    return ${FILE_NOT_FOUND}
  fi
}

မှတ်ချက်: ပတ်ဝန်းကျင် ကိန်းရှင်များကို မတော်တဆ လွှမ်းမိုးခြင်းမှ ရှောင်ရှားရန် သင်သတ်မှတ်ထားသော ကိန်းရှင်အမည်များကို အထူးသတိထားပါ။

မှတ်တမ်းလုပ်ဆောင်ချက်များ

သင့် script ၏ရလဒ်များကို လွယ်ကူစွာ နားလည်နိုင်ရန် လှပပြီး စနစ်တကျ မှတ်တမ်းသွင်းခြင်းသည် အရေးကြီးပါသည်။ အခြားအဆင့်မြင့်ပရိုဂရမ်းမင်းဘာသာစကားများကဲ့သို့ပင်၊ ကျွန်ုပ်သည် ကျွန်ုပ်၏ bash script များကဲ့သို့သော မူရင်း logging functions များကို အမြဲသုံးပါသည်။ __msg_info, __msg_error ဒါပေါ်မှာ။

၎င်းသည် တစ်နေရာတည်းတွင် ပြောင်းလဲမှုများပြုလုပ်ခြင်းဖြင့် စံချိန်စံညွှန်းသတ်မှတ်ထားသော သစ်ခုတ်ခြင်းဖွဲ့စည်းပုံကို ပံ့ပိုးပေးသည်-

#!/usr/bin/env bash

function __msg_error() {
    [[ "${ERROR}" == "1" ]] && echo -e "[ERROR]: $*"
}

function __msg_debug() {
    [[ "${DEBUG}" == "1" ]] && echo -e "[DEBUG]: $*"
}

function __msg_info() {
    [[ "${INFO}" == "1" ]] && echo -e "[INFO]: $*"
}

__msg_error "File could not be found. Cannot proceed"

__msg_debug "Starting script execution with 276MB of available RAM"

ကျွန်ုပ်သည် ကျွန်ုပ်၏ ဇာတ်ညွှန်းများတွင် ယန္တရားတစ်မျိုးမျိုးရှိရန် ကြိုးစားလေ့ရှိပါသည်။ __initထိုသို့သော logger variable များနှင့် အခြားသော system variable များကို အစပျိုးခြင်း သို့မဟုတ် ပုံသေတန်ဖိုးများအဖြစ် သတ်မှတ်ထားသည့်နေရာတွင်၊ script invocation လုပ်နေစဉ်တွင် အဆိုပါ variable များကို command line ရွေးချယ်မှုများမှ သတ်မှတ်နိုင်သည်။

ဥပမာအားဖြင့်၊

$ ./run-script.sh --debug

ထိုသို့သော script ကိုလုပ်ဆောင်သောအခါ၊ လိုအပ်ပါက စနစ်တစ်ခုလုံးဆက်တင်များကို ပုံသေတန်ဖိုးများသတ်မှတ်ထားရန်၊ သို့မဟုတ် အနည်းဆုံး လိုအပ်ပါက သင့်လျော်သောတစ်ခုခုသို့ အစပြုလုပ်ဆောင်ကြောင်း သေချာစေသည်။

ကျွန်ုပ်သည် အသုံးပြုသူ အင်တာဖေ့စ်နှင့် အသုံးပြုသူ/ထည့်သွင်းသင့်သည့် ဖွဲ့စည်းမှုအသေးစိတ်များကြား အပေးအယူတစ်ခုတွင် အစပြုရမည့်အရာနှင့် ဘာလုပ်ရမည်ကို ရွေးချယ်မှုအပေါ် အခြေခံသည်။

ပြန်လည်အသုံးပြုရန်နှင့် သန့်ရှင်းမှုစနစ်အတွက် ဗိသုကာပညာ

မော်ဂျူလာ/ပြန်သုံးနိုင်သော ကုဒ်

├── framework
│   ├── common
│   │   ├── loggers.sh
│   │   ├── mail_reports.sh
│   │   └── slack_reports.sh
│   └── daily_database_operation.sh

ကျွန်ုပ်တီထွင်လိုသော ပရောဂျက်/ bash script အသစ်ကို အစပြုရန် အသုံးပြုနိုင်သည့် သီးခြား repository တစ်ခုကို သိမ်းဆည်းထားသည်။ ပြန်လည်အသုံးပြုနိုင်သည့် မည်သည့်အရာကိုမဆို repository တွင် သိမ်းဆည်းနိုင်ပြီး ထိုလုပ်ဆောင်ချက်ကို အသုံးပြုလိုသော အခြားပရောဂျက်များမှ ပြန်လည်ရယူနိုင်သည်။ ဤနည်းဖြင့် ပရောဂျက်များကို စုစည်းခြင်းသည် အခြားသော script များ၏ အရွယ်အစားကို သိသာထင်ရှားစွာ လျှော့ချပေးပြီး ကုဒ်အခြေခံသည် သေးငယ်ပြီး စမ်းသပ်ရန် လွယ်ကူကြောင်းလည်း သေချာစေသည်။

အထက်ဖော်ပြပါဥပမာတွင်ကဲ့သို့၊ ကဲ့သို့သော loggging functions များအားလုံး __msg_info, __msg_error နှင့် Slack အစီရင်ခံစာများကဲ့သို့သော အခြားအရာများကို သီးခြားစီပါရှိသည်။ common/* နှင့် ကဲ့သို့သော အခြားအခြေအနေများတွင် ဒိုင်းနမစ်ဖြင့် ချိတ်ဆက်ပါ။ daily_database_operation.sh.

သန့်ရှင်းတဲ့စနစ် ချန်ထားခဲ့ပါ။

အကယ်၍ သင်သည် ဇာတ်ညွှန်းကို လုပ်ဆောင်နေချိန်တွင် မည်သည့်အရင်းအမြစ်များကိုမဆို ဒေါင်းလုဒ်လုပ်နေပါက၊ ၎င်းဒေတာအားလုံးကို ကျပန်းအမည်ဖြင့် မျှဝေထားသော လမ်းညွှန်တွင် သိမ်းဆည်းရန် အကြံပြုပါသည်။ /tmp/AlRhYbD97/*. လမ်းညွှန်အမည်ကို ရွေးချယ်ရန် ကျပန်းစာသား ဂျင်နရေတာများကို သင်အသုံးပြုနိုင်သည်-

rand_dir_name="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 16 | head -n 1)"

အလုပ်ပြီးပါက၊ အထက်တွင်ဖော်ပြထားသော ချိတ်လက်ကိုင်ကိရိယာများတွင် အဆိုပါလမ်းညွှန်များကို ရှင်းလင်းပေးနိုင်ပါသည်။ ယာယီလမ်းညွှန်များကို ဂရုမစိုက်ပါက ၎င်းတို့သည် စုပြုံနေပြီး အချို့သောအဆင့်တွင် အပြည့်အဝဒစ်ကဲ့သို့သော host တွင် မမျှော်လင့်ထားသောပြဿနာများကို ဖြစ်စေသည်။

လော့ခ်ဖိုင်များကို အသုံးပြုခြင်း။

မကြာခဏဆိုသလို script တစ်ခု၏ဥပမာတစ်ခုသာ host တစ်ခုပေါ်တွင်အလုပ်လုပ်နေကြောင်းသေချာစေရန်မကြာခဏလိုအပ်သည်။ လော့ခ်ဖိုင်များကို အသုံးပြု၍ ၎င်းကို လုပ်ဆောင်နိုင်သည်။

သော့ခတ်ထားတဲ့ ဖိုင်တွေကို ကျွန်တော် ဖန်တီးလေ့ရှိပါတယ်။ /tmp/project_name/*.lock ဇာတ်ညွှန်း၏အစတွင် ၎င်းတို့၏ရှိနေခြင်းရှိမရှိ စစ်ဆေးပါ။ ၎င်းသည် ဇာတ်ညွှန်းကို ချောမွေ့စွာ အဆုံးသတ်စေပြီး အပြိုင်လုပ်ဆောင်နေသည့် အခြားသော script ဖြင့် စနစ်အခြေအနေသို့ မမျှော်လင့်ထားသော အပြောင်းအလဲများကို ရှောင်ရှားရန် ကူညီပေးသည်။ ပေးထားသော host တစ်ခုပေါ်တွင် တူညီသော script ကို အပြိုင်လုပ်ဆောင်ရန် လိုအပ်ပါက လော့ခ်ဖိုင်များကို မလိုအပ်ပါ။

တိုင်းတာပြီး တိုးတက်အောင်လုပ်ပါ။

ကျွန်ုပ်တို့သည် နေ့စဉ်ဒေတာဘေ့စ်လုပ်ဆောင်မှုများကဲ့သို့သော အချိန်ကြာမြင့်စွာ လုပ်ဆောင်သည့် script များနှင့် မကြာခဏလုပ်ဆောင်ရန် လိုအပ်ပါသည်။ ထိုသို့သောလုပ်ဆောင်မှုများတွင် ပုံမှန်အားဖြင့် အဆင့်များပါဝင်သည်- ဒေတာဖွင့်ခြင်း၊ ကွဲလွဲချက်များကိုစစ်ဆေးခြင်း၊ ဒေတာတင်သွင်းခြင်း၊ အခြေအနေအစီရင်ခံစာပေးပို့ခြင်းစသည်ဖြင့်။

ထိုသို့သောအခြေအနေမျိုးတွင်၊ ကျွန်ုပ်သည် ဇာတ်ညွှန်းကို သီးခြားအသေးစား script များအဖြစ် ခွဲခြမ်းပြီး ၎င်းတို့၏ အခြေအနေနှင့် လုပ်ဆောင်ချိန်ကို အသုံးပြု၍ အစီရင်ခံရန် အမြဲကြိုးစားသည်-

time source "${filepath}" "${args}">> "${LOG_DIR}/RUN_LOG" 2>&1

နောက်ပိုင်းတွင် ကွပ်မျက်သည့်အချိန်ကို မြင်နိုင်သည်-

tac "${LOG_DIR}/RUN_LOG.txt" | grep -m1 "real"

၎င်းသည် ပိုမိုကောင်းမွန်အောင်ပြုလုပ်ရန် လိုအပ်သော scripts များရှိ ပြဿနာ/နှေးကွေးသောနေရာများကို ဖော်ထုတ်ရန် ကျွန်ုပ်အား ကူညီပေးပါသည်။

ကံကောင်းပါစေ!

နောက်ထပ်ဖတ်စရာများ

1. သွားပြီး GPU ကက်ရှ်။
2. Mail.ru Cloud Solutions ၏ S3 အရာဝတ္ထုသိုလှောင်မှုတွင် webhooks များကိုအခြေခံထားသော ဖြစ်ရပ်မှမောင်းနှင်သည့်အက်ပ်တစ်ခု၏ဥပမာ။
3. ဒစ်ဂျစ်တယ်အသွင်ပြောင်းခြင်းအကြောင်း ကျွန်ုပ်တို့၏ကြေးနန်းလိုင်း။

source: www.habr.com