Использование

./updater <команда> <параметры>

Команды

КомандаОписаниеПараметрыОписание параметра
downloadСкачать справочник на сервер «Апдейтера» (директория указывается в updater.env и dictionaries.json)
<код_справочника>
код справочника для скачивания


scp


Скопировать справочник с локальной машины на сервер приложения 
-Hхост сервера приложений
-Pпорт сервера приложений
-Dдиректория для справочника на сервере приложений
-fсоздать папку под новый справочник (не рабоает с -D)
<код_справочника>
код справочника для копирования


scphere


Скопировать справочник с удаленного сервера на сервер «Апдейтера» 

-Hхост удаленного сервера
-Pпорт удаленного сервера
-Dдиректория справочника на удаленном сервере
<код_справочника>
код справочника для копирования
updateОбновить справочник, предварительно скачанный на сервер приложения-fпринудительное обновление
-Hхост сервера приложений (при удаленном обновлении)
<код_справочника>
код справочника для обновления



generate



Генерация конфигов и журналов событий 

configсгенерировать умолчательный updater.env
dictsсгенерировать умолчательный dictionaries.json
reportсгенерировать логи за указанное число дней
errorsсгенерировать лог только ошибок
listdirПоказать содержимое папки, в качестве аргумента название продукта cdi/factor/suggestions

cleanupУдаляет неактуальные версии указанного справочника-aудаление всех версий справочника
versionПоказать версию «Апдейтера» с указанием ОС и архитектуры, а также билды продуктов из updater.env

helpПоказать help

remoteВызвать функцию на определенной ноде

serverЗапустить апдейтер в режиме сервере-port, -pвыбрать порт, умолчательный 3000
syncConfigСинхронизировать конфиг на удаленной ноде с текущим апдейтером

uploadЗагрузить справочник на определенную ноду

Справочники

Поддерживаются справочники «Фактора»:

КодОписаниеРазмер
factor_dispemailОдноразовые адреса эл. почты2M
factor_fiasФИАС до дома1600M
factor_fiasroomsФИАС с квартирами
factor_fiasfullФИАС с квартирами и зем. участками4800M
factor_flatareaПлощади квартир260M
factor_flatpriceСтоимости квартир5M
factor_geocodeГеокоординаты180M
factor_invpassportНедействительные паспорта490M
factor_oktmoОКТМО110M
factor_rossvyazСправочник Россвязи3M
factor_tldДомены верхнего уровня0M
factor_transphoneПеренесённые телефонные номера60M

Справочники «Подсказок»:

КодОписаниеРазмерВерсия
suggestions_addressАдреса России (только адм. деление)9100M
suggestions_easАдреса России (адм. + мун. деление)4500M
suggestions_geo    координаты1300M
suggestions_house    дополнительные дома65M
suggestions_stead    земельные участки
suggestions_flat    квартиры
suggestions_iso3166    ISO-коды1M

suggestions_address_foreign

Иностранные адреса90M23.11+
suggestions_geonamesГорода мира (кроме Белоруссии)290M
suggestions_osmАдреса Белоруссии70M
suggestions_fiasФИАС9100M
suggestions_bankБанки5M
suggestions_emailЭл. почта20M
suggestions_fioФИО40M
suggestions_ipIP-адреса7M
suggestions_partyКомпании19050M
suggestions_partyextКомпании
(ранжирование + реестры)
200M
suggestions_partyincКомпании (инкрементальный справочник)

Справочники «Единого клиента»:

КодОписание
cdi_egrЕГРЮЛ в плоском виде
cdi_egrnormЕГРЮЛ в нормализованном виде
cdi_egrnormincЕГРЮЛ в нормализованном виде (инкремент)

Особенности обновления справочника ЕГРЮЛ в ЕК

Путь к каталогу справочника на сервере приложения ($CDI_DICTIONARY_HOME/egr) должен быть заранее прописан в настройках задачи EgrDictionaryImport.

Пользователь $CDI_API_USERNAME должен иметь права на работу с SOAP-сервисом TaskWS.

И все внешние справочники.

Скачивание справочников

Если утилита установлена на сервере приложения (разрешён доступ к репозиторию HFLabs), для скачивания справочника достаточно команды download:

# Команды выполняются на сервере приложения

# - скачать справочник Подсказок 
./updater download suggestions_eas


# - скачать справочник Фактора 
./updater download factor_fias


# - скачать справочник Единого клиента 
./updater download cdi_egr

Если же утилита установлена на отдельном сервере от приложений воспользуйтесь дополнительной командой scp:

С версии updater 1.3.0 в команду scp была встроена функция удаления не актуальных справочников. Для ее использования в корневой директории updater должен лежать файл "clear_dict".

Файл "clear_dict" можно взять на FS.

# Команды выполняются на сервере «Апдейтера»
# 10.0.1.34 — адрес сервера приложения

1) # Перед первым копированием на удаленный сервер необходимо выполнить команду:
ssh 10.0.1.34 
# принять сертификат и добавить в known-hosts, ответив yes на вопрос

2) # Нужно настроить общение между серверами без пароля
ssh-keygen  # получить ключ id_rsa
ssh-copy-id -i ~/.ssh/id_rsa.pub 10.0.1.34  # перенести ключ на удаленный сервер
# Команды выполняются на сервере «Апдейтера»
# 10.0.1.34 — адрес сервера приложения



# 1) скачать справочник локально в каталог из updater.env (должен совпадать с каталогом на сервере приложения)
./updater download suggestions_email

# 2)  затем скопировать скачанный справочник на сервер приложения. При первом скачивании можно использовать -f, чтобы создать папку по local path.
./updater scp -H 10.0.1.34 suggestions_email



## Если порт отличается от умолчательного 22 и путь до справочника не совпадает с updater.env, то добавьте следующие опции в команду:
./updater scp -H 10.0.1.34 -P 321 -D /opt/service/dictionaries/sug/email suggestions_email
# где:
# 321 — порт для scp на сервере приложении
# /opt/service/dictionaries/sug/email — путь до справочника на сервере приложений

## -f для scp можно использовать только с путем из updater.env. Если одновременно будет задан флаг -D /opt/service/dictionaries/sug/email и -f, то -f не применится.

Обновление справочников

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

Если утилита установлена на сервере приложения:

# - обновить справочник Подсказок 
./updater update suggestions_eas


# - обновить справочник Фактора
./updater update factor_fias 


# - обновить справочник Единого клиента
./updater update cdi_egr

Если утилита установлена на удаленном сервере:

# 192.168.0.11 - IP сервера приложений

# - обновить справочник Подсказок 
./updater update -H 192.168.0.11 suggestions_eas


# - обновить справочник Фактора
./updater update -H 192.168.0.11 factor_fias 


# - обновить справочник Единого клиента
./updater update -H 192.168.0.11 cdi_egr
  • No labels