Утилита умеет:
| Команда | Описание |
|---|---|
| download | Скачать справочник на сервер приложения (директория указывается в updater.env и dictionaries.json) |
| scp | Скопировать справочник с локальной машины на сервер приложения (есть опции -H, -P, -D — хост, порт и директория соответственно) |
| scphere | Скопировать справочник с удаленной машины на сервер «Апдейтера» (есть опции -H, -P — хост, порт соответственно) |
| update | Обновить справочник, предварительно скачанный на сервер приложения (есть опции -f | --force и -H | --host) |
| generate | Генерация конфигов и журнала событий (аргументы config, dicts, report, errors) |
| listdir | Показать содержимое папки, в качестве аргумента название продукта cdi/factor/suggestions |
| cleanup | Удаляет неактуальные версии указанного справочника (есть опция -a | --all для удаления и актуальной версии в том числе) |
Поддерживаются справочники «Фактора»:
| Код | Описание | Размер |
|---|---|---|
| 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 | Компании (инкрементальный справочник) | 30M |
Справочники «Единого клиента»:
| Код | Описание |
|---|---|
| cdi_egr | ЕГРЮЛ в плоском виде |
| cdi_egrnorm | ЕГРЮЛ в нормализованном виде |
| cdi_egrnorminc | ЕГРЮЛ в нормализованном виде (инкремент) |
И все внешние справочники.
Скачивание справочников
Если на сервере приложения разрешён доступ к репозиторию HFLabs, для скачивания справочника достаточно команды download:
# Команды выполняются на сервере приложения # - скачать справочники Подсказок ./updater download suggestions_eas ./updater download suggestions_geo ./updater download suggestions_house ./updater download suggestions_iso3166 ./updater download suggestions_geonames ./updater download suggestions_osm ./updater download suggestions_bank ./updater download suggestions_email ./updater download suggestions_fio ./updater download suggestions_ip ./updater download suggestions_party ./updater download suggestions_partyext # - скачать справочники Фактора ./updater download factor_dispemail ./updater download factor_fias ./updater download factor_flatarea ./updater download factor_flatprice ./updater download factor_geocode ./updater download factor_invpassport ./updater download factor_oktmo ./updater download factor_rossvyaz ./updater download factor_tld ./updater download factor_transphone # - скачать справочники Единого клиента ./updater download cdi_egr
Если же на сервере приложения внешний доступ полностью закрыт, воспользуйтесь командой scp:
# Команды выполняются на внешней машине # 10.0.1.34 — адрес сервера приложения # 222 — порт для scp на сервере приложении, если по умолчанию 22, то можно не указывать # /opt/service/dictionaries/sug/email — путь до справочника на сервере приложений, можно не указывать если совпадает с прописанным в updater.env # 1) скачать справочник локально в каталог из updater.env (должен совпадать с каталогом на сервере приложения) ./updater download suggestions_email # 2) затем скопировать скачанный справочник на сервер приложения ./updater scp -H 10.0.1.34 -P 222 -D /opt/service/dictionaries/sug/email suggestions_email ## Если порт умолчательный 22 и путь до справочника совпадает с updater.env, то команда сократится до ./updater scp -H 10.0.1.34 suggestions_email
Обновление справочников
Обновление справочника всегда выполняется командой update, предварительно справочник должен быть скопирован на сервер приложения.
Если утилита выполняется на сервере приложения:
# Команды выполняются на сервере приложения # - обновить справочники Подсказок ./updater update suggestions_eas ./updater update suggestions_stead ./updater update suggestions_flat ./updater update suggestions_geo ./updater update suggestions_house ./updater update suggestions_iso3166 ./updater update suggestions_geonames ./updater update suggestions_osm ./updater update suggestions_bank ./updater update suggestions_email ./updater update suggestions_fio ./updater update suggestions_ip ./updater update suggestions_party ./updater update suggestions_partyext # - обновить справочники Фактора ./updater update factor_dispemail ./updater update factor_fias ./updater update factor_flatarea ./updater update factor_flatprice ./updater update factor_geocode ./updater update factor_invpassport ./updater update factor_oktmo ./updater update factor_rossvyaz ./updater update factor_tld ./updater update factor_transphone # - обновить справочники Единого клиента ./updater update cdi_egr
Если утилита выполняется с внешней машины:
# Команды выполняются на внешней машине # 10.0.1.34 — адрес сервера приложения # - обновить справочники Подсказок env/bin/fab -H 10.0.1.34 update suggestions_address ... # - обновить справочники Фактора env/bin/fab -H 10.0.1.34 update factor_geocode ... # - обновить справочники Единого клиента env/bin/fab -H 10.0.1.34 update cdi_egr
Проверка версии
Чтобы проверить версию утилиты, выполните команду version:
./updater version
Обзор
Инструменты контента