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

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

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

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

manage-tool.sh --help

Для запуска развертывания дистрибутива Cloudlink с параметрами по умолчанию, в директории cloudlink введите команду утилиты 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/cloudlink/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/cloudlink/inventories/stand1 --ssh-private-key ~/.ssh/id_ed25519
После запуска процедуры развертывания введите пароль для установки:

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

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.9.1 \
    -i inventories/box/hosts \
    -u $USER \
    deploy.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.9.1 — имя Docker-образа.
- -i inventories/box/hosts — путь к файлу inventory.
- -u $USER — пользователь для подключения к удалённому хосту.
- deploy.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). Например, https://portal.cloudlink.sample.box.

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

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

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

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

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

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

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

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

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