Администрирование (Linux) > Расширенная установка > Развертывание системы в Kubernetes > Порядок установки

1.Добавьте компоненты системы Directum RX и создайте конфигурационный файл config.yml.

3.Настройте параметры в конфигурационном файле config.yml для работы системы в Kubernetes.

4.Запустите сервисы системы с помощью чартов (Helm Charts) и опубликуйте стандартную прикладную разработку Directum RX.

5.Установите решения и веб-справку, если планируется их использовать.

Добавление компонентов и создание конфигурационного файла

Для добавления компонентов и генерации конфигурационного файла config.yml используется инструмент Directum Launcher. Развертывать систему на этом этапе не нужно. Инструмент используется только для заполнения настроек и создания конфигурационного файла.

На узле администрирования:

1.В службе поддержки Directum RX запросите доступ к репозиторию с docker-образами.

2.Архив с Directum Launcher распакуйте в локальную папку на сервере.

3.В корень папки скопируйте архивы компонентов в зависимости от используемой ОС:

•Platform.zip или Platform.tar.gz – веб-сервер и сервисы Directum RX;

•DirectumRX.zip или DirectumRX.tar.gz – набор стандартных шаблонов документов, утилита RxCmd и стандартная прикладная разработка Directum RX.

4.Запустите Directum Launcher.

5.На странице Развертывание убедитесь, что выбран режим Установка, и заполните настройки веб-сервера.

При заполнении полей укажите:

Протокол. Оставьте в поле значение http. При необходимости протокол можно изменить на этапе конфигурирования настроек.

Сервер БД:

•в полях Пользователь и Пароль укажите данные пользователя сервера БД. Если пользователь еще не создан, это можно сделать позже, на этапе создания базы данных;

•оставьте пустыми поля Администратор и Пароль.

Прикладная разработка Directum RX. Проверьте, что флажок установлен.

Тип хранилища. для хранения содержимого версий документов (бинарных данных). Выберите значение из выпадающего списка:

•File – файловое хранилище;

•S3 – объектное хранилище. Если выбрано это значение, то заполните поля Адрес хранилища, Ключ доступа и Секретный ключ доступа данными, которые получили от провайдера.

6.Нажмите на кнопку Сохранить. Устанавливать систему не нужно.

В результате сгенерируется конфигурационный файл config.yml. Путь до файла: <Папка с Directum Launcher>/etc/config.yml.

Создание базы данных

1.Задайте переменные окружения для пользователя, от имени которого будет создана база данных:

export CONNECTION_STRING_ADMIN_USERNAME=<Имя пользователя сервера БД>
export CONNECTION_STRING_ADMIN_PASSWORD=<Пароль>

set CONNECTION_STRING_ADMIN_USERNAME=<Имя пользователя сервера БД>
set CONNECTION_STRING_ADMIN_PASSWORD=<Пароль>

Где:

CONNECTION_STRING_ADMIN_USERNAME – имя пользователя сервера БД с правами администратора. Права администратора есть у пользователей, которые на сервере БД включены в роль sysadmin (для Microsoft SQL) или в роль с атрибутом superuser (для СУБД на основе PostgreSQL). Для повышения информационной безопасности не рекомендуется указывать стандартного пользователя: sa – для Microsoft SQL, postgres – для СУБД на основе PostgreSQL;

CONNECTION_STRING_ADMIN_PASSWORD – пароль пользователя сервера БД, указанного в переменной CONNECTION_STRING_ADMIN_USERNAME.

Переменные окружения хранятся только в текущей сессии командной строки, поэтому данные защищены от компрометации.

2.Перейдите в папку с Directum Launcher и выполните команду для создания базы данных:

./do.sh db up

do db up

Настройка config.yml

1.Перейдите в папку с Directum Launcher и выполните команду для подготовки конфигурационного файла:

./do.sh platform prepare-k8s-config

do platform prepare-k8s-config

В результате выполнения:

•создается резервная копия конфигурационного файла;

•в config.yml добавляются секции для сервисов и их параметры;

•генерируется сертификат для проверки токена доступа к сервисам (Sungero data protection) и приводится к кодировке Base64.

2.Откройте на редактирование подготовленный конфигурационный файл config.yml. Путь до файла: <Папка с Directum Launcher>/etc/config.yml.

3.В секции global заполните параметры секции platform:

•registry – адрес репозитория, полученный от службы поддержки;

•services_port – порт для подключения к сервисам. Значение менять не рекомендуется;

•namespaсe – имя пространства имен в кластере Kubernetes;

•create_namespace – признак того, что нужно создать новое пространство имен.

Пример настройки:

global:
    platform:
        registry: 'registry.example.ru/rxrepo'
        services_port: 15672
        namespace: default
        create_namespace: false

При необходимости, например во время параллельной работы с разными проектами, вы можете использовать пространство имен, отличное от указанного в параметре namespaсe. Для этого при вызове команд для настройки и развертывания системы в кластере Kubernetes (k8s_install), примените ключ --namespace. В ключе укажите название пространства имен, которое нужно использовать.

Пример команды для запуска конвертации базы данных:

./do.sh platform k8s_install db_convert --namespace rx412

Примечание. Если применить команду без ключа --namespace, используется пространство имен, указанное в конфигурационном файле config.yml.

4.Если docker-образы хранятся в приватном репозитории, то укажите реквизиты для доступа к нему. Для этого в секции secrets задайте значения параметров для секции imageCredentials:

•registry – FQDN-имя из адреса репозитория;

•username – имя пользователя;

•password – пароль в кодировке base64.

Пример настройки:

k8s:
    secrets:
        imageCredentials:
            registry: 'registry.example.ru'
            username: 'user'
            password: 'BASE64PASSWORD'

5.В секции secrets в параметре bundle_certs укажите корневые и промежуточные сертификаты в кодировке base64.

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

./do.sh tools to_base64 <файл сертификата> -> <путь до файла с результатом преобразования>

Пример команды:

./do.sh tools to_base64 ca-bunde.crt -> ca-bundle.txt

В результате преобразованный сертификат сохраняется в файл ca-bundle.txt.

Пример настройки:

k8s:
    secrets:
        bundle_certs:
              ca-bundle.crt: 'BASE64CERT'

ПРИМЕЧАНИЕ. В примере значение BASE64CERT – содержимое файла ca-bundle.txt.

6.В секции services для секций StorageService и PreviewStorage в параметре storageSize задайте объем дискового пространства, необходимый для хранения документов и файлов предпросмотра соответственно. В секции SungeroWebClient задайте объем, необходимый для хранения веб-справки и файлов решений.

Также укажите значение в параметре storageClass – класс, который используется в Kubernetes.

ПРИМЕЧАНИЕ. Если вместо файлового хранилища используется объектное, то в секции StorageService не заполняйте параметры storageSize и storageClass. Параметр storageClass заполните, если нужно использовать класс хранилища, отличающийся от заданного в Kubernetes по умолчанию. Иначе оставьте параметр пустым.

Пример настройки:

k8s:
    services:
        SungeroWebClient:
            storageClass: 'my storage'
            storageSize: '10Gi'
        StorageService:
            storageClass: 'my storage'
            storageSize: '100Gi'
        PreviewStorage:
            storageClass: 'my storage'
            storageSize: '1Gi'

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

ВАЖНО. Для доступа к системе рекомендуется настроить защищенный протокол HTTPS. Протокол HTTP не рекомендуется использовать для удаленного доступа к системе Directum RX, так как в этом случае данные от клиентских приложений передаются к серверу по сети в открытом виде. HTTP допускается только для работы в локальной сети, например для тестирования системы.

1.Настройте работу системы по протоколу HTTPS. Подробнее см. в документации Kubernetes статью Ingress, раздел TLS.

Также вы можете настроить доступ по протоколу через конфигурационный файл config.yml. Так как возможны разные способы настройки, то по умолчанию TLS отключен.

Настройка HTTPS в config.yml

2.Установите Helm Chart развертывания сервисов. Для этого перейдите в папку с Directum Launcher и выполните команду:

./do.sh platform k8s_install services-up

3.Проверьте доступность сайта по адресу, указанному в параметре host_fqdn в конфигурационном файле config.yml. Проверьте соединение с файловым хранилищем.

Если меняли протокол на HTTPS, то в карточке хранилища в поле Адрес сайта укажите этот же протокол для доступа к сервису хранилищ.

4.Опубликуйте стандартную прикладную разработку:

./do.sh rx install

do rx install

Если в результате публикации возникла ошибка, то:

1.Проверьте и при необходимости скорректируйте настройки:

•правильность указанного в config.yml протокола: HTTP или HTTPS;

•доступность файлового хранилища;

•доступность сервиса интеграции по URL, указанному в секции RxCmd конфигурационного файла config.yml.

2.Перепубликуйте разработку принудительно:

./do.sh rx install --force-install

do rx install --force-install

Установка через командную строку

Установка через командную строку