Bash прощает почти всё: опечатку в имени переменной, пробел в пути, отсутствующий файл. Скрипт «работает» до первого неожиданного имени или пустого значения, а потом удаляет не тот каталог. Несколько привычек убирают большинство таких сюрпризов.

Строгий режим

#!/usr/bin/env bash
set -euo pipefail
IFS=$'\n\t'
  • -e — остановиться при ошибке;
  • -u — упасть при обращении к неопределённой переменной;
  • -o pipefail — учитывать ошибку в любой части конвейера, а не только в последней;
  • IFS — не разбивать строки по пробелам неожиданно.

У -e есть исключения: команды в условиях if и после || не приводят к выходу. Это нормально, но требует понимания.

Кавычки

Всегда заключайте переменные в двойные кавычки: "$dir", "$@". Без них пробел в пути разобьёт аргумент на два. "$@" передаёт аргументы по отдельности, "$*" склеивает их в одну строку — это почти никогда не нужно.

Для массивов используйте "${arr[@]}". И не парсите вывод ls: имена с переводами строк сломают разбор. Берите glob или find -print0.

trap и временные файлы

tmpdir=$(mktemp -d)
cleanup() {
    rm -rf -- "$tmpdir"
}
trap cleanup EXIT INT TERM

trap ... EXIT выполнится и при успехе, и при ошибке. Это надёжнее, чем удалять файл в конце: при падении до этой строки мусор останется.

Для файлов рядом с рабочим каталогом используйте mktemp с шаблоном, а не фиксированное имя: два параллельных запуска не должны затирать данные друг друга.

Проверка аргументов

if [[ $# -lt 2 ]]; then
    echo "usage: $0 <source> <dest>" >&2
    exit 64
fi

src=$1
dest=$2

[[ -d "$src" ]] || { echo "нет каталога: $src" >&2; exit 66; }

Проверяйте существование файлов и каталогов до работы. Коды возврата вроде 64 и 66 из sysexits.h помогают отличить ошибку использования от отсутствующего файла.

Для разбора флагов подойдёт getopts:

while getopts ":o:v" opt; do
    case $opt in
        o) out=$OPTARG ;;
        v) verbose=1 ;;
        *) echo "неизвестный флаг: -$OPTARG" >&2; exit 64 ;;
    esac
done

Циклы и xargs

find . -type f -name '*.log' -print0 \
    | xargs -0 -n1 -P4 gzip

-print0 и -0 безопасно передают имена с пробелами. -P4 задаёт параллельность; для тяжёлых задач она ускоряет, для сетевых запросов может создать лишнюю нагрузку.

Не используйте for f in $(find ...): подстановка разобьёт имена и потеряет кавычки.

Логирование

log() {
    printf '%s %s\n' "$(date '+%F %T')" "$*" >> "$logfile"
}

Пишите дату, уровень и понятное сообщение. Для интерактивных скриптов дублируйте в stderr, для cron — в файл. Не логируйте пароли и токены, даже в отладочном режиме.

Проверка

Запустите shellcheck script.sh — он ловит неэкранированные переменные, неверные условия и типичные ошибки. Проверьте скрипт на пути с пробелом и кириллицей, на пустом каталоге и на отсутствующем файле. Эти три случая покрывают большинство падений.

Для задач по расписанию см. генератор cron, а для сравнения версий скрипта — сравнение кода.

Если скрипт может запускаться одновременно (cron и вручную), поставьте файловую блокировку: flock -n /tmp/task.lock ./task.sh. Без неё два процесса начнут писать в один файл и перемешают данные.

Возвращайте осмысленный код выхода: 0 — успех, 1 — общая ошибка, 2 — неверные аргументы. Мониторинг и cron по коду поймут, стоит ли слать уведомление.

Проверяйте скрипт в том окружении, где он будет работать: в cron другой PATH, нет интерактивного ввода и другие права. Абсолютные пути к php и утилитам снимают половину проблем.

Держите скрипт в репозитории и проверяйте его в CI так же, как код. Пара строк shellcheck и запуск на тестовом каталоге ловят ошибки до продакшена. И не делайте скрипт «умнее», чем нужно: чем меньше логики в bash, тем меньше способов сломаться.

Проверьте скрипт на пустом наборе файлов: отсутствие данных — самый частый сценарий в cron, и он не должен выглядеть как авария.

Коротко

  • set -euo pipefail — базовая защита;
  • кавычки вокруг переменных и "$@" обязательны;
  • trap ... EXIT убирает временные файлы;
  • аргументы проверяйте до начала работы;
  • find -print0 | xargs -0 вместо разбора ls.