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

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

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

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

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

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

Ролевой пакет 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 — в Клиент LSUS.

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

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

_lsus.example.com.  IN TXT  "v=lsus1;host=master.example.com;port=8443"
_lsus.example.com.  IN TXT  "v=lsus1;cidr=10.52.0.0/16;host=site-msk.example.com;port=8443;prio=10"

Порт обязан совпадать с MASTER_PORT в .env. TLS проверяется на host, не на имя _lsus.

Запасной SRV (если _tcp создавать можно):

_lsus._tcp.example.com.  3600  IN  SRV  10  5  8443  master.example.com.

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

После установки lsus-client агент при первом запуске:

1. Возьмёт домен из FQDN (или server_discovery_domain).
2. Запросит TXT _lsus.example.com, отфильтрует по своим IPv4 и cidr.
3. Если TXT нет или не подошла — запросит SRV _lsus._tcp.example.com.
4. Опросит выбранные endpoint по /api/v1/health.
5. Запишет выбранный URL и запросит /assignment.

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

python3-dnspython не обязателен (встроенный резолвер). Полная инструкция — в Требованиях.

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

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