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

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

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

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.

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

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

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

В распакованном архиве будет находиться директория analytics с файлами, необходимыми для установки.
Перейдите в директорию analytics и загрузите образ deploy-manager в локальное хранилище Docker-образов командой:
```
docker load < deploy-manager-1.8.0.tar.gz
```
(Опционально) Проверьте образ на доступность:
```
docker images
```
Пример ответа, если образ доступен:
```
REPOSITORY       TAG       IMAGE ID       CREATED       SIZE
deploy-manager   1.8.0     243f5d6cb054   2 weeks ago   1.01GB
```

Скопируйте примеры заполненных конфигурационных файлов из каталога sample:

cp -R inventories/sample inventories/box

Каталог sample копируется, чтобы восстановить исходные данные или свериться с примерами заполнения при необходимости.

Имя каталога, в который копируются примеры, произвольное: каталог box можно изменить на другой.

Создайте SSH-ключ и скопируйте его на целевой хост:

Создайте SSH-ключ, если он отсутствует:
```
ssh-keygen
```

Скопируйте созданный SSH-ключ на целевой хост. Пользователь для подключения может отличаться от root, указанного в команде:

ssh-copy-id [id пользователя]

Команда с примером id пользователя:

ssh-copy-id astra@10.10.10.6

Если авторизация по паролю на сервере запрещена, добавьте SSH-ключ вручную в authorized_key:

Выведите содержимое публичного SSH-ключа:
```
cat ~/.ssh/id_rsa.pub
```
Подключитесь на целевой хост с помощью доступных вам вариантов: ssh, vnc, novnc и так далее.
Добавьте содержимое публичного SSH-ключа из первого шага в файл authorized_keys:
```
echo 'ssh-rsa AAAAB3NzaC1yc ... ' >> ~/.ssh/authorized_keys
```

Заполните файл 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.1. Настройки файла config.yml

Вы можете заполнить настройки в файле config.yml вручную или через пользовательский интерфейс.

Чтобы изменить настройки вручную, в каталоге inventories/box/group_vars/k3s/ откройте файл config.yml. Раскомментируйте строки и подставьте нужные значения.

При раскомментировании строк необходимо сохранять изначальные отступы. Несоблюдение отступов нарушает структуру файла, что может приводить к ошибкам установки.

Чтобы заполнить поля config.yml через пользовательский интерфейс:

Откройте главное меню с помощью команды:
```
manage-tool.sh --ui
```
В окне Main menu выберите строку с нужными настройками.
Заполните поля с параметрами и нажмите ОК.

При заполнении полей кавычки удалять не нужно — они необходимы для корректной работы.

Таблица 1. Описание параметров config.yml
Параметр	Значение по умолчанию	Описание
ntp_host ntp_port	[ ] 123	IP-адрес и порт NTP-сервера. В config.yml можно указать несколько NTP-серверов списком: `ntp_host: - 1.1.1.1 - 2.2.2.2 - 3.3.3.3`
http_proxy		Если на целевом хосте нет доступа к репозиториям операционной системы, вы можете добавить прокси для доступа к интернету, репозиториям. Например: http://proxy01.example.com:3138
dns_servers	etc/resolv.conf	Вы можете указать DNS-сервер на целевом хосте

3. Проверка целостности дистрибутива

Для проверки целостности дистрибутива:

После загрузки дистрибутива запустите утилиту md5sum с указанием имени дистрибутива:
```
md5sum <имя_дистрибутива>.tar
```
Пример:
```
md5sum metrics-1.0-20250827T192016.tar
```
После выполнения проверки будет выдано сообщение с контрольной суммой.
Пример:
```
f458058f29e5f6cbcc0618acb71a88d6  metrics-1.0-20250827T192016.tar
```
Сравните значение из файла с расширением md5 с полученным в результате проверки значением.

Проверка считается успешной в случае полного совпадения значений.