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

В файле hosts в параметре ansible_user может быть указан не root — то есть установка выполняется не от пользователя root. В таком случае перед запуском развертывания добавьте обычного пользователя в группу Docker. Для этого выполните команду:

sudo usermod -aG docker <user>

Где:

docker — группа Docker
<user> — имя пользователя

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

1. Основной вариант запуска развертывания

Для запуска процедуры развертывания приложения с параметрами, установленными по умолчанию, введите команду утилиты manage-tool.sh в директории analytics:
```
./manage-tool.sh --install
```
Для получения подробной информации о командах утилиты введите команду:

./manage-tool.sh -h
Для запуска процедуры развертывания приложения с определенными пользователем параметрами укажите значения этих параметров в команде:
```
./manage-tool.sh --install --inventory <имя папки inventory> --ssh-key <имя ключа>
```
По умолчанию используются имя папки inventory — box и ключ пользователя id_rsa, от которого будет осуществляться подключение к целевому хосту.
- Если имя папки inventory отличается от box, например stand1:
  ./manage-tool.sh --install --inventory /root/analytics/inventories/stand1
- Если используется ключ пользователя id_ed25519, а не id_rsa:
  ./manage-tool.sh --install --ssh-private-key ~/.ssh/id_ed25519
- Если отличаются и имя папки inventory и тип ключа пользователя — например stand1 и id_ed25519:
  ./manage-tool.sh --install --inventory /root/analytics/inventories/stand1 --ssh-private-key ~/.ssh/id_ed25519
После запуска процедуры развертывания введите пароль для установки:

Пароль находится в репозитории в файле password-playbook.txt.
```
Vault password:
```
При вводе пароля его символы не отображаются на экране.

2. Альтернативный вариант запуска развертывания

Docker-контейнер добавляется при загрузке образа deploy-manager.

Перед запуском Docker-контейнера необходимо создать папку ~/.kube/analytics, так как эта директория монтируется в контейнер.

Запустите Docker-контейнер при помощи команды:

docker run -it --network host --rm \
    -v /home/$USER/analytics:/apps \ (1)
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \ (2)
    -v ~/.kube/analytics:/root/.kube/analytics \ (3)
    deploy-manager:1.8.1 \ (4)
    -i inventories/box/hosts \ (5)
    -u $USER \ (6)
    analytics.yml \ (7)
    --ask-vault-pass (8)

1 -v /home/$USER/analytics:/apps — монтирование директории /home/$USER/analytics с распакованным архивом в директорию /apps Docker-контейнера

-v ~/.ssh/id_rsa:/root/.ssh/id_rsa — монтирование файла с закрытым SSH-ключом в Docker-контейнер

Для РЕД ОС 8 вместо ключа id_rsa используется id_ed25519. Строка будет иметь вид:

-v ~/.ssh/id_rsa:/root/.ssh/id_ed25519

3 -v ~/.kube/analytics:/root/.kube/analytics — монтирование файла, в котором будет находиться конфигурационный файл kube для подключения к кластеру

4 deploy-manager:1.8.1 — имя Docker-образа

5 -i inventories/box/hosts — путь до файла hosts

6 -u $USER — пользователь, под учетной записью которого будет осуществляться подключение на удаленный хост

7 analytics.yml — файл в директории портала администрирования Metrics

8 --ask-vault-pass — команда для запроса пароля в интерактивном режиме

После запуска Docker-контейнера введите пароль для установки:

Пароль находится в репозитории в файле password-playbook.txt.
```
Vault password:
```
При вводе пароля его символы не отображаются на экране.

3. Завершение развертывания

Установка модуля в среднем занимает 30–45 минут.

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

Portal address — URL портала администрирования Metrics
Portal username — логин учетной записи администратора
Portal password — пароль учетной записи администратора

При необходимости вывести информацию повторно, введите команду:

./manage-tool.sh --print-info

Перед тем как зайти на административный или пользовательский портал — установите корневой сертификат.

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