VK Data Platform logo
Помощь
Обновлена 20 ноября 2026 г. в 08:38

Запуск инсталлятора

Установка VK Data Platform выполняется с помощью интерактивного приложения в командной строке Shellkunchik.

Перед запуском инсталлятора убедитесь, что:

  1. Выполнены предусловия.
  2. Развернут кластер Kubernetes с базовой инфраструктурой при помощи инсталлятора Base Infra.
  3. Выполнена подготовка к установке VK Data Platform.

Установка VK Data Platform

  1. Запустите инсталлятор:

    $ cd ~/vkcloud/data-platform/$ ./shellkunchik
  2. Выберите версию установки VK Data Platform — Standalone.

  3. Выберите тип операции — Первичная установка.

  4. Нажмите клавишу ENTER.

  5. Настройте условия для опции выполнения предварительной валидации. Когда опция включена, перед установкой VK Data Platform выполняется проверка конфигурации. Если условия проверки не выполнены, установка не будет запущена и возникнет ошибка. Опция включена по умолчанию.

    Настраиваемые условия валидации:

    • Проверить доступность S3 — проверка подключения к S3. Во время проверки в S3 будет создан и удален тестовый бакет. Опция включена по умолчанию.
    • Пропустить проверку сертификатов — отключение проверки наличия SSL/TLS‑сертификатов. Включите опцию, если сертификаты не установлены. Опция отключена по умолчанию.
    • Пропустить проверку свободного места на диске — отключение проверки свободного места на диске. Опция отключена по умолчанию.
  6. (Опционально) Включите опцию Режим отладки. При включении опции во время установки VK Data Platform будут отображаться полные логи выполнения команд и их результаты. Опция отключена по умолчанию.

  7. Нажмите клавишу ENTER.

  8. Проверьте путь к конфигурационному файлу кластера Kubernetes для установки VK Data Platform. По умолчанию используется путь /home/deployer/.kube/config.

    Чтобы изменить путь:

    1. Нажмите клавишу E.
    2. Укажите новое значение.
    3. Нажмите клавишу ENTER.
  9. Нажмите клавишу ENTER.

  10. Проверьте корректность параметров, которые были заданы на этапе подготовки к установке VK Data Platform.

  11. Нажмите клавишу ENTER. Запустится установка VK Data Platform.

  12. Добавьте 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"          }        ]      }    }  }}'
  13. Добавьте пространство имен openebs в доверенную зону безопасности:

    $ kubectl label namespace openebs data.vkcs.cloud/seczone=trusted --overwrite
  14. Добавьте 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

  1. Получите адрес веб-интерфейса VK Data Platform с помощью команды на деплой-ноде:

    $ kubectl get services -n paas-standalone | grep data-platform-app-kube-vip-lb | awk '{print $4}'
  2. С помощью любого браузера перейдите по адресу https://<ДОМЕН>/app/ в веб-интерфейс VK Data Platform.

    Здесь <ДОМЕН> — домен личного кабинета, заданный в переменной lk_domain на этапе подготовки к установке VK Data Platform.

  3. Перейдите в раздел Data Platform → Экземпляры сервисов.

  4. Убедитесь, что в разделе отображается один экземпляр сервиса с названием standalone в статусе Активно.

Проверка веб-интерфейса администратора CIAM

  1. С помощью любого браузера перейдите по адресу https://<ДОМЕН>/iam-admin/.

    Здесь <ДОМЕН> — домен личного кабинета, заданный в переменной lk_domain на этапе подготовки к установке VK Data Platform.

  2. В веб-интерфейсе IAM Admin нажмите кнопку Войти.

  3. Введите логин и пароль администратора.

  4. Нажмите кнопку Войти.

  5. Ознакомьтесь с информацией о предустановленных пользователях VK Data Platform и их ролях в разделе IAM Admin → Пользователи.

Проверка создания резервных копий

Убедитесь, что резервные копии создаются, — проверьте содержимое бакета для резервных копий управляющего узла в интерфейсе S3. Бакет указан в переменной s3_bucket_name на этапе подготовки к установке VK Data Platform.

Назначение квот на проект

  1. Создайте файл set-platformer-quota.sh на деплой-ноде:

  2. Сделайте скрипт исполняемым:

    $ chmod +x set-platformer-quota.sh
  3. Получите идентификатор проекта:

    1. Нажмите на имя пользователя в шапке страницы.
    2. Перейдите в раздел Настройки проекта → Terraform. Сохраните идентификатор Project ID.
  4. Задайте переменные окружения:

    $ 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 в мебибайтах.
    • <ДИСК_ГБ> — объем диска в ГБ.
    • <КОЛИЧЕСТВО_ДИСКОВ> — количество дисков, доступных для приложений.
  5. Запустите скрипт:

    $ ./set-platformer-quota.sh set

    После выполнения скрипта будут доступны как проектные, так и кластерные квоты.

  6. Проверьте квоты:

    • с помощью команды:
    $ ./set-platformer-quota.sh info
    • через веб-интерфейс VK Data Platform в разделе Data Platform → Экземпляры сервисов в верхней панели.

Ошибки в процессе установки

Если при установке VK Data Platform возникнут ошибки:

  1. Перезапустите инсталлятор с флагом --debug:

    $ ./shellkunchik --debug
  2. Повторно выполните установку VK Data Platform.

  3. Ознакомьтесь с подробными логами ошибок и исправьте их.

Переустановка

Процесс переустановки VK Data Platform полностью повторяет шаги первичной установки VK Data Platform.

Особенности переустановки:

  • Инсталлятор VK Data Platform запускает процесс установки заново.
  • Все успешно выполненные при первичной установке задачи будут автоматически пропущены. Будут выполнены только те шаги, которые не были завершены или были пропущены при первичной установке.
  • Если после первичной установки были изменены параметры окружения модулей, при переустановке будут использоваться новые значения.

Для переустановки VK Data Platform повторите процедуру установки VK Data Platform.

Была ли статья полезна?