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

1. Развертывание Cloudlink

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

Чтобы получить список команд и параметров утилиты, выполните:

manage-tool.sh --help

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

Пример команды с указанием пути к конфигурационному файлу и значения SSH-ключа:
```
./PATH/manage-tool.sh --inventory inventories/myinventory/hosts --ssh-private-key ~/.ssh/mykeys/dev --install
```
После запуска процедуры развертывания введите пароль для установки:
```
Vault password:
```

Пароль находится в репозитории Cloudlink repo в файле с расширением txt.

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

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

Перед запуском docker-контейнера нужно создать папку ~/.kube/cloudlink, так как эта директория монтируется в контейнер.

Запустите Docker-контейнер при помощи команды:
```
docker run -it --network host --pids-limit=131072 --rm \
    -v /$HOME/portal-box:/apps \
    -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
    -v ~/.kube/cloudlink:/root/.kube/cloudlink \
    deploy-manager:1.8.1 \
    -i inventories/box/hosts \
    -u $USER \
    portal_box.yml \
    --ask-vault-pass
```
Параметры команды:
- -v /$HOME/portal-box:/apps — маппинг директории в которой находится разархивированный архив. /$HOME/portal-box — путь до директории на Manager-хосте, /apps — путь до директории внутри контейнера( нельзя изменять). Разделителем является :;
- -v ~/.ssh/id_rsa:/root/.ssh/id_rsa — маппинг файла с закрытым SSH-ключом для подключения к удалённым хостам.
- -v ~/.kube/cloudlink:/root/.kube/cloudlink — маппинг файла, в котором будет размещён kubeconfig для подключения к кластеру.
- deploy-manager:1.8.1 — имя Docker-образа.
- -i inventories/box/hosts — путь к файлу inventory.
- -u $USER — пользователь для подключения к удалённому хосту.
- portal_box.yml — плейбук, расположенный в директории portal-box.
- --ask-vault-pass — команда для запроса пароля в интерактивном режиме.
После запуска Docker-контейнера введите пароль для установки:
```
Vault password:
```

Пароль находится в репозитории Cloudlink repo в файле с расширением txt.

2. Действия после установки портала

2.1. Вход в Control Panel

Перед тем как войти в административный или пользовательский портал, установите корневой сертификат. Отсутствие корневого сертификата приведет к ошибкам в работе портала.

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

Portal address -- URL портала администрирования Cloudlink (Control Panel)
Portal username -- логин учетной записи администратора
Portal password -- пароль учетной записи администратора

Информацию можно вывести повторно. Для этого выполните команду плейбука с тегом info:

docker run -it --network host --rm \
-v /$HOME/portal-box:/apps \
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
-v ~/.kube/cloudlink:/root/.kube/cloudlink \
deploy-manager:1.8.1 \
-i inventories/box/hosts \
-u $USER \
portal_box.yml \
--ask-vault-pass \
--tags info

Подробности о настройках портала администрирования (Control Panel) после развертывания — в Быстром старте

2.2. Настройка сети в Netbox

Чтобы виртуальные машины стали доступны для заказов, настройте сеть в сервисе NetBox, расположенном по адресу "https://netbox.sample.box", где sample.box — это пример доменного имени, которое нужно заменить на реальный доменный адрес.

Настройка сервиса NetBox описана:

в Быстром старте
в инструкции Создание организации с нуля

Нельзя изменять созданные на этапе установки объекты NetBox, такие как Site, Tenant, VRF. Чтобы использовать собственные объекты, их необходимо создать после установки, не изменяя уже существующие.