./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 | Иностранные адреса | 90M | 23.11+ |
suggestions_geonames | Города мира (кроме Белоруссии) | 290M | |
suggestions_osm | Адреса Белоруссии | 70M | |
suggestions_fias | ФИАС | 9100M | |
suggestions_bank | Банки | 5M | |
suggestions_email | Эл. почта | 20M | |
suggestions_fio | ФИО | 40M | |
suggestions_ip | IP-адреса | 7M | |
suggestions_party | Компании | 19050M | |
suggestions_partyext | Компании (ранжирование + реестры) | 200M | |
suggestions_partyinc | Компании (инкрементальный справочник) | — |
Справочники «Единого клиента»:
Код | Описание |
---|---|
cdi_egr | ЕГРЮЛ в плоском виде |
cdi_egrnorm | ЕГРЮЛ в нормализованном виде |
cdi_egrnorminc | ЕГРЮЛ в нормализованном виде (инкремент) |
Путь к каталогу справочника на сервере приложения Пользователь |
И все внешние справочники.
Если утилита установлена на сервере приложения (разрешён доступ к репозиторию 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 |