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

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

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

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

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

    
   $ ssh <ЛОГИН>@<IP_ДЕПЛОЙ_НОДЫ>

   Здесь:

   • <ЛОГИН> — логин пользователя Linux на деплой-ноде. Пример: deployer.
   • <IP_ДЕПЛОЙ_НОДЫ> — внешний IP-адрес деплой-ноды. Пример: 100.70.18.42.

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.1.tar$ tar -tPvf ~/volume-nexus-26.2.1.tar.gz

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

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

    
   $ cd /opt/vkcloud/inventory/vkcloud/$ tar -xPf ~/data-platform-26.2.1.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 — идентификатор проекта OpenStack.

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

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

    
   $ scp ~/redos.0.0.7.qcow2 '<УЗЕЛ>':/tmp/$ scp ~/redos.0.0.1.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=users$ export OS_IDENTITY_API_VERSION=3

   Здесь:

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

4. Загрузите образ мультиплексора ВМ (MVM):

    
   # openstack image create "redos.0.0.7" \  --disk-format qcow2 \  --container-format bare \  --file /tmp/redos.0.0.7.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. Загрузите образ ВМ Route Reflector:

    
   # openstack image create "redos.0.0.1" \  --disk-format qcow2 \  --container-format bare \  --file /tmp/redos.0.0.1.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 RouteReflector VM Agent" \  --property mcs_os_type=linux

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

    
   # openstack image show redos.0.0.7 -f value -c id# openstack image show redos.0.0.1 -f value -c id

   Сохраните идентификаторы образов MVM и Route Reflector — они пригодятся на следующих шагах.

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

    
   $ ssh <ЛОГИН>@<IP_ДЕПЛОЙ_НОДЫ>

   Здесь:

   • <ЛОГИН> — логин пользователя Linux на деплой-ноде. Пример: deployer.
   • <IP_ДЕПЛОЙ_НОДЫ> — внешний IP-адрес деплой-ноды. Пример: 100.70.18.42.

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 <ЛОГИН>@<IP_ДЕПЛОЙ_НОДЫ>

       Здесь:

       • <ЛОГИН> — логин пользователя Linux на деплой-ноде. Пример: deployer.
       • <IP_ДЕПЛОЙ_НОДЫ> — внешний IP-адрес деплой-ноды. Пример: 100.70.18.42.

    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 возникла ошибка:

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

        
       $ ./shellkunchik --debug

    2. Повторно выполните шаги настроек, описанные в этом разделе.

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