Первичная настройка VPS с помощью cloud-init

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

Материал посвящён теме «Первичная настройка VPS с помощью cloud-init» с акцентом на первичной установке и минимальной рабочей конфигурации.

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

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

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

После выполнения руководства по теме «Первичная настройка VPS с помощью cloud-init» результат должен быть измеримым:

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

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

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

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

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

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

• Зафиксируйте текущие порты, процессы и состояние службы.
• Используйте встроенную проверку синтаксиса конфигурации.
• Откройте вторую административную сессию и не закрывайте текущую.
• Проверьте свободное место, 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Типичные ошибки

Чаще всего восстановление усложняют следующие действия:

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

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

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

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

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

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

Перед тем как считать тему «Первичная настройка VPS с помощью cloud-init» закрытой, пройдите список:

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

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

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

Расписание и проверка пропущенных запусков

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

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

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

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

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

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

Ошибки, блокировки и журнал запуска

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

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

Секреты и полезный журнал автоматизации

Лог должен показывать время, этап и результат, но не содержать токены, закрытые ключи и пароли. Не передавайте секрет через аргумент командной строки, если его можно увидеть в списке процессов.

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

sudo chown root:service-group /etc/service.env
sudo chmod 640 /etc/service.env
stat /etc/service.env

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

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

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