Запуск инсталлятора
Установка VK Data Platform выполняется с помощью интерактивного приложения в командной строке Shellkunchik.
Перед запуском инсталлятора убедитесь, что:
- Выполнены предусловия.
- Развернут кластер Kubernetes с базовой инфраструктурой при помощи инсталлятора Base Infra.
- Выполнена подготовка к установке VK Data Platform.
-
Запустите инсталлятор:
$ cd ~/vkcloud/data-platform/$ ./shellkunchik -
Выберите версию установки VK Data Platform —
Standalone. -
Выберите тип операции —
Первичная установка. -
Нажмите клавишу ENTER.
-
Настройте условия для опции выполнения предварительной валидации. Когда опция включена, перед установкой VK Data Platform выполняется проверка конфигурации. Если условия проверки не выполнены, установка не будет запущена и возникнет ошибка. Опция включена по умолчанию.
Настраиваемые условия валидации:
- Проверить доступность S3 — проверка подключения к S3. Во время проверки в S3 будет создан и удален тестовый бакет. Опция включена по умолчанию.
- Пропустить проверку сертификатов — отключение проверки наличия SSL/TLS‑сертификатов. Включите опцию, если сертификаты не установлены. Опция отключена по умолчанию.
- Пропустить проверку свободного места на диске — отключение проверки свободного места на диске. Опция отключена по умолчанию.
-
(Опционально) Включите опцию Режим отладки. При включении опции во время установки VK Data Platform будут отображаться полные логи выполнения команд и их результаты. Опция отключена по умолчанию.
-
Нажмите клавишу ENTER.
-
Проверьте путь к конфигурационному файлу кластера Kubernetes для установки VK Data Platform. По умолчанию используется путь
/home/deployer/.kube/config.Чтобы изменить путь:
- Нажмите клавишу
E. - Укажите новое значение.
- Нажмите клавишу ENTER.
- Нажмите клавишу
-
Нажмите клавишу ENTER.
-
Проверьте корректность параметров, которые были заданы на этапе подготовки к установке VK Data Platform.
-
Нажмите клавишу ENTER. Запустится установка VK Data Platform.
-
Добавьте
tolerationдляlvm-localpv-node:$ kubectl patch daemonset lvm-localpv-node \-n openebs \--type=merge \-p '{"spec": {"template": {"spec": {"tolerations": [{"key": "data.vkcs.cloud/nodegroup","operator": "Exists","effect": "NoSchedule"}]}}}}' -
Добавьте пространство имен
openebsв доверенную зону безопасности:$ kubectl label namespace openebs data.vkcs.cloud/seczone=trusted --overwrite -
Добавьте
tolerationдляcoredns:$ kubectl -n kube-system patch deployment coredns \--type=strategic \--patch '{"spec": {"template": {"spec": {"tolerations": [{"key": "data.vkcs.cloud/nodegroup","operator": "Equal","value": "standalone","effect": "NoSchedule"}]}}}}'$ kubectl -n kube-system rollout status deployment/coredns$ kubectl -n kube-system get deployment coredns -o jsonpath='{.spec.template.spec.tolerations}'
-
Получите адрес веб-интерфейса VK Data Platform с помощью команды на деплой-ноде:
$ kubectl get services -n paas-standalone | grep data-platform-app-kube-vip-lb | awk '{print $4}' -
С помощью любого браузера перейдите по адресу
https://<ДОМЕН>/app/в веб-интерфейс VK Data Platform.Здесь
<ДОМЕН>— домен личного кабинета, заданный в переменнойlk_domainна этапе подготовки к установке VK Data Platform. -
Перейдите в раздел Data Platform → Экземпляры сервисов.
-
Убедитесь, что в разделе отображается один экземпляр сервиса с названием standalone в статусе Активно.
-
С помощью любого браузера перейдите по адресу
https://<ДОМЕН>/iam-admin/.Здесь
<ДОМЕН>— домен личного кабинета, заданный в переменнойlk_domainна этапе подготовки к установке VK Data Platform. -
В веб-интерфейсе IAM Admin нажмите кнопку Войти.
-
Введите логин и пароль администратора.
-
Нажмите кнопку Войти.
-
Ознакомьтесь с информацией о предустановленных пользователях VK Data Platform и их ролях в разделе IAM Admin → Пользователи.
Убедитесь, что резервные копии создаются, — проверьте содержимое бакета для резервных копий управляющего узла в интерфейсе S3. Бакет указан в переменной s3_bucket_name на этапе подготовки к установке VK Data Platform.
-
Создайте файл
set-platformer-quota.shна деплой-ноде: -
Сделайте скрипт исполняемым:
$ chmod +x set-platformer-quota.sh -
Получите идентификатор проекта:
- Нажмите на имя пользователя в шапке страницы.
- Перейдите в раздел Настройки проекта → Terraform. Сохраните идентификатор
Project ID.
-
Задайте переменные окружения:
$ PROJECT_ID=<ID_ПРОЕКТА> CLUSTER_ID=00000000-0000-0000-0000-000000000000 CPU_CORES=<CPU> RAM_MB=<RAM_МИБ> DISK_GB=<ДИСК_ГБ> VOL_COUNT=<КОЛИЧЕСТВО_ДИСКОВ>Здесь:
<ID_ПРОЕКТА>— идентификатор проекта, полученный на предыдущем шаге, в hex-формате.<CPU>— количество CPU (может быть дробным).<RAM_МИБ>— количество RAM в мебибайтах.<ДИСК_ГБ>— объем диска в ГБ.<КОЛИЧЕСТВО_ДИСКОВ>— количество дисков, доступных для приложений.
-
Запустите скрипт:
$ ./set-platformer-quota.sh setПосле выполнения скрипта будут доступны как проектные, так и кластерные квоты.
-
Проверьте квоты:
- с помощью команды:
$ ./set-platformer-quota.sh info- через веб-интерфейс VK Data Platform в разделе Data Platform → Экземпляры сервисов в верхней панели.
Если при установке VK Data Platform возникнут ошибки:
-
Перезапустите инсталлятор с флагом
--debug:$ ./shellkunchik --debug -
Повторно выполните установку VK Data Platform.
-
Ознакомьтесь с подробными логами ошибок и исправьте их.
Процесс переустановки VK Data Platform полностью повторяет шаги первичной установки VK Data Platform.
Особенности переустановки:
- Инсталлятор VK Data Platform запускает процесс установки заново.
- Все успешно выполненные при первичной установке задачи будут автоматически пропущены. Будут выполнены только те шаги, которые не были завершены или были пропущены при первичной установке.
- Если после первичной установки были изменены параметры окружения модулей, при переустановке будут использоваться новые значения.
Для переустановки VK Data Platform повторите процедуру установки VK Data Platform.