docs: update deployment section to use git clone + pip install -e .

Replace rsync-based deployment with git clone from git.totmin.ru.
Update Zabbix template import instructions to choose between
sender (zbx_ses_template_5.0.xml) and UserParameter
(zbx_ses_template_5.0_up.xml) variants.
This commit is contained in:
Maksim Totmin 2026-06-19 20:43:16 +07:00
parent 2907652aec
commit 9505742b96

View File

@ -101,48 +101,56 @@ Zabbix агент по запросу сервера запускает скри
### 1. Требования
- **Python 3.9+**
- **Git** — для клонирования репозитория
- **Zabbix Agent** с утилитой `zabbix_sender`
- Доступ к SES API (`http://<ses-host>:6190`)
- Доступ к Zabbix Server по порту 10051
- SSH-ключ, добавленный в Git-репозиторий (`git.totmin.ru`)
### 2. Установка пакета
```bash
# Копируем проект на сервер
rsync -avz --exclude='.git' --exclude='__pycache__' ./ root@<ses-host>:/opt/ses-monitor/
# Клонируем репозиторий на сервер
git clone git@git.totmin.ru:en2zmax/ses-monitor.git /opt/ses-monitor
# На сервере:
# Переходим в каталог проекта
cd /opt/ses-monitor
# Создаём виртуальное окружение и устанавливаем зависимости
# Создаём виртуальное окружение и устанавливаем пакет
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
# Устанавливаем zabbix_sender (если ещё не установлен)
apt update && apt install -y zabbix-sender
# Создаём каталог для логов
mkdir -p /var/log/ses-monitor
```
### 3. Настройка конфигурации
Отредактируйте `config/config.yaml`:
Скопируйте шаблон и отредактируйте:
```bash
cp config/config.yaml.example config/config.yaml
nano config/config.yaml
```
Основные поля:
```yaml
ses:
base_url: "http://10.101.60.31:6190" # URL вашего SES API
robot_id: "" # ID робота из GET /ses/robot/list
robot_id: "" # ID робота из GET /ses/robot/listall
channel: "monitoring" # Имя канала в архиве
request_timeout: 30
zabbix:
enabled: true
server: "127.0.0.1" # IP вашего Zabbix сервера
mode: "userparameter" # или "sender"
host: "my-server-name" # Имя хоста в Zabbix
server: "127.0.0.1" # IP Zabbix сервера (только sender)
port: 10051
sender_path: "/usr/bin/zabbix_sender"
metrics_file: "/var/tmp/ses_monitor/metrics.json" # (только userparameter)
```
### 4. Создание сценария
@ -153,8 +161,6 @@ zabbix:
cp config/scenarios/example_liveness.yaml config/scenarios/my_project.yaml
```
Формат сценария описан ниже.
### 5. Запуск
```bash
@ -174,7 +180,7 @@ journalctl -u ses-monitor -f
### 6. Импорт шаблона Zabbix
1. Zabbix Frontend → **Configuration → Templates → Import**
2. Выбрать файл `zabbix/zbx_ses_template.xml`
2. Выбрать файл `zabbix/zbx_ses_template_5.0.xml` (для sender) или `zabbix/zbx_ses_template_5.0_up.xml` (для UserParameter)
3. Нажать Import
4. Привязать шаблон "SES Monitor" к нужному хосту