Установка

1. Подготовка управляющего хоста

Все IP-адреса, доменные имена и учетные записи пользователей в командах ниже указаны в качестве примера. Для корректного выполнения команд необходимо заменить значения этих параметров на актуальные.

Команды выполняются на управляющем хосте.

1.1. Дополнительные компоненты

Проверьте, что GNU tar установлен при помощи команды:
```
tar -- version | grep GNU
```
В выводе должно присутствовать GNU.
Пример вывода:
```
tar (GNU tar) 1.34
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/ gpl.html>.
```
Убедитесь, что установлен Python версии 3.9 или выше и venv.

На ОС Linux venv устанавливается с отдельным пакетом python3-venv.

1.2. Загрузка образа deploy-manager и настройка окружения

Для доступа к репозиторию zVirt Metrics необходимо получить учетные данные для входа.

Из репозитория zVirt Metrics скачайте архив с расширением tar — архив с дистрибутивом.
(Опционально) Проверьте целостность архива с дистрибутивом.
Распакуйте архив с дистрибутивом.

В распакованном архиве будет находиться директория analytics с файлами, необходимыми для установки.
Перейдите в директорию analytics и загрузите образ deploy-manager в локальное хранилище Docker-образов командой:
```
docker load < deploy-manager-1.8.0.tar.gz
```
Скопируйте примеры заполненных конфигурационных файлов из каталога sample:
```
cp -R inventories/sample inventories/box
```
Создайте SSH-ключ и скопируйте его на целевой хост:
1. Создайте SSH-ключ, если он отсутствует:
  ssh-keygen
2. Скопируйте созданный SSH-ключ на целевой хост:
  ssh-copy-id [id пользователя]
  Команда с примером id пользователя:
  
  ssh-copy-id astra@10.10.10.6
  
  Если авторизация по паролю на сервере запрещена, добавьте SSH-ключ вручную в authorized_key.

Заполните файл hosts, расположенный в каталоге inventories/box/. Описание настроек находится в комментариях этого файла.

Вид файла hosts

[k3s_server]
target-metrics.sample.box ansible_host=10.10.10.1

[k3s_agent]

[k3s_lb]

[k3s_lb_vip]

[k3s:children]
k3s_server
k3s_agent
k3s_lb

[all:vars]
ansible_user=root (1)
domain_int=metrics.sample.box (2)
domain_ext=metrics.sample.box (3)
prefix_int=''
prefix_ext=''

1	`ansible_user` — пользователь с правами `sudo`, который подключается к серверу с ролью целевого хоста; дополнительный ключ
2	`domain_int` — внутреннее доменное имя; обязательный ключ
3	`domain_ext` — внешнее доменное имя (если не предполагается использование внешнего доменного имени, должно быть указано то же значение, что и в параметре domain_int); обязательный ключ

В файле config.yml, расположенном в каталоге inventories/box/group_vars/k3s/, оставьте настройки по умолчанию.

2. Запуск развертывания

Для запуска процедуры развертывания введите команду утилиты manage-tool.sh в директории analytics:
```
./manage-tool.sh --install
```
После запуска процедуры развертывания введите пароль для установки:
```
Vault password:
```
Пароль находится в репозитории zVirt Metrics в файле с расширением txt.

По окончании установки модуля zVirt Metrics в терминале будет выведена информация о подключении к Vault, k3s и порталу администрирования Metrics. Сохраните учетные данные.

Возможные проблемы при установке модуля zVirt Metrics и способы их решения — в разделе Поиск и исправление ошибок установки.

Перед тем как зайти на портал администрирования подключений Metrics — установите корневой сертификат.

Отсутствие корневого сертификата приведет к ошибкам в работе портала.