Утилита умеет:
| Команда | Описание | Опция | Описание опции |
|---|---|---|---|
| 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 | ФИАС до дома | 1200M |
| factor_fiasrooms | ФИАС с квартирами | — |
| factor_fiasfull | ФИАС с квартирами и зем. участками | 2750M |
| 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_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 | ЕГРЮЛ в нормализованном виде (инкремент) |
Особенности обновления справочника ЕГРЮЛ в ЕК
Путь к каталогу справочника на сервере приложения ($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:
# Команды выполняются на сервере «Апдейтера» # 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
Обзор
Инструменты контента