# Руководство по утилите KDT
**Дата обновления:** 14.07.2026
**KDT (Kaspersky Deployment Tool)** - это основной инструмент командной строки для установки, обновления, настройки и обслуживания компонентов Kaspersky XDR Expert в кластере Kubernetes.
---
### 1. Основы и глобальное поведение
Прежде чем запускать команды, важно понимать, как работает KDT. Глобальные флаги указываются **перед** основной командой:
```bash
./kdt [ГЛОБАЛЬНЫЕ_ФЛАГИ] <команда> [ФЛАГИ_КОМАНДЫ]
```
**Полезные глобальные флаги:**
- `-v` (`--version`): Показать версию и завершить работу.
- `-p` (`--keep-log`): Сохранить временные файлы логов (полезно для отладки).
- `--no-progress`: Скрыть индикатор прогресса (удобно для CI/CD пайплайнов).
**Важные особенности:**
1. **Предварительные проверки**: Перед выполнением большинства команд KDT проверяет аппаратное обеспечение, ОС, сеть и наличие установленного Bootstrap.
2. **Коды возврата**:
- `0` — успех.
- `1` — общая ошибка или провал валидации.
- `2` — прерывание по сигналу SIGINT (Ctrl+C). *Обратите внимание: в KDT используется код `2`, а не стандартный `130`*.
- `12` — ошибка драйвера выполнения контейнеров.
---
### 2. Сценарий первоначального развертывания
Рекомендуемый путь установки состоит из двух этапов: генерация конфигурации и ее применение.
#### Шаг 1: Интерактивный мастер (`wizard`)
Вместо ручного написания YAML-файла используйте встроенный мастер. Он задаст все необходимые вопросы: от топологии узлов (primary/worker) и SSH-ключей до строки подключения к PostgreSQL и требований к паролю администратора.
```bash
./kdt wizard -k xdr-2.1.tar -o deployment.yaml
```
*Требования к паролю администратора XDR:* 10–256 символов, минимум 3 категории (верхний/нижний регистр, цифры, спецсимволы), без пробелов и комбинации `.@`.
#### Шаг 2: Применение конфигурации (`apply`)
После генерации файла запустите развертывание. Флаг `--accept-eula` позволяет выполнить установку в полностью автоматическом (неинтерактивном) режиме.
```bash
./kdt apply -k xdr-2.1.tar -i deployment.yaml --accept-eula
```
---
### 3. Повседневное администрирование
После успешной установки вам потребуются команды для управления состоянием системы.
#### Проверка состояния и логи
- **Список компонентов**: `./kdt state --list` (или короткий алиас `./kdt s --list`). Добавьте `--with-deps`, чтобы увидеть зависимости.
- **Детальный лог компонента**: `./kdt state --log backup-operator`
- **Получение логов контейнеров**:```bash
./kdt logs get --app kuma --last 24h --destination ./kuma_logs.txt
# или короткий алиас: ./kdt l --app kuma --last 24h
```
#### Выполнение действий над компонентами (`invoke`)
Команда `invoke` позволяет вызывать специфичные для компонентов действия (например, изменение размера дисков, настройка бэкапов, смена IP).
**Примеры:**
```bash
# Настроить NFS-хранилище для бэкапов
./kdt invoke backup-operator -a setBackupStore --param backup_target_url="nfs://storage.local:/backups"
# Создать ручной бэкап с хранением 5 копий
./kdt invoke backup-operator -a createBackup --param backup_retain=5
# Изменить ingress-IP шлюза
./kdt invoke gateway -a changeIngressIP --param ingress_ip="192.168.1.100"
# Увеличить диск KUMA Core
./kdt invoke kuma -a setCorePvcSize --param core_disk_request="500Gi"
```
*Чтобы узнать, какие действия доступны для компонента, используйте:* `./kdt describe <имя_компонента>` (алиас `./kdt d`).
#### Резервное копирование и восстановление состояния (`state`)
KDT позволяет делать снапшоты внутренней базы данных состояний:
```bash
# Создание бэкапа состояния
./kdt state --backup state_backup.tar
# Восстановление состояния (с опциональной очисткой старых данных)
./kdt state --restore --from-backup state_backup.tar --wipe
# Ротация ключа шифрования statedb
./kdt state --rotate-secret
```
---
### 4. Работа в изолированных контурах (Air-Gap)
Для сред без доступа к интернету используется отдельная утилита `kdt-airgap-preparation`. Процесс состоит из трех четких этапов:
1. **Сканирование (`scan`)**: Выполняется на целевом изолированном узле. Создает файл инвентаризации с перечнем недостающих пакетов.```bash
kdt-airgap-preparation scan -k ~/.ssh/id_rsa -c config.yaml --airgap -i nodes-airgap.yaml
```
2. **Загрузка (`pull`)**: Файл `nodes-airgap.yaml` переносится на машину **с интернетом**. Утилита скачивает все зависимости и упаковывает их в TAR-архив.```bash
kdt-airgap-preparation pull -n nodes-airgap.yaml -a airgap-packages.tar
```
3. **Установка (`install`)**: Архив переносится обратно в изолированный контур и развертывается на целевых узлах через SSH.```bash
kdt-airgap-preparation install -a airgap-packages.tar -k ~/.ssh/id_rsa
```
После этого можно запускать стандартный `./kdt apply`.
---
### 5. Продвинутые возможности и отладка
#### Управление контекстами (`ctx`)
Если вы обслуживаете несколько кластеров XDR, KDT позволяет переключаться между ними, подобно `kubectl config use-context`:
Для глубокой диагностики проблем производительности можно запросить трассировки:
```bash
./kdt traces find --output traces.json --service-name kuma --min-duration 100ms --num-traces 10
```
#### Экспорт текущей конфигурации
Отличный способ задокументировать текущее состояние кластера или подготовить базу для миграции:
```bash
./kdt export-config --filename current_config.yaml
# или короткий алиас:
./kdt ec -e current_config.yaml
```
---
### 6. Полезные переменные окружения
Поведение KDT можно гибко настраивать без изменения командной строки:
| **Переменная** | **Значение по умолчанию** | **Описание** |
| KDT\_YES | (не задана) | Установите `1` для автоматического подтверждения всех запросов (идеально для Ansible/CI/CD). |
| KDT\_HOME | ~/.kdt | Позволяет изменить домашнюю директорию утилиты. |
| KDT\_PARALLELS\_LIMIT | `-1` (авто) | Ограничение на количество параллельных операций. |
---