Skillum.AI
РазработкаИсточник изучен

Сделать Bash-скрипт устойчивым к сбоям

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

Получить скилл
Что передать агенту

Скрипт или описание автоматизации, входные данные, зависимости и возможные условия отказа.

Что получите

Bash-скрипт с понятными ошибочными путями, очисткой ресурсов, журналированием и результатами испытаний.

Кому пригодится

Разработчикам и системным администраторам, использующим Bash для автоматизации.

Требования и ограничения

Нужны Bash и используемые системные утилиты подходящих версий. Строгий режим требует осмысленной обработки ожидаемых неудач команд.

Сделать Bash-скрипт устойчивым к ошибкам

Скилл собирает приемы для автоматизации, CI, служебных утилит и сценариев администрирования. Он помогает заранее определить поведение при неверном вводе, отсутствии команды, частичном выполнении и повторном запуске. Основной файл содержит четырнадцать ориентиров, а подробные примеры вынесены в справочник. Это методика разработки: сама установка инструкции не меняет существующие скрипты и не гарантирует их надежность.

Явно определить обработку неудачных команд

Исходник предлагает строгий режим set -Eeuo pipefail и обработчики ошибок. Они делают часть скрытых сбоев заметнее, но требуют понимания контекста: условные выражения, конвейеры и подоболочки могут менять поведение. Для ожидаемой неудачи нужен явный разбор статуса. Нельзя считать включение одной строки достаточным подтверждением того, что любой ошибочный путь завершится нужным образом.

Передавать аргументы без случайного изменения

Переменные при передаче аргументов заключаются в кавычки, чтобы пробелы и символы шаблонов не меняли количество слов. Для условий используются средства Bash, для предсказуемого вывода — printf. Входные пути, форматы и права доступа оцениваются до изменения данных. При этом экранирование для оболочки не отменяет проверки смысла аргумента, который затем получит вызываемая программа.

Управлять временными файлами и очисткой

Временные ресурсы создаются через mktemp, а освобождение связывается с обработчиком завершения. Нужно заранее решить, что сохраняется для диагностики и что удаляется после успеха или ошибки. Скрипт должен знать точные созданные им пути. Очистка не должна затрагивать посторонние файлы из-за пустой переменной, совпавшего имени или неожиданно изменившейся рабочей папки.

Сделать действия обозримыми и повторяемыми

Методика рекомендует режим предварительного просмотра, журнал с временем и уровнем сообщения и функции с понятными именами. Повторное выполнение должно либо сохранять правильное состояние, либо явно объяснять конфликт. Предварительный просмотр показывает предполагаемые изменения, но не создает их. Журнал помогает увидеть ход работы, при этом секреты и чувствительные параметры не следует переносить в него без необходимости.

Испытать не только успешный запуск

Нужны сценарии отсутствующего файла, неверных прав, пустого ввода и отказа внешней команды. Зависимости и минимальные версии документируются, наличие утилит определяется через command -v. Для переносимости учитывается, что Bash и набор системных команд различаются между окружениями. Результат работы со скиллом — конкретный сценарий с осмысленными ошибочными путями и свидетельствами его поведения, а не формальный набор защитных строк.

Автор и источник

Оригинальное название: bash-defensive-patterns
Автор или репозиторий: wshobson/agents
Лицензия: MIT
Открыть первоисточник

Полный текст скилла

Нужен агент, который применит этот навык?

Поможем подключить его к вашим системам и настроить работу.