Скачайте два исполняемых файла утилиты (updater и clear_dict) с FS https://fs.hflabs.ru/%ваш_спейс%/updater/ — если такой папки в вашем спейсе ещё нет, обратитесь в поддержку
Переместите их в директорию «Апдейтера» и выдайте права на выполнение
Для ОС Windows все локальные пути указываются с экранированием (двойным слешем): C:\\tmp\\cdi
Для работы утилите надо знать базовый путь к справочникам, а также пользователя, под которым они работают. Настройки указываются в файле updater.env. Сгенерировать умолчательный конфиг для изменения можно с помощью команды:
su - updater
cd /opt/updater
./updater generate config
Будет создан файл конфигурации приложения config, который нужно переименовать в updater.env. В нём необходимо оставить настройки только для необходимых вам продуктов:
updater.env
# Путь к Artifactory по умолчанию:
# ARTIFACTORY_PATH="https://maven.hflabs.ru/artifactory/repo"
# Если есть локальное зеркало Artifactory, достаточно раскрыть эту переменную,
# чтобы Апдейтер переключился с maven.hflabs.ru на локальное зеркало, например:
# ARTIFACTORY_PATH="http://maven.mycorp.ru/artifactory/hflabs-maven-remote"
# Логин и пароль для авторизации в Artifactory (если у вас их нет, обратитесь в поддержку)"
ARTIFACTORY_LOGIN="..."
ARTIFACTORY_PASSWORD="..."
# Управление проверкой сертификата Artifactory.
# По умолчанию значение true.
CHECK_CERTIFICATE="..."
# Ограничивает скорость скачивания словарей (указывается в килобайтах в секунду).
# Значение по умолчанию - 0 (без ограничений).
DOWNLOAD_RATE_LIMIT=0
# Настройки подключения к прокси-серверу в формате 'http://user:password@ipaddress:port'
HTTP_PROXY='http://...'
# Таймаут подключений по HTTP в секундах (по умолчанию 10)
HTTP_TIMEOUT=...
# Количество попыток переподключения при загрузке (по умолчанию 5)
DOWNLOAD_RETRIES=...
# Использовать ли команду chown для изменения прав (по умолчанию false)
WITH_ROOT="false"
# Имя пользователя, под которым работает Апдейтер (используется для очистки старых справочников на удаленном сервере)
UPDATER_USERNAME="..."
# Уровень логирования - ERROR, WARN, INFO, DEBUG (по умолчанию INFO)
LOGGING_LEVEL="INFO"
# Путь к каталогу user_lib Фактора, включая сам user_lib
FACTOR_DICTIONARY_HOME="..."
# Имя пользователя, под которым работает Фактор
FACTOR_USERNAME="..."
# Хост, на котором работает API Фактора (если отличается от localhost)
FACTOR_API_HOST="..."
# Порт, на котором работает API Фактора
FACTOR_API_PORT="..."
# Имя заказчика в адресе к Фактору http://host:18080/factor-service-<имя заказчика>
FACTOR_API_TAG="..."
# Включение HTTPS протокола для запросов к API Фактора
FACTOR_HTTPS="true"
# Выставление версии фактора вручную. Берется, если не получилось узнать версию от API фактора
FACTOR_BUILD="21.3"
# Путь к каталогу справочников Подсказок
SUGGESTIONS_DICTIONARY_HOME="..."
# Имя пользователя, под которым работают Подсказки
SUGGESTIONS_USERNAME="..."
# Хост, на котором работает API Подсказок (если отличается от localhost)
SUGGESTIONS_API_HOST="..."
# Порт, на котором работает API Подсказок
SUGGESTIONS_API_PORT="..."
# Пароль пользователя API Подсказок (если включена авторизация в админку)
SUGGESTIONS_API_PASSWORD="..."
# Включение HTTPS протокола для запросов к API Подсказок
SUGGESTIONS_HTTPS="true"
# Выставление версии подсказок вручную. Берется, если не получилось узнать версию от API подсказок
SUGGESTIONS_BUILD="22.3"
# Путь к каталогу справочников Единого клиента
CDI_DICTIONARY_HOME="..."
# Имя пользователя, под которым работает Единый клиент
CDI_USERNAME="..."
# Имя пользователя API Единого клиента
CDI_API_USERNAME="..."
# Пароль пользователя API Единого клиента
CDI_API_PASSWORD="..."
# Хост, на котором работает API Единого клиента (если отличается от localhost)
CDI_API_HOST="..."
# Порт, на котором работает API Единого клиента
CDI_API_PORT="..."
# Включение HTTPS протокола для запросов к API Единого клиента
CDI_HTTPS="true"
# Выставление версии ЕК вручную. Берется, если не получилось узнать версию от API ЕК
CDI_BUILD="21.3"
Обратите внимание, что переменные окружения имеют больший приоритет, чем настройки конфига. Поэтому если вы переходите со старой версии утилиты, рекомендуем их очистить.
Для базовых справочников дополнительных настроек не требуются, они настроены по умолчанию. Но если используются внешние справочники (или требуется изменить настройки базовых), то их необходимо добавить в конфиг dictionaries.json Сгенерировать файл конфигурации справочников для изменения можно командой:
su - updater
cd /opt/updater
./updater generate dicts
Будет создан файл конфигурации справочников dicts, который нужно переименовать в dictionaries.json.
dictionaries.json
[
{
####### обязательные поля #######
# название справочника в формате "продукт_имя", продукт может принимать одно из трёх значений:cdi, factor, suggestions
"tag":"suggestions_eas",
# путь к директории с разными версиями этого словаря в Artifactory после значения ARTIFACTORY_PATH из конфига updater.env
"path":"ru/hflabs/dictionary/sgt-gar-eas/",
# путь от домашней директории продукта, куда нужно положить справочник (в данном случае от значения SUGGESTIONS_DICTIONARY_HOME)
"local_path":"address",
# шаблон имени словаря. В него будет подставляться версия (в формате yyyymmdd) и, если предусмотрено, билд продукта
"name_tmpl":"sgt-gar-eas-%s.zip",
# для справочников «Фактора» указывать dictionary.name из документации https://confluence.hflabs.ru/pages/viewpage.action?pageId=786235560
"factor_name": "changeMobileProvider"
####### необязательные поля #######
# требуется ли распаковка справочника после скачивания. Для всех справочников Подсказок распаковка по умолчанию не требуется, т.к. Подсказки 22.9+ умеют индексировать справочники без распаковки.
"unzip":true,
# используется для простановки в шаблон (name_tmpl) билда продукта (по умолчанию false)
"with_build_version":false,
# не удалять предыдущие версии, т.е. не очищать папку (по умолчанию false)
"increment":false,
# определяет кастомный путь в артифактори, применяется только для этого словаря
"custom_artifactory_path":"",
# определяет, является ли справочник внешним, влияет на update и unzip, предусмотрено использование только для словарей suggestions
"external":false,
# переопределение названия справочника в команде update для API Подсказок и Единого клиента (необходимо для suggestions_eas, например)
"dictionary_update_task_name":"address"
}
]