Апдейтер - команды и справочники

Утилита умеет:

Команда	Описание
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:

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

# - скачать справочники Подсказок
env/bin/fab download suggestions_eas
env/bin/fab download suggestions_geo
env/bin/fab download suggestions_house
env/bin/fab download suggestions_iso3166
env/bin/fab download suggestions_geonames
env/bin/fab download suggestions_osm
env/bin/fab download suggestions_bank
env/bin/fab download suggestions_ip
env/bin/fab download suggestions_party
env/bin/fab download suggestions_partyext
env/bin/fab download suggestions_email
env/bin/fab download suggestions_fio

# - скачать справочники Фактора
env/bin/fab download factor_geocode
env/bin/fab download factor_fias
env/bin/fab download factor_flatarea
env/bin/fab download factor_flatprice
env/bin/fab download factor_invpassport
env/bin/fab download factor_transphone

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

Если же на сервере приложения внешний доступ полностью закрыт, воспользуйтесь командами download-to и scp:

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

# 1) скачать справочник локально в каталог /tmp/dictionaries/email
env/bin/fab download-to suggestions_email /tmp/dictionaries/email

# 2) затем скопировать скачанный справочник на сервер приложения
env/bin/fab -H 10.0.1.34 scp suggestions_email /tmp/dictionaries/email

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

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

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

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

# - обновить справочники Подсказок
env/bin/fab update suggestions_address
env/bin/fab update suggestions_flat
env/bin/fab update suggestions_geonames
env/bin/fab update suggestions_osm
env/bin/fab update suggestions_bank
env/bin/fab update suggestions_ip
env/bin/fab update suggestions_party
env/bin/fab update suggestions_email
env/bin/fab update suggestions_fio

# - обновить справочники Фактора
env/bin/fab update factor_geocode
env/bin/fab update factor_fias
env/bin/fab update factor_flatarea
env/bin/fab update factor_flatprice
env/bin/fab update factor_invpassport
env/bin/fab update factor_transphone

# - обновить справочники Единого клиента
env/bin/fab 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

Скачивание и обновление внешних справочников HFLabs

Внешние справочники можно скачивать только непосредственно на сервер приложения. Если с сервера приложения нет доступа к репозиторию HFLabs, создайте каталог справочников на машине, с которой доступ есть, и подключите этот каталог на сервере приложения (по SSHFS или NFS, например).

Скачать и обновить внешний справочник (на примере справочника fms_unit):

env/bin/fab download-outward public fms_unit
env/bin/fab update-outward public fms_unit

Скачивание и обновление внешних справочников заказчика

Если внешний справочник создан заказчиком, скачать через апдейтер его не получится. Скопируйте конфигурацию и содержимое справочника на сервер «Подсказок» по инструкции.

После того, как справочник скопирован на сервер, его можно обновить командой update-outward (замените NAME на название справочника):

env/bin/fab update-outward public NAME

Проверка версии

Чтобы проверить версию утилиты, выполните команду version:

env/bin/fab version

Дерево страниц