Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 55 Следующий »


Установка

  1. Скачайте два исполняемых файла утилиты (updater и clear_dict) с https://fs.hflabs.ru/%ваш_спейс%/updater/ — если такой папки в вашем спейсе ещё нет, обратитесь в поддержку продукта, для которого используется Апдейтер.

  2. Переместите их в директорию «Апдейтера» и выдайте права на выполнение

    # Перемещаем исполняемые файлы (если загрузили их директорию /tmp)
mv /tmp/updater /opt/updater/
mv /tmp/clear_dict /opt/updater/

# Устанавливаем владельца
chown updater: /opt/updater/updater
chown updater: /opt/updater/clear_dict

# Выдаем права
chmod 755 /opt/updater/updater
chmod 755 /opt/updater/clear_dict

Настройка приложения

Важно

Для ОС Windows все локальные пути указываются с экранированием (двойным слешем): C:\\tmp\\cdi

Настройки указываются в файле updater.env. 
Сгенерите умолчательный конфиг с помощью команды:

su - updater
cd /opt/updater
./updater generate config

Будет создан файл конфигурации приложения config, который нужно переименовать в updater.env.

mv config updater.env

В нём необходимо оставить настройки только для необходимых вам продуктов:

Невозможно предоставить {include} Включенная страница не может быть найдена.

Обратите внимание, что переменные окружения имеют больший приоритет, чем настройки конфига. Поэтому если вы переходите со старой версии утилиты, рекомендуем их очистить. 

unset ARTIFACTORY_HOST
unset FACTOR_DICTIONARY_HOME
unset FACTOR_USERNAME
unset FACTOR_BUILD
unset SUGGESTIONS_DICTIONARY_HOME
unset SUGGESTIONS_USERNAME
unset SUGGESTIONS_API_PORT
unset CDI_DICTIONARY_HOME
unset CDI_USERNAME
unset CDI_API_USERNAME
unset CDI_API_PASSWORD
unset CDI_API_PORT

Настройка справочников

Для базовых справочников дополнительных настроек не требуются, они настроены по умолчанию. Если же требуется изменить настройки базовых справочников или добавить кастомный, то необходимо добавить внешний файл dictionaries.json, где указать нужные параметры.

Пример для каждого продукта:

dictionaries.json
[
  {
    "tag": "cdi_egrnorm",
    "path": "ru/hflabs/factor/dictionary/egr-cdi-norm",
    "local_path": "egr",
    "name_tmpl": "egr-cdi-norm-%s.dic",
    "task_name": "EgrDictionaryImport"
  },
  {
    "tag": "factor_flatarea",
    "path": "ru/hflabs/factor/index/index_flatArea",
    "name_tmpl": "index_flatArea-%s-%%s.idx",
    "with_build_version": true,
    "factor_name": "flatArea"
  },
  {
    "tag": "suggestions_iso3166",
    "path": "ru/hflabs/suggestions/iso3166",
    "local_path": "address/iso3166",
    "name_tmpl": "iso3166-%s.zip",
    "dictionary_update_task_name": "address"
  }
]

Настраиваемые параметры:

НазваниеОписаниеЗначение по умолчанию
tagНазвание справочника в формате "продукт_имя".
Продукт может принимать одно из трёх значений: cdi, factor, suggestions
pathПуть к директории с разными версиями этого словаря в Artifactory после значения ARTIFACTORY_PATH из конфига updater.env
local_pathПуть относительно домашней директории продукта (FACTOR_DICTIONARY_HOME / SUGGESTIONS_DICTIONARY_HOME / CDI_DICTIONARY_HOME), куда нужно положить справочник.
Если пустой, справочник будет размещен прям в ней.
name_tmplШаблон имени справочника.
В него будет подставляться версия (в формате yyyymmdd) и, если предусмотрено, билд продукта
with_build_versionИспользуется для простановки в шаблон (name_tmpl) билда продуктаfalse
unzipТребуется ли распаковка справочника после скачивания.
Для всех справочников Подсказок распаковка по умолчанию не требуется, т.к. Подсказки 22.9+ умеют индексировать справочники без распаковки.		false
incrementНе удалять предыдущие версии (т.е. не очищать папку). false
depends_on

Указывает на конфиг другого словаря (обязательно должен присутствовать).

Позволяет перекрыть параметры.


task_name
Название задачи в Едином клиенте / Едином адресе, которую надо вызвать через API во время команды update
EgrDictionaryImport
factor_name
Значение dictionary.name для справочников Фактора, для которого будет запущено через API горящее обновление во время команды update
dictionary_update_task_name

Переопределение названия справочника в команде update для API Подсказок.

 

external

Определяет, является ли справочник внешним, влияет на update и unzip.

Предусмотрено использование только для словарей suggestions, чтобы можно было заиспользовать с другими, нужны доработки.

false

custom_artifactory_path

Определяет кастомный путь в артифактори, применяется только для этого словаря. Пока экспериментальная настройка

 


  • Нет меток