Утилита умеет:
Команда | Описание |
---|---|
download | Скачать справочник на сервер приложения |
update | Обновить справочник, предварительно скачанный на сервер приложения |
download-outward | Скачать внешний справочник на сервер приложения |
update-outward | Обновить внешний справочник, предварительно скачанный на сервер приложения |
Поддерживаются справочники:
Код | Описание | Размер | Версия |
---|---|---|---|
suggestions_address | Адреса России (только адм. деление) | 9100M | до 22.11 |
suggestions_eas | Адреса России (адм. + мун. деление) | 4500M | 22.4+ |
suggestions_geo | координаты | 1300M | |
suggestions_house | дополнительные дома | 65M | |
suggestions_stead | земельные участки | — | 21.12+ |
suggestions_flat | квартиры | — | 21.2+ |
suggestions_iso3166 | ISO-коды | 1M | |
suggestions_address_foreign | Адреса стран мира | 90M | 23.11+ |
suggestions_geonames | Города мира (кроме Белоруссии) | 290M | до 23.9 |
suggestions_osm | Адреса Белоруссии | 70M | до 23.9 |
suggestions_fias | ФИАС | 9100M | |
suggestions_bank | Банки | 5M | |
suggestions_email | Эл. почта | 20M | |
suggestions_fio | ФИО | 40M | |
suggestions_ip | IP-адреса | 7M | |
suggestions_party | Компании | 19050M | |
suggestions_partyext | Компании (ранжирование + реестры) | 200M |
И все внешние справочники.
Скачивание справочников
Если на сервере приложения разрешён доступ к репозиторию HFLabs, для скачивания справочника достаточно команды download:
# Команды выполняются на сервере приложения env/bin/fab download suggestions_bank env/bin/fab download suggestions_email env/bin/fab download suggestions_fio env/bin/fab download suggestions_ip 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_address_foreign env/bin/fab download suggestions_party env/bin/fab download suggestions_partyext
Если же на сервере приложения внешний доступ полностью закрыт, воспользуйтесь командами 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_bank env/bin/fab update suggestions_email env/bin/fab update suggestions_fio env/bin/fab update suggestions_ip env/bin/fab update suggestions_eas env/bin/fab update suggestions_flat env/bin/fab update suggestions_stead env/bin/fab update suggestions_address_foreign env/bin/fab update suggestions_party
Если утилита выполняется с внешней машины:
# Команды выполняются на внешней машине # 10.0.1.34 — адрес сервера приложения env/bin/fab -H 10.0.1.34 update suggestions_bank ...
Скачивание и обновление внешних справочников 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