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

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

sudo usermod -aG docker <user>

Где:

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

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

Запуск развертывания выполняется на управляющем хосте одним из способов: через утилиту manage-tool.sh или через запуск Docker-контейнера вручную.

1. Развертывание через утилиту manage-tool.sh

Для получения подробной информации о командах утилиты введите команду:

manage-tool.sh --help

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

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

2. Развертывание через запуск Docker-контейнера

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

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

На управляющем хосте запустите Docker-контейнер при помощи команды:

docker run -it --network host --pids-limit=131072 --rm \
    -v /$HOME/portal-box:/apps \ (1)
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \ (2)
    -v ~/.kube/dcmanager:/root/.kube/dcmanager \ (3)
    deploy-manager:1.11.0 \ (4)
    -i inventories/box/hosts \ (5)
    -u $USER \ (6)
    deploy.yml \ (7)
    --ask-vault-pass (8)

1 -v /$HOME/portal-box:/apps — монтирование директории /$HOME/portal-box с распакованным архивом в директорию /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/dcmanager:/root/.kube/dcmanager — монтирование файла, в котором будет находиться конфигурационный файл kube для подключения к кластеру

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

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

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

7 deploy.yml — файл в директории portal-box

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

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

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

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

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

Portal address — URL пользовательского портала zVirt DC Manager, например: https://portal.dcmanager.sample.box

Чтобы получить URL портала администрирования, замените portal на control в URL пользовательского портала: https://control.dcmanager.sample.box
Portal username — логин учетной записи администратора, например: cloud.admin
Portal password — пароль учетной записи администратора

Сохраните учётные данные, так как они понадобятся для дальнейшей настройки ~/.kube/dcmanager. В этой директории будет созданный оркестратором конфигурационный файл.

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

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

Если перед запуском развертывания модуля zVirt DC Manager вы не добавили TLS-сертификат, то перед тем как зайти на административный или пользовательский портал — установите корневой сертификат.

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