Быстрый старт

Краткая шпаргалка: поднять сервер LSUS (роль Master, в Docker-контейнерах) и клиент (пакет на управляемый хост) за минимум шагов. Минимальный контур для проверки — один Master + один клиент.

Серверные роли разворачиваются только в Docker — пакеты ОС LSUS сами установят Docker, загрузят образы и запустят контейнеры. Клиент lsus-client ставится на хост управляемой машины напрямую из пакета.

Полные сценарии с пояснениями: Развёртывание серверов. Требования к хосту (ОС, ресурсы, firewall, DNS SRV): Требования и подготовка. Справочник портов и переменных: Справочник.

Минимальные требования¶

Порядок установки сервера (любая роль)¶

Ролевой пакет LSUS (lsus-master, lsus-site, lsus-edge) через Depends/Requires автоматически тянет пакеты Docker-образов и сам Docker, после чего запускает сервер в контейнерах. На практике достаточно поставить только ролевой пакет — пакетный менеджер установит Docker, образы и все остальное. Полная раскладка по пакетам:

Роль PXE (lsus-pxe + lsus-image-pxe + lsus-image-nginx) — отдельный exclusive-хост без PostgreSQL, ≥100 ГБ под ISO. Не входит в минимальный контур «Master + клиент». См. Установка PXE.

В командах ниже пакеты образов показаны явными шагами — для случаев, когда пакеты ставятся из локального каталога и зависимости автоматически не разрешаются. При установке из репозитория ОС с правильно настроенными Depends достаточно одного ролевого пакета.

Astra / Debian / Ubuntu (.deb)¶

cd /opt/lsus-pkgs          # каталог с пакетами
sudo apt update

# Master (замените <версия> и суффикс дистрибутива: _astra / _debian / _ubuntu)
sudo apt install ./lsus-image-postgres_<версия>_all.deb
sudo apt install ./lsus-image-pgbouncer_<версия>_all.deb
sudo apt install ./lsus-image-nginx_<версия>_all.deb
sudo apt install ./lsus-image-master_<версия>_all.deb
sudo apt install ./lsus-master_<версия>_astra.deb

Проверка (ожидаемый ответ — {"status":"ok","role":"master"}):

# порт 8443 — дефолт пакетов ОС (443 — при ручном развёртывании из .env.example)
curl -k https://master.example.com:8443/api/v1/health

РЕД ОС (.rpm)¶

cd /opt/lsus-pkgs
sudo dnf install ./lsus-image-postgres-<версия>-1.noarch.rpm
sudo dnf install ./lsus-image-pgbouncer-<версия>-1.noarch.rpm
sudo dnf install ./lsus-image-nginx-<версия>-1.noarch.rpm
sudo dnf install ./lsus-image-master-<версия>-1.noarch.rpm
sudo dnf install ./lsus-master-<версия>-1.noarch.rpm

Проверка — как для Astra.

Альт Сервер (.rpm, apt-rpm)¶

На Альт Сервере команды выполняются от root (su -, без sudo), установка — только через apt-get; Docker (docker-engine, docker-compose) подтянется из репозитория p11. Пакеты Альт-линейки имеют суффикс -alt1:

$ cd /opt/lsus-pkgs
$ su -
# apt-get update && # apt-get install ./lsus-image-postgres-<версия>-alt1.noarch.rpm \
    ./lsus-image-redis-<версия>-alt1.noarch.rpm \
    ./lsus-image-pgbouncer-<версия>-alt1.noarch.rpm \
    ./lsus-image-nginx-<версия>-alt1.noarch.rpm \
    ./lsus-image-master-<версия>-alt1.noarch.rpm \
    ./lsus-master-<версия>-alt1.noarch.rpm

Проверка (порт 8443 — дефолт Альт-пакетов; графику на сервер не ставьте, веб-интерфейс открывайте с рабочей станции):

# curl -k https://master.example.com:8443/api/v1/health

Полное руководство по установке на Альт — в Развёртывании серверов.

Порты при первой установке (опционально)¶

Если /opt/lsus-docker/.env ещё не существует, порты можно задать в той же команде:

# Master на нестандартном порту
sudo LSUS_INSTALL_MASTER_PORT=9443 apt install ./lsus-master_<версия>_astra.deb

# Edge
sudo LSUS_INSTALL_EDGE_PORT=9440 dnf install ./lsus-edge-<версия>-1.noarch.rpm

# Альт Сервер (от root, su -)
# LSUS_INSTALL_MASTER_PORT=9443 apt-get install ./lsus-master-<версия>-alt1.noarch.rpm

При обновлении пакета эти переменные не читаются — порты берутся из существующего .env. Полная таблица — в Справочнике.

Установка клиента¶

Клиент LSUS устанавливается на хост управляемой машины напрямую из пакета (без Docker) — в отличие от серверных ролей, которые работают в контейнерах. Клиент поставляется двумя пакетами: lsus-client (служба, обязательно на всех машинах) и lsus-client-gui (GUI-трей, опционально для рабочих станций).

cd /opt/lsus-pkgs

# Astra / Debian / Ubuntu
sudo apt install ./lsus-client_<версия>_all.deb
sudo apt install ./lsus-client-gui_<версия>_all.deb   # опционально, для рабочих станций

# РЕД ОС
sudo dnf install ./lsus-client-<версия>-1.noarch.rpm
sudo dnf install ./lsus-client-gui-<версия>-1.noarch.rpm   # опционально

# Альт Сервер (от root, su -)
# apt-get install ./lsus-client-<версия>-1.noarch.rpm
# apt-get install ./lsus-client-gui-<версия>-1.noarch.rpm   # опционально

Настроить подключение к серверу и запустить службу:

sudo install -d -m 0755 /etc/lsus-client
printf '%s\n' '[server]' 'server_url = https://master.example.com' \
  | sudo tee /etc/lsus-client/lsus-client-common.conf
sudo systemctl enable --now lsus-client.service

На Альт Сервере то же самое от root (su -):

# install -d -m 0755 /etc/lsus-client
# printf '%s\n' '[server]' 'server_url = https://master.example.com' \
  > /etc/lsus-client/lsus-client-common.conf
# systemctl enable --now lsus-client.service

Проверка: хост появится в админке Master, heartbeat обновляется. Подробнее о конфиге, диагностике и DNS SRV — в Клиент LSUS.

DNS SRV для автообнаружения клиентов¶

Что нужно сделать на DNS-сервере¶

Добавьте SRV-запись в зону вашего домена (например, example.com):

# порт обязан совпадать с MASTER_PORT в .env (по умолчанию 443)
_lsus._tcp.example.com.  3600  IN  SRV  10  5  443  master.example.com.

Если в инфраструктуре несколько серверов LSUS (Master + несколько Site) — добавьте SRV-записи для каждого. Клиент сам измерит отклик каждого endpoint'а (через зонд GET /api/v1/health) и выберет ближайший:

_lsus._tcp.example.com.  3600  IN  SRV  10  5  443  master.example.com.
_lsus._tcp.example.com.  3600  IN  SRV  20  5  443  site-msk.example.com.
_lsus._tcp.example.com.  3600  IN  SRV  20  5  443  site-nsk.example.com.

priority (10, 20) задаёт предпочтение (меньше — выше), weight (5) — распределение внутри одного приоритета. Это стандартный для DNS SRV механизм, тот же, что использует Active Directory для поиска контроллеров домена.

Что произойдёт на клиенте¶

После установки lsus-client и пакета python3-dnspython (см. ниже) агент при первом запуске:

1. Возьмёт домен автоматически из FQDN хоста — если машина называется ws-007.example.com, домен для поиска будет example.com. Никаких ручных настроек не требуется.
2. Запросит у DNS записи _lsus._tcp.example.com.
3. Опросит каждый возвращённый endpoint по /api/v1/health, измерит RTT.
4. Выберет сервер с минимальным RTT (если сервер ответил) или по priority+weight (если ни один не ответил).
5. Запишет выбранный server_url в /etc/lsus-client/lsus-client-common.conf и в дальнейшем использует его как назначение для heartbeat.

Приоритет источников URL на клиенте:

Если на клиенте задан server_discovery_domain явно — клиент использует его, а не домен из FQDN. Это полезно, когда FQDN машины не соответствует домену, в котором опубликована SRV-запись (например, машина в subdiv.example.com, а SRV — в example.com).

# /etc/lsus-client/lsus-client-common.conf
[server]
server_discovery_domain = example.com

Зависимость клиента¶

Для работы SRV-обнаружения на клиенте требуется пакет python3-dnspython:

Без этого пакета клиент напишет в лог «Модуль dnspython не установлен, DNS SRV недоступен» и будет использовать server_url из конфига.

Если у вас нет корпоративного DNS¶

В полностью изолированных средах без DNS-сервера SRV не настроить. Тогда:

• Либо поднимите минимальный DNS (например, dnsmasq на самом LSUS-сервере) — это окупится удобством.
• Либо задавайте server_url в /etc/lsus-client/lsus-client-common.conf на каждой машине (вручную или через Ansible/Salt/ADMX).

Полная инструкция и примеры — в Требованиях.

Что сделать сразу после пилота¶

1. Сменить пароли веб-входов и сохранить пароли БД из credentials-*.txt.
2. Настроить доверенный TLS (заменить самоподписанный сертификат) — см. Развёртывание серверов.
3. Спланировать диски под репозитории — см. Развёртывание серверов.
4. Перейти к обзору системы и обновлению.