Процесс установки Sage
Все команды этого раздела выполняются в контейнере установщика на контрольном хосте.
Инициализация переменных
1. Переход в директорию с командами
cd /workspace/ansible
2. Подключение команд
source setup.sh
3. Выбор клана
clan clans/example/prod/1vm
Примечание: Для конфигурации 3VM используйте
clan clans/example/prod/3vm
4. Указание режима работы
export SAGE_DEPLOY_MODE=install
Предварительная проверка конфигурации
На данном этапе проверяются:
- Обязательные переменные
- Хосты
- Лицензия
check
Особенности проверки:
- Проверки запускаются локально
- Подключение к целевым хостам не требуется
Подробная информация о проверках доступна в разделе Precheck - проверка конфигурации.
Предварительная настройка серверов
На данном этапе выполняются:
- Генерация сертификатов
- Настройка Docker и Registry
- Подготовка необходимых образов
preinstall
Установка инфраструктурных приложений
На данном этапе устанавливаются и настраиваются инфраструктурные компоненты:
| Компонент | Назначение |
|---|---|
| Vector | Сбор и агрегация логов |
| Nginx | Балансировка нагрузки |
| Kafka | Шина данных |
| OpenSearch | Хранилище логов |
| VictoriaMetrics | Хранилище метрик |
| PostgreSQL | Основная база данных |
| Redis | Кэширование |
| Keycloak | Система аутентификации |
| ClickHouse | Хранилище трейсов |
| Node-exporter | Экспорт метрик узлов |
| Telegraf | Сбор метрик |
| Grafana | Визуализация данных |
infra
Установка приложений
На данном этапе выполняются:
- Генерация JWK для Manul
- Генерация JWT для Luna, Mage и Sauron
- Регистрация Realm в Keycloak
- Установка и настройка приложений Sage
- Применение миграций
apps
Конфигурирование приложений
На данном этапе выполняются:
- Регистрация групп и пользователей в Keycloak
- Регистрация групп в Manul
- Регистрация таргетов в Frost
- Регистрация триггеров в Sauron
configure
Проверка правильности установки всех приложений
Выполняется проверка работоспособности всех установленных приложений:
| Проверка | Описание |
|---|---|
| Публичный API Manul | sauron/docs/index.html (может быть отключён) |
| Публичный API Pager | pager/docs/index.html (может быть отключён) |
| Авторизация в Sage | Проверка SSO-аутентификации |
| Связка Kafka → Furry → OpenSearch | Проверка потока логов |
| Поиск по логам | Проверка поиска в OpenSearch |
| Поиск по метрикам | Проверка поиска в VictoriaMetrics |
| Алертинг | Проверка системы оповещений |
| Авторизация в Grafana | Проверка SSO в Grafana |
| Группы в Sage и Grafana | Проверка эквивалентности групп |
| Источник данных в Grafana | Проверка подключения к Sage |
| Раздел документации | Проверка доступности документации |
validate
После успешного завершения команды validate вы получите хост, на котором доступен веб-интерфейс Sage.
Дальнейшие шаги
Перейдите к разделу Первый запуск Sage для входа в систему.
Альтернативные сценарии
Если установка не удалась или требуется переустановка:
- Полное удаление Sage — процедура полного удаления Sage для последующей чистой установки