Надёжные скрипты

#!/usr/bin/env bash — корректный shebang для переносимых bash-скриптов. Он просит ОС запустить тот bash, который первым встречается в $PATH, а не указывает жёстко /bin/bash (которого нет в некоторых системах — NixOS, ряд контейнеров).

#!/usr/bin/env bash
# Всегда первая строка — никаких пустых строк выше

/bin/sh вызывает системную POSIX-оболочку — это может быть dash, ash или busybox, но не bash. Если скрипт использует [[ ]], массивы или другие bash-специфичные возможности, он обязан использовать #!/usr/bin/env bash. Запуск bash-скрипта под sh даёт загадочные ошибки разбора для конструкций, корректных в bash, но не в POSIX sh.

set -e завершает скрипт немедленно, если любая команда вернула ненулевой код выхода. Без него каждая упавшая команда молча игнорируется и выполнение продолжается.

set -e
cp /nonexistent /tmp/   # выходит здесь — cp упал
echo "Это никогда не выполнится"  # пропущено

set -u трактует любую ссылку на незаданную переменную как ошибку и завершает скрипт.

set -u
echo "$UNDEFINED_VAR"   # выходит: bash: UNDEFINED_VAR: unbound variable

Это перехватывает баг с опечаткой в переменной: $TEMP_DIR против $TMPDIR — одна задана, другая нет, и без -u незаданная молча раскрывается в пустую строку, вызывая rm -rf "" или cd "".

set -o pipefail заставляет конвейер упасть, если любая стадия упала, а не только последняя.

set -o pipefail
grep "шаблон" missing_file.txt | wc -l
# Без pipefail: завершается с 0 (wc успешен)
# С pipefail:   завершается с ненулевым (grep упал)

Ставь все три вместе в начале каждого скрипта:

set -euo pipefail

trap 'команда_очистки' СИГНАЛ регистрирует команду, которая выполнится при получении сигнала или выходе. Самый полезный сигнал — EXIT: он срабатывает при любом выходе, включая ошибки.

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

TMPDIR=$(mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT   # всегда очищается, даже при ошибке

# ... тело скрипта использует $TMPDIR ...
cp important_data.txt "$TMPDIR/"
process "$TMPDIR/important_data.txt"

Без trap сбой на середине оставляет $TMPDIR на диске. С ним bash запускает rm -rf "$TMPDIR" перед завершением процесса — независимо от того, как он завершается: нормально, через exit 1 или из-за необработанной ошибки.

Несколько сигналов: trap 'cleanup' EXIT INT TERM также обрабатывает Ctrl-C (INT) и kill (TERM).

Функции инкапсулируют переиспользуемую логику. local предотвращает утечку переменных в область вызывающего.

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

log() {
  local level="$1"
  local msg="$2"
  echo "[$(date +%T)] [$level] $msg" >&2
}

backup_file() {
  local src="$1"
  local dest="${src}.bak.$(date +%s)"
  cp "$src" "$dest"
  log INFO "Скопировано $src в $dest"
}

backup_file /etc/nginx/nginx.conf

Без local переменные level, msg, src, dest — глобальные. Если вызывающая функция тоже использует переменную с именем dest, внутренняя функция перезапишет её. local ограничивает переменную стековым фреймом функции. Это не опциональный стиль — это предотвращение action-at-a-distance багов в скриптах длиннее пары функций.

Функции возвращают коды выхода как команды. return 0 — успех; return N — ошибка. Код выхода последней команды — это код выхода функции, если явно не вызывается return.

Три распространённые ловушки set -e, подстерегающие опытных инженеров.

Ловушка 1: команды в условиях if освобождены от действия -e. set -e не срабатывает, когда команда используется непосредственно как условие.

set -e
if grep -q "шаблон" file.txt; then echo "найдено"; fi  # grep код 1 = не найдено, без abort
grep -q "шаблон" file.txt   # ЭТО вызовет abort при коде 1

Ловушка 2: последняя команда в конвейере определяет pipefail. С pipefail код выхода конвейера — это самый правый ненулевой код выхода. Если несколько стадий упали, сообщается только о последнем ненулевом.

Ловушка 3: local сама является командой с кодом выхода. Это тонкая ловушка:

set -e
get_value() {
  local val=$(failing_command)   # НЕВЕРНО: local возвращает 0, даже если $() упал
  local val
  val=$(failing_command)         # ПРАВИЛЬНО: объявление отдельно от присваивания
}

local val=$(cmd) вычисляет cmd, присваивает val, затем local выполняется и возвращает 0 независимо от результата — проглатывая ошибку. Сначала объяви local, затем присваивай отдельной строкой.