01-system — обновление системы и базовая подготовка

Обновляет ОС, ставит базовый набор утилит, настраивает часовой пояс и NTP, при нехватке RAM создаёт swap-файл. 🔒 обязательный.

Зачем нужен #

Это первый модуль установки. Он приводит свежий сервер в предсказуемое состояние: обновляет индекс пакетов и сами пакеты (закрывая уже известные уязвимости), доустанавливает инструменты, без которых не отработают следующие модули (curl, gnupg, ca-certificates, openssl и т. п.), выставляет часовой пояс и включает синхронизацию времени.

Без этого модуля на «голом» образе может не быть даже curl или актуальных корневых сертификатов, и тогда скачивание ключей репозиториев (Docker, Node.js, PostgreSQL) в следующих модулях будет падать. Неверное системное время ломает проверку TLS-сертификатов и записи в логах.

Отдельная задача модуля — swap. swap (файл подкачки) — это место на диске, которое ядро использует как «медленную дополнительную память», когда заканчивается оперативная. На маленьких VPS (512 МБ — 1 ГБ RAM) сборка пакетов или запуск нескольких сервисов легко упирается в нехватку памяти, и процессы убивает OOM-killer. Swap-файл спасает от этого.

Этого модуля достаточно для базовой гигиены сервера. Прикладной софт (Docker, Node.js, БД) ставят отдельные модули.

Когда включать и когда не нужен #

• Всегда включён — обязательный модуль, запускается первым при любой установке.
• Swap создаётся только если одновременно: (1) swap ещё не настроен и (2) RAM меньше порога SWAP_RAM_THRESHOLD_MB (по умолчанию 2048 МБ). Если памяти достаточно — swap не трогается.
• В контейнерах (LXC/OpenVZ) swap намеренно пропускается: контейнер обычно не имеет права управлять подкачкой, и попытка swapon завершилась бы ошибкой.
• Обновление системы и базовые пакеты ставятся всегда, независимо от swap.

Зависимости и требования #

• Отдельных модулей не тянет — сам является базой для остальных.
• Нужен доступ в интернет к репозиториям дистрибутива (для apt update/dnf makecache и загрузки пакетов).
• Мультидистро: на Debian/Ubuntu работает через apt-get, на RHEL-семействе (Rocky/Alma/Fedora) — через dnf/yum. Часть debian-специфичных пакетов (apt-transport-https, software-properties-common, lsb-release) на других семействах автоматически пропускается или заменяется аналогами.
• Для swap нужно свободное место на диске под файл размером SWAP_SIZE_MB (по умолчанию 2 ГБ) и работающий не-контейнерный хост.

Что именно делает #

Пошагово, в порядке выполнения module_install:

1. Устанавливает DEBIAN_FRONTEND=noninteractive, чтобы пакеты не задавали интерактивных вопросов.
2. Обновляет индекс пакетов — apt-get update (или dnf makecache). Выполняется с 3 повторами при сбое сети.
3. Обновляет установленные пакеты — apt-get dist-upgrade (или dnf upgrade), с сохранением текущих конфигов (--force-confold).
4. Ставит базовые пакеты: ca-certificates, curl, gnupg, lsb-release, apt-transport-https, software-properties-common, openssl.
5. Часовой пояс и NTP — если задана переменная TIMEZONE и в системе есть timedatectl: timedatectl set-timezone <TIMEZONE> и включение синхронизации времени timedatectl set-ntp true.
6. Swap (_system_ensure_swap) — проверяет условия и при необходимости: создаёт файл SWAP_FILE через fallocate (при неудаче — через dd), выставляет права 600, форматирует mkswap, включает swapon, регистрирует откат и добавляет строку в /etc/fstab (чтобы swap подключался после перезагрузки).
7. Отмечает модуль выполненным (state_mark).

Файлы, службы и порты #

Портов и служб модуль не открывает и не создаёт.

Настройка #

SWAP_RAM_THRESHOLD_MB — именно порог принятия решения, а не размер. Пример: при RAM 1 ГБ и пороге 2048 МБ swap будет создан; при RAM 4 ГБ — нет.

Как переопределить настройки #

Три способа:

1. Экспорт перед установкой (флаг -E сохраняет переменные окружения при sudo):

   TIMEZONE=Europe/Moscow SWAP_SIZE_MB=4096 sudo -E ./install.sh
   

2. Правка config/defaults.conf — измените строки TIMEZONE, SWAP_SIZE_MB, SWAP_RAM_THRESHOLD_MB и запустите установку обычным образом.
3. Этот модуль не задаёт интерактивных вопросов по своим переменным — их берут из окружения или defaults.conf. Часовой пояс и параметры swap в мастере установки не спрашиваются.

Проверка, что всё работает #

module_verify считает модуль успешным, если в системе присутствуют команды curl и gpg.

Ручные проверки:

# Часовой пояс и синхронизация времени
timedatectl
# Ожидается строка «Time zone: <ваш TZ>» и «System clock synchronized: yes»

# Swap (если создавался)
swapon --show
free -h
# В строке Swap должен быть указан объём

# Запись в /etc/fstab
grep swap /etc/fstab

# Общая диагностика — строки Диск / RAM / Swap / Обновления
sudo mitdev doctor

В выводе mitdev doctor при настроенном swap строка «Swap» будет зелёной с указанием объёма; если swap не создавался (RAM хватает или контейнер) — будет предупреждение «Swap: не настроен», это нормально.

Типовые задачи #

• Изменить часовой пояс уже после установки:

  sudo timedatectl set-timezone Europe/Moscow
  

• Создать swap вручную, если модуль его пропустил (не контейнер):

  sudo fallocate -l 2G /swapfile && sudo chmod 600 /swapfile
  sudo mkswap /swapfile && sudo swapon /swapfile
  echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  

• Проверить, что обновления применились:

  sudo mitdev update    # или sudo apt-get update && sudo apt-get dist-upgrade
  

• Увеличить swap на большем размере: удалите старый (sudo swapoff /swapfile && sudo rm /swapfile, уберите строку из /etc/fstab) и создайте заново с нужным размером командами выше.

Частые ошибки #

Безопасность и продакшен #

Модуль уже закрывает: применение свежих обновлений безопасности при установке, корректные права 600 на swap-файл (его содержимое не читается посторонними), синхронизацию времени (нужна для валидных TLS и корректных логов аудита).

Остаётся на клиенте: регулярно повторять обновления (sudo mitdev update) — модуль обновляет систему только в момент установки; настройка автоматических обновлений безопасности выходит за рамки этого модуля.

Откат и удаление #

• Авто-откат при падении установки (module_rollback): по сути no-op. Обновления системы и установку базовых пакетов откатывать нельзя — это сломало бы работающую систему. Единственное обратимое действие — swap — регистрируется в стеке отката в момент создания, поэтому при неудаче установки swap-файл снимается и убирается из /etc/fstab автоматически.
• mitdev remove system: удаляет только то, что создал модуль, — swap-файл и его строку в /etc/fstab (swapoff + rm). Базовые пакеты, часовой пояс и системные обновления намеренно оставляются: их удаление способно сломать работающий сервер. Флаг --purge здесь ничего дополнительно не удаляет.

См. также #

• ../COMMANDS.md — команды mitdev doctor, mitdev update, mitdev remove.
• ../CONFIGURATION.md — полный список переменных.
• 02-user.md — следующий обязательный модуль (пользователь для деплоя).
• 11-utils.md — расширенный набор утилит поверх базовых пакетов.