Идемпотентные shell-скрипты для системного администратора

Задача и общий подход

Материал посвящён теме «Идемпотентные shell-скрипты для системного администратора» с акцентом на безопасности и ограничению доступа.

Хорошая автоматизация повторно выполняется без разрушительных эффектов, останавливается при ошибке и оставляет понятный журнал действий.

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

Когда применять этот порядок

Этот сценарий подходит для следующих ситуаций:

• плановое внедрение или перенос компонента категории «Автоматизация» на новый VPS
• изменение портов, домена, сертификата, маршрута или способа публикации сервиса
• разбор инцидента, когда локальная и внешняя проверки дают разные результаты
• подготовка к обновлению пакета или восстановлению после неудачного изменения

Что должно получиться

После выполнения руководства по теме «Идемпотентные shell-скрипты для системного администратора» результат должен быть измеримым:

• исключить зависимость от временных правил и ручных действий
• зафиксировать логи и признаки успешного запуска
• получить воспроизводимую конфигурацию, проверяемую командами
• сохранить резервную точку и понятный сценарий отката

Подготовка перед изменениями

Подготовительный этап снижает риск потерять доступ и смешать несколько причин одной неисправности.

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

Пошаговая настройка

Выполняйте блоки последовательно и после каждого шага проверяйте код возврата команды.

#!/usr/bin/env bash
set -euo pipefail
IFS=$'\n\t'
log() { printf '%s %s\n' "$(date --iso-8601=seconds)" "$*"; }
trap 'log "ERROR line=$LINENO"' ERR

command -v nginx >/dev/null 2>&1 || { echo 'nginx not installed' >&2; exit 1; }

[Unit]
Description=IIAdmin maintenance job

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/iiadmin-maintenance
User=root

[Unit]
Description=Run IIAdmin maintenance daily

[Timer]
OnCalendar=daily
Persistent=true

[Install]
WantedBy=timers.target

systemd-analyze verify /etc/systemd/system/iiadmin-maintenance.service /etc/systemd/system/iiadmin-maintenance.timer
systemctl list-timers --all

Имена доменов, адреса, порты и пути в примерах условные. Перед выполнением замените их фактическими значениями.

Как устроена схема

cron подходит для простого расписания, systemd timer даёт зависимости, журнал и состояние запуска. cloud-init выполняет первичную настройку, но тоже должен быть идемпотентным.

Важно разделять конфигурацию, процесс, сетевой сокет и внешний запрос. Успех на одном уровне не доказывает исправность следующего.

Проверка результата

Проверка должна охватывать конфигурацию, процесс, listener и реальный запрос.

• повторный запуск безопасен
• ошибка даёт ненулевой код
• секреты не в журнале
• запуск виден в journalctl
• пропущенное расписание обработано

systemctl is-active SERVICE
systemctl status SERVICE --no-pager
journalctl -u SERVICE -n 80 --no-pager
ss -lntup

Безопасность

После получения рабочего результата уменьшите количество исключений и временных разрешений.

• используйте принцип минимально необходимых прав
• ограничивайте административный доступ доверенными IP или VPN
• выдавайте файлам конфигурации минимальные права
• закрывайте временные порты после завершения теста
• не храните секреты в публикуемых конфигурациях и журналах

Диагностика, если не заработало

Диагностика строится как последовательное исключение уровней, а не случайный набор перезапусков.

1. Подтвердите симптом точной командой и запишите время.
2. Проверьте конфигурацию штатным тестом.
3. Проверьте процесс и последние записи журнала.
4. Убедитесь, что нужный адрес и порт слушаются.
5. Сравните локальный запрос с запросом извне.
6. Только затем проверяйте firewall, DNS и маршрут.
7. Меняйте одну переменную и повторяйте тот же тест.

Для темы «Идемпотентные shell-скрипты для системного администратора» важно не путать открытый firewall с запущенным сервисом: правило доступа не создаёт listener, а активный процесс не гарантирует доступность извне.

Откат изменений

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

1. disable timer
2. остановить service
3. вернуть скрипт
4. daemon-reload
5. запустить вручную в тестовом режиме

Не удаляйте неудачную конфигурацию до выяснения причины: она полезна для diff и разбора инцидента.

Дальнейшее сопровождение

Рабочая конфигурация со временем устаревает и требует контроля.

• периодически выполняйте тестовое восстановление
• храните резервную копию вне VPS
• проверяйте журналы ошибок и их размер
• контролируйте таймеры, сертификаты и автоматические задания
• после обновления повторяйте тест конфигурации и портов

Контрольный список

Перед тем как считать тему «Идемпотентные shell-скрипты для системного администратора» закрытой, пройдите список:

Что дополнительно сверить в документации

При подготовке материала были сопоставлены разделы русскоязычной документации. Для углублённой проверки полезно изучить:

• Создать виртуальную машину с пользовательским скриптом конфигурации
• Создание виртуальной машины с пользовательским скриптом конфигурации Создание виртуальной машины с пользовательским скриптом конфигурации
• Примеры Примеры
• Была ли статья полезна?

Контрольные точки именно для этой темы

Для темы «Идемпотентные shell-скрипты для системного администратора» заранее запишите исходные значения и ожидаемый результат. Это позволяет повторить один и тот же тест до изменения, после применения и после возможного отката.

Не считайте задачу завершённой по одному зелёному статусу. Проверка должна охватывать конфигурацию, процесс, сетевой уровень, журнал и прикладной ответ.

• повторный запуск безопасен
• ошибка даёт ненулевой код
• секреты не в журнале
• запуск виден в journalctl
• пропущенное расписание обработано

#!/usr/bin/env bash
set -euo pipefail
IFS=$'\n\t'
log() { printf '%s %s\n' "$(date --iso-8601=seconds)" "$*"; }
trap 'log "ERROR line=$LINENO"' ERR

Повторяемость и контроль состояния

Автоматизация должна сначала определить текущее состояние и выполнять только недостающие действия. Повторный запуск обязан завершаться тем же результатом без дублирования.

Храните версию сценария и входные параметры, чтобы результат можно было воспроизвести на другом сервере.

Данные, которые нужно сохранить до изменения

Перед работой по теме «Идемпотентные shell-скрипты для системного администратора» сохраните состояние именно тех компонентов, которые участвуют в схеме: активную конфигурацию, статус процесса, открытые порты, последние ошибки и результат контрольного запроса. Этот набор позволит отличить последствия новой правки от ранее существовавшего поведения.

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

command -v nginx >/dev/null 2>&1 || { echo 'nginx not installed' >&2; exit 1; }

Побочные эффекты и соседние компоненты

Изменение по теме «Идемпотентные shell-скрипты для системного администратора» может затронуть соседние части схемы: права файлов, DNS, firewall, reverse proxy, сертификаты, автоматические задания или порядок запуска. До работы перечислите эти связи и выберите по одной короткой проверке для каждой критичной зависимости.

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

Результаты регрессионной проверки записывайте теми же командами, которые использовались до изменения. Это делает сравнение объективным и помогает быстро доказать, что соседний компонент не пострадал.

• основной сервис отвечает тем же способом, что и до изменения
• административный доступ и аварийная консоль остаются доступны
• временные listeners и правила не заняли рабочие порты
• журналы не показывают новые повторяющиеся ошибки

Критерий отката для текущей задачи

Для темы «Идемпотентные shell-скрипты для системного администратора» заранее определите признаки неудачи: штатная проверка не проходит, процесс не запускается, ожидаемый listener исчез, внешний клиент получает неверный ответ или в журнале растёт число ошибок. После достижения лимита времени выполняйте откат, а не продолжайте добавлять неподтверждённые изменения.

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

• disable timer
• остановить service
• вернуть скрипт
• daemon-reload

Cron, systemd timer и защита от параллельного запуска

Cron подходит для простой команды по расписанию, а systemd timer даёт зависимости, журнал, ограничения и контроль пропущенных запусков. Выбор зависит от важности задачи и требуемой наблюдаемости.

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

flock -n /run/iiadmin-job.lock /usr/local/sbin/iiadmin-job
systemctl list-timers --all
journalctl -u JOB.service -n 80 --no-pager

Источники и документация

Источники использованы для выбора терминов, контрольных вопросов и команд. Полные абзацы чужих публикаций не копируются.

• Yandex Compute Cloud | Создать виртуальную машину с пользовательским скриптом конфигурации