Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление

Скачивание справочников

Выполнить команду:

Блок кода
languagebash
./updater download <код_справочника>

Если утилита установлена на сервере приложения продукта (+ разрешён доступ к репозиторию HFLabs), для скачивания справочника достаточно команды download:

Блок кода
languagebash

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

...

Поддерживаются справочники «Фактора»:

...

Справочники «Подсказок»:

...

Справочники «Единого клиента»:

...

И все внешние справочники.

Скачивание справочников

Если на сервере приложения разрешён доступ к репозиторию HFLabs, для скачивания справочника достаточно команды download:

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

# -Скачать скачатьсправочник справочники Подсказок
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 Фактора  / Единого клиента  
./updater download suggestions_partyext
env/bin/fab download suggestions_email
env./bin/fabupdater 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 ./updater download cdi_egr

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

(предупреждение) Между серверами должна быть настроена беспарольная ssh авторизацию (по ключу).

С версии updater 1.3.0 в команду scp была встроена функция удаления не актуальных справочников. Для ее использования в корневой директории updater должен лежать файл "clear_dict".

Файл "clear_dict" можно взять на FS.

noformat
Блок кода
languagebash
# Команды выполняются на внешнейсервере машине«Апдейтера»
# 10.0.1.34 — некий адрес сервера приложения

# 1) скачать справочник локально в каталог /tmp/dictionaries/email
env/bin/fab download-to из updater.env (должен совпадать с каталогом на сервере приложения)
./updater download suggestions_email /tmp/dictionaries/email

# 2) затем скопировать скачанный справочник на сервер приложения
env/bin/fab. При первом скачивании можно использовать -f, чтобы создать папку по local path.
./updater scp -H 10.0.1.34 scp suggestions_email /tmp/dictionaries/email

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

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

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



## Если порт отличается от умолчательного 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 не применится.

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

Выполнить команду:

Блок кода
languagebash
./updater update <код_справочника>

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

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

Блок кода
languagebash
# Обновить справочник Подсказок /  Фактора  / Единого клиента   
./updater update suggestions_email
./updater update factor_fias 
./updater
Без форматирования
# Команды выполняются на сервере приложения

# - обновить справочники Подсказок
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

Если утилита выполняется с внешней машиныустановлена на удаленном сервере:

noformat
Блок кода
languagebash
# Команды выполняются на внешней машине
# 10.0.1.34 - некий адресIP сервера приложенияприложений

# -Обновить обновитьсправочник справочники Подсказок
env/bin/fab /  Фактора  / Единого клиента   
./updater update -H 10.0.1.34 update suggestions_addressemail
...

# - обновить справочники Фактора
env/bin/fab /updater update -H 10.0.1.34 update factor_geocodefias 
...

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