side menu

Установить сервисы для полнотекстового поиска в Kubernetes пакетом Helm

Установка OpenSearch и сервисов fulltextsearcher и textextractor в Kubernetes с помощью Helm-пакета состоит из следующих шагов:

  1. Загрузить Helm-чарт и конфигурационный файл.
  2. Заполнить конфигурационный файл.
  3. Установить чарт elma365-dbs в Kubernetes-кластер с помощью Helm.
  4. Выполнить подключение к сервису Opensearch.
  5. Применить параметры полнотекстового поиска для ELMA365 Enterprise.

Шаг 1. Загрузить Helm-чарт и конфигурационный файл

Для установки через интернет получите конфигурационный файл values-elma365-dbs.yaml, выполнив команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm show values elma365/elma365-dbs > values-elma365-dbs.yaml

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

  1. На компьютере с доступом в интернет скачайте образы ELMA365 и загрузите их в локальный реестр образов. Подробнее читайте в статье «Загрузка образов ELMA365». Выполните следующую команду:

helm repo add elma365 https://charts.elma365.tech
helm repo update
helm pull elma365/elma365-dbs

  1. Полученный архив чарта elma365-dbs-X.Y.Z.tgz скопируйте на сервер, где будет производиться установка.
  2. Распакуйте этот чарт и скопируйте конфигурационный файл по умолчанию values.yaml в values-elma365-dbs.yaml:

tar -xf elma365-dbs-X.Y.Z.tgz
cp elma365-dbs/values.yaml values-elma365-dbs.yaml

Шаг 2. Заполнить конфигурационный файл

Сервис Opensearch можно установить совместно с чартом elma365-dbs или отдельно в другое пространство имён (namespace). Заполним конфигурационный файл values-elma365-dbs.yaml для установки Opensearch:

  1. В разделе global для компонента opensearch в параметре enabled включите установку Opensearch:

# Выбор устанавливаемых БД.
global:
  opensearch:
    # Установка opensearch (Включается для fulltextsearcher)
    enabled: true

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

# Выбор устанавливаемых БД.
global:
...
# Настройки opensearch (Включается для fulltextsearcher)
opensearch:
# cluster Mode — отключите параметр singleNode
  singleNode: true
  extraEnvs:
    - name: OPENSEARCH_INITIAL_ADMIN_PASSWORD
      value: 123456ASdlkjqweq
    - name: "plugins.security.ssl.http.enabled"
       value: "false"
  config:
    opensearch.yml: |
      network.host: '*'
  persistence:
    enabled: true
    size: 10Gi
  # storageClass: "-"
...

  1. Для настройки отказоустойчивости переключите параметр singleNode:

# Выбор устанавливаемых БД.
global:
...
# Настройки opensearch (Включается для fulltextsearcher)
opensearch:
...
  # cluster Mode - отключите параметр singleNode
  singleNode: false
...

  1. Для установки чарта elma365-dbs в закрытом контуре без доступа в интернет, заполните параметры подключения к приватному registry.

Пример заполнения параметров для подключения к приватному registry

  1. Задайте адрес и путь к приватному registry в параметре opensearch.persistance.image для контейнера инициализации.
  2. Задайте адрес и путь к приватному registry в параметре opensearch.image.repository.
  3. Создайте вручную секрет с правами доступа к приватному registry и зашифруйте в Base64.
  4. Укажите наименование созданного секрета в параметре opensearch.image.pullSecrets.

 

# Выбор устанавливаемых БД
global:
...
# Настройки БД postgres
opensearch:
...
  # Включите контейнер инициализации
  # Контейнер меняет владельца и группу точки монтирования тома на `RunAsUser:fsGroup
  persistence:
    enabled: true
    # адрес и секрет для приватного registry образов контейнера инициализации
    image: registry.example.com
...
  # адрес и секрет для приватного registry
  image:
    repository: registry.example.com/opensearch
    # секрет с правами доступа к приватному registry нужно создать вручную и зашифровать в Base64
    pullSecrets:
      - myRegistryKeySecretName
...

где формат repository:

  • адрес — registry.example.com;
  • путь — /opensearch.

Шаг 3. Установить чарт elma365-dbs в Kubernetes-кластер с помощью Helm

Выполните установку чарта elma365-dbs в namespace elma365-dbs:

  • для установки через интернет:

helm upgrade --install opensearch elma365/elma365-dbs -f values-elma365-dbs.yaml -n opensearch --create-namespace

  • для установки без доступа в интернет перейдите в каталог с загруженным чартом и выполните команду:

helm upgrade --install opensearch ./elma365-dbs -f values-elma365-dbs.yaml -n opensearch --create-namespace

Шаг 4. Выполнить подключение к сервису Opensearch

  1. Создайте резервную копию уже существующего конфигурационного файла values-elma365.yaml, который получен и заполнен при установке ELMA365. Это позволит избежать потери работоспособности приложения ELMA365 при некорректном изменении параметров.
  2. Внесите изменения в уже существующий конфигурационный файл values-elma365.yaml:
  • включите параметры global.extensions.name.fulltextsearcher.enabled и global.extensions.name.textextractor.enabled, установив для них значение true;
  • настройте подключение к Opensearch в параметре global.extensions.opensearch.

global:
  ...
  extensions:
# включение полнотекстового поиска с использованием Opensearch
    - name: fulltextsearcher
      enabled: true
# требует настройки подключения к Opensearch
      opensearch:
        addresses: "http://opensearch-cluster-master.opensearch.svc.cluster.local:9200/"
        login: "admin"
        password: "123456ASdlkjqweq"
        textExtractorURL: "http://textextractor:3000/"
        itemsTransferPerIteration: 400
        itemsWorkers: 4
        taskWorkers: 1
# включение модуля извлечения текста из офисных документов
    - name: textextractor
      enabled: true
...

Шаг 5. Применить параметры полнотекстового поиска

Выполните обновление параметров приложения ELMA365 с использованием конфигурационного файла values-elma365.yaml.

Для обновления параметров через интернет:

  1. Определите версию чарта, с помощью которого было установлено приложение ELMA365, выполнив команду:

helm show chart elma365/elma365

Пример выполнения команды:

full-text-search-in-kubernetes-1

В строке version указана версия чарта, которая использовалась для установки приложения ELMA365.

  1. Выполните обновление параметров с указанием установленной версии приложения ELMA365:

helm upgrade --install elma365 elma365/elma365 -f values-elma365.yaml --version <elma365-chart-version> --timeout=30m --wait [-n namespace]

Вместо значения <elma365-chart-version>) для флага –version укажите версию чарта, полученную на предыдущем шаге.

Обновление параметров без доступа в интернет

  1. Перейдите в каталог с загруженным чартом ELMA365 и выполните команду:

helm upgrade --install elma365 ./elma365 -f values-elma365.yaml --timeout=30m --wait [-n namespace]

  1. Обновление параметров занимает 10-30 минут. Дождитесь его завершения.

Удалить чарт Opensearch в Kubernetes-кластере с помощью Helm

Чтобы удалить чарт Opensearch в namespace opensearch, выполните команду:

helm uninstall opensearch -n opensearch

full-text-search-services.html full-text-search-licenses.html