pipefail
Тема дорожной карты · Bash
Параметр оболочки pipefail, активируемый с помощью команды set -o pipefail, заставляет конвейер Bash возвращать статус завершения последней команды в конвейере, которая завершилась с ошибкой. Без использования pipefail конвейер может возвращать статус завершения финальной команды, что может скрыть сбой более ранних этапов. Это особенно важно для shell-скриптов и автоматизации Linux, где скрытые ошибки могут привести к серьезным проблемам.
В сочетании с set -e (выход при ошибке) и set -u (ошибка при использовании неопределенной переменной), set -o pipefail обеспечивает прерывание скрипта при любом сбое команды в конвейере. Такой подход является рекомендуемой практикой при защитном написании Bash-скриптов. Специальная переменная-массив $PIPESTATUS дополняет pipefail, записывая индивидуальные коды завершения каждой команды в последнем выполненном конвейере. Это позволяет получить детальную диагностику, когда несколько этапов могут завершиться с ошибкой.
Использование set -euo pipefail в начале каждого Bash-скрипта считается необходимым условием для производственной автоматизации Linux и DevOps shell-скриптов. Это помогает предотвратить распространение ошибок и обеспечивает более надежную работу скриптов.
Как это работает
pipefail работает в сочетании с другими параметрами оболочки, такими как set -e, set -u и set -o pipefail. set -e заставляет скрипт прекратить выполнение при возникновении ошибки, set -u вызывает ошибку при использовании неопределенной переменной, а set -o pipefail заставляет конвейер возвращать статус завершения последней команды, которая завершилась с ошибкой. Для захвата exit-кода можно использовать конструкции вида if ! cmd; then ...; fi или cmd; rc=$?.
Когда применять
Каждый скрипт следует начинать с set -euo pipefail и IFS=$'\n\t'. Trap для cleanup временных файлов можно задать с помощью trap "rm -f $tmp" EXIT. Для команд, которые могут легитимно упасть, можно использовать cmd || true для подавления ошибок. Всегда следует валидировать входные данные сверху и громко сообщать об ошибках, если необходимая переменная окружения отсутствует.
Типичные ошибки
Одной из распространенных ловушек при использовании pipefail является то, что set -e не ловит сбои внутри if, ||, && или в подоболочках. Также set -u может вызвать ошибку при использовании ${VAR:-default}-паттернов внутри массивов. Важно также отметить, что trap, вызывающий функцию, которая сама падает, может привести к проблемам в cleanup-цикле.