Search

Page tree
Skip to end of metadata
Go to start of metadata

Важно

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

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

./updater generate config
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 в формате "user:password"
ARTIFACTORY_BASIC_AUTH = "..."


# Управление проверкой сертификата Artifactory.
# По умолчанию значение true.
CHECK_CERTIFICATE = "..."

# Ограничивает скорость скачивания словарей (указывается в килобайтах в секунду).
# Значение по умолчанию - 0 (без ограничений).
DOWNLOAD_RATE_LIMIT=0

# Настройки подключения к прокси-серверу в формате 'http://user:password@ipaddress:port'
HTTP_PROXY='http://...'

# Использовать ли команду chown для изменения прав (по умолчанию true)
# При настройке использования утилиты от своего пользователя (по этой инструкции) выставляем false
WITH_ROOT="false"




# Путь к каталогу 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="..."

# Текущая версия Фактора (при обновлении Фактора нужно это значение нужно изменить)
FACTOR_BUILD="..."




# Путь к каталогу справочников Подсказок
SUGGESTIONS_DICTIONARY_HOME="..."

# Имя пользователя, под которым работают Подсказки
SUGGESTIONS_USERNAME="..."

# Хост, на котором работает API Подсказок (если отличается от localhost)
SUGGESTIONS_API_HOST="..."

# Порт, на котором работает API Подсказок
SUGGESTIONS_API_PORT="..."


# Пароль пользователя API Подсказок (если включена авторизация в админку)
SUGGESTIONS_API_PASSWORD="..."




# Путь к каталогу справочников Единого клиента
CDI_DICTIONARY_HOME="..."

# Имя пользователя, под которым работает Единый клиент
CDI_USERNAME="..."

# Имя пользователя API Единого клиента
CDI_API_USERNAME="..."

# Пароль пользователя API Единого клиента
CDI_API_PASSWORD="..."

# Хост, на котором работает API Единого клиента (если отличается от localhost)
SUGGESTIONS_API_HOST="..."

# Порт, на котором работает API Единого клиента
CDI_API_PORT="..."

# Токен, на котором работает API Единого клиента
SUGGESTIONS_API_PASSWORD=""

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

unset ARTIFACTORY_PATH
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
Сгенерировать файл конфигурации справочников для изменения можно командой:

./updater generate dicts
dictionaries.json
[
  {    
####### обязательные поля #######

# название справочника в формате "продукт_имя", продукт может принимать одно из трёх значений:cdi, factor, suggestion
      "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",

# для справочников фактора указывать имя также как оно написано http://host:18080/factor-service-<имя заказчика>
	 "factor_name": "changeMobileProvider"



####### необязательные поля #######

# требуется ли распаковка справочника после скачивания. Для всех справочников подсказок распаковка не требуется!
      "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"
  }
]
  • No labels