Установка компонентов на деплой-ноде VK Private Cloud

Перед началом установки компонентов на деплой-ноде VK Private Cloud убедитесь, что:

1. Выполнены условия, приведенные в разделе Предусловия.
2. Развернут кластер Kubernetes с базовой инфраструктурой с помощью инсталлятора Base Infra. Подробнее — в разделе Развертывание кластера Kubernetes из дистрибутива Base Infra.

Чтобы установить компоненты на деплой-ноде VK Private Cloud, выполните следующие шаги:

1. Подключитесь к S3.
2. Распакуйте архив инсталлятора.
3. Задайте переменные окружения.
4. Загрузите образ ВМ.
5. Выполните первый запуск инсталлятора.

1. Подключитесь к деплой-ноде по SSH:

    
   $ ssh deployer@deploy_fip

2. Выполните настройку AWS CLI:

    
   $ aws configure

   В качестве значений ACCESS_KEY и SECRET_KEY указывайте значения из параметров S3_ACCESS_KEY и S3_SECRET_KEY. Остальные параметры опциональны и зависят от конфигурации вашего S3-совместимого хранилища.

3. Проверьте подключение к S3:

   1. Создайте бакет:

       
      $ aws s3api create-bucket --bucket <ИМЯ_БАКЕТА> --region <РЕГИОН> --create-bucket-configuration LocationConstraint=<РЕГИОН> --endpoint-url http://<S3_ЭНДПОИНТ>

      Здесь:

      • <ИМЯ_БАКЕТА> — имя создаваемого бакета.
      • <РЕГИОН> — регион S3.
      • <S3_ЭНДПОИНТ> — эндпоинт S3-совместимого хранилища.

   2. Получите содержимое созданного бакета и всей иерархии объектов:

       
      $ aws s3 ls s3://<ИМЯ_БАКЕТА> --recursive --endpoint-url http://<S3_ЭНДПОИНТ>$ aws s3 ls s3:// --recursive --endpoint-url http://<S3_ЭНДПОИНТ>

      Здесь:

      • <ИМЯ_БАКЕТА> — имя создаваемого бакета.
      • <S3_ЭНДПОИНТ> — эндпоинт S3-совместимого хранилища.

1. Проверьте целостность архивов:

    
   $ tar -tPvf ~/data-platform-26.2.tar$ tar -tPvf ~/volume-nexus-26.2.tar.gz

   Выполнение команды может занять до пяти минут.

2. Перейдите в директорию инсталлятора и распакуйте архив:

    
   $ cd /opt/vkcloud/inventory/vkcloud/$ tar -xPf ~/data-platform-26.2.tar

   Если установка происходит на продукт VK Private Cloud 4.2.0, перейдите в директорию ~/inventory/vkcloud/.

   Выполнение команды может занять до 10–15 минут. После распаковки архив можно удалить.

3. Скопируйте файл шаблона паролей:

    
   $ cp data-platform/group_vars/vkcloud/vault-data-platform.yml.tmpl data-platform/group_vars/vkcloud/vault-data-platform.yml

4. Сгенерируйте пароли для VK Data Platform:

    
   $ for (( i=1; i <= 19; i++ )); do sed -i "" -e "1,/--------------------/ s/--------------------/$(LANG=C tr -dc A-Za-z0-9 </dev/urandom | head -c 20)/" "data-platform/group_vars/vkcloud/vault-data-platform.yml"; done

1. В файле /opt/vkcloud/inventory/vkcloud/data-platform/group_vars/vkcloud/vault-data-platform.yml заполните переменные:

   • vault_nexus_s3_aws_access_key — ключ доступа к S3 с правами создания бакетов и prefixed-ключей.
   • vault_nexus_s3_aws_secret_key — секретный ключ доступа к S3.

2. В файле /opt/vkcloud/inventory/vkcloud/data-platform/group_vars/vkcloud/nexus.yml заполните переменные:

   • nexus_s3_bucket — имя бакета для резервного копирования Nexus.
   • nexus_s3_region — регион S3.
   • nexus_s3_endpoint — эндпоинт S3 с указанием протокола.

3. В файле /opt/vkcloud/inventory/vkcloud/data-platform/group_vars/vkcloud/common.yml заполните переменную lb_atom_ip — внешний IP-адрес балансировщика.

4. В файле /opt/vkcloud/inventory/vkcloud/data-platform/group_vars/vkcloud_kube/data-multiplexer.yml заполните переменные:

   • helm_data_multiplexer_domain — домен для сервиса data-multiplexer.

   • helm_data_multiplexer_openstack_service_project_id — ID проекта OpenStack.

5. Скопируйте TLS-сертификат в директорию /opt/vkcloud/inventory/vkcloud/data-platform/ssl/.

1. Скопируйте образ ВМ на управляющий узел:

    
   $ scp ~/redos.0.0.5.qcow2 '<УЗЕЛ>':/tmp/

   Здесь <УЗЕЛ> — имя или IP-адрес управляющего узла. Пример: cpn002.

2. Подключитесь к управляющему узлу:

    
   $ ssh '<УЗЕЛ>'

3. Задайте параметры OpenStack:

    
   $ export OS_AUTH_URL=<AUTH_URL>$ export OS_PROJECT_ID=<ID_ПРОЕКТА>$ export OS_USERNAME=<ИМЯ_ПОЛЬЗОВАТЕЛЯ>$ export OS_PASSWORD=<ПАРОЛЬ_ПОЛЬЗОВАТЕЛЯ>$ export OS_USER_DOMAIN_NAME=<ДОМЕН_ПОЛЬЗОВАТЕЛЯ>$ export OS_IDENTITY_API_VERSION=<ВЕРСИЯ_API>

   Здесь:

   • <AUTH_URL> — URL-адрес аутентификации OpenStack.
   • <ID_ПРОЕКТА> — идентификатор проекта. Пример: project001.
   • <ИМЯ_ПОЛЬЗОВАТЕЛЯ> — имя пользователя в проекте project001.
   • <ПАРОЛЬ_ПОЛЬЗОВАТЕЛЯ> — пароль пользователя в проекте project001.
   • <ДОМЕН_ПОЛЬЗОВАТЕЛЯ> — домен пользователя в project001.
   • <ВЕРСИЯ_API> — версия API.

4. Загрузите образ ВМ:

    
   # openstack image create "redos.0.0.5" \  --disk-format qcow2 \  --container-format bare \  --file /tmp/redos.0.0.5.qcow2 \  --min-disk 20 \  --community \  --property os_type=linux \  --property os_distro=redos \  --property os_version=8 \  --property os_admin_user=redos \  --property os_require_quiesce=yes \  --property hw_qemu_guest_agent=yes \  --property mcs_name="Data Multiplexer VM Agent" \  --property mcs_os_type=linux

5. Получите идентификатор образа ВМ:

    
   # openstack image show redos.0.0.5 -f value -c id

   Сохраните его — он потребуется в дальнейшем.

1. Подключитесь к деплой-ноде по SSH:

    
   $ ssh deployer@deploy_fip

2. Перейдите в рабочую директорию инсталлятора VK Data Platform и запустите CLI инсталляции:

    
   $ cd /opt/vkcloud/inventory/vkcloud/data-platform$ ./shellkunchik

   Если установка происходит на стендах CorpCloud, вызывайте команду с параметром:

    
   $ ./shellkunchik -e @/opt/vkcloud/devstand/override.yml

3. Выберите целевую среду Матрешка и нажмите ENTER.

4. Выберите тип операции Первичная установка и нажмите ENTER.

5. Выберите Шаг 1: Установка части компонентов в Control Plane Private Cloud и нажмите ENTER.

6. (Опционально) Включите параметр Режим отладки, чтобы получить лог установки. Опция выключена по умолчанию.

   Чтобы включить или отключить опцию, переместите курсор на нужный вариант и нажмите клавишу ПРОБЕЛ.

7. Нажмите ENTER.

8. Проверьте, что все параметры заданы корректно, и нажмите ENTER. Запустится процесс установки.

9. Дождитесь окончания установки. На экране отобразится сообщение: «Установка Data Platform завершилась успешно!».

10. Проверьте результаты установки:

    1. Подключитесь к деплой-ноде по SSH:

        
       $ ssh deployer@deploy_fip

    2. Проверьте статус сервиса Nexus на деплой-ноде:

        
       $ sudo systemctl status nexus

       Статус сервиса должен быть active (running).

    3. Подключитесь к управляющему узлу:

        
       $ ssh '<УЗЕЛ>'

       Здесь <УЗЕЛ> — имя или IP-адрес управляющего узла. Пример: cpn002.

    4. Переключитесь на пользователя root и проверьте поды solar-static-app:

        
       $ sudo -Hsu root# kubectl get pods -n mcs-front-vkcloud | grep solar-static-app

       Все поды solar-static-app должны иметь статус Running.

11. В случае появления ошибки при установке VK Data Platform:

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

       
      $ ./shellkunchik --debug

    • Повторно выполните шаги настроек из раздела Первый запуск инсталлятора.

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