Утилиту можно запускать с самого сервера приложения, либо с любой другой машины, с которой есть доступ по SSH к серверу приложения.

Запуск с сервера приложения

Синтаксис следующий:

env/bin/fab название_команды название_справочника

Авторизация в репозитории

Утилита скачивает справочники из репозитория HFLabs (maven.hflabs.ru). С мая 2024 он требует авторизации.

Если вы установили «Подсказки» по инструкции и запускаете «апдейтер» с сервера приложения под пользователем factor — он авторизуется автоматически, ничего дополнительно настраивать не требуется.

В противном случае, задайте для пользователя, под которым запускается утилита, настройки в файле ~/.netrc:

~/.netrc
machine maven.hflabs.ru
login ЛОГИН
password ПАРОЛЬ

Если не знаете логин и пароль, уточните их в службе поддержки.

Запуск с другой машины

В этом варианте утилита использует настройки ~/.ssh/config для подключения к серверу приложения. Например:

~/.ssh/config
Host 10.0.1.34
    User root
    IdentityFile ~/.ssh/suggestions_rsa

Для пользователя, под которым происходит подключение, должен быть настроен paswordless sudo.

Допустим, апдейтер подключается к серверу приложения под пользователем updater. Тогда для него на сервере приложения следует создать приватный файл:

visudo -f /etc/sudoers.d/updater

И прописать в нём:

updater ALL=(ALL) NOPASSWD: /usr/bin/chown
updater ALL=(ALL) NOPASSWD: /usr/bin/touch

Указав вместо «IP_АДРЕС» ip-адрес машины с апдейтером.

Авторизацию рекомендуем настроить по сертификату. В противном случае придётся каждый раз вводить пароль, и настроить автоматический запуск утилиты не получится.

Синтаксис запуска следующий:

env/bin/fab -H IP_адрес_сервера название_команды название_справочника

Если вы всё-таки выберете авторизацию по паролю, укажите дополнительный ключ:

env/bin/fab -H IP_адрес_сервера --prompt-for-login-password название_команды название_справочника

Работа через прокси-сервер

Чтобы апдейтер работал через прокси-сервер, требуется прописать его настройки в двух местах. Во-первых, в updater.env:

updater.env
export HTTP_PROXY="http://proxy_server_ip:port"
export HTTPS_PROXY="https://proxy_server_ip:port"

Во-вторых, в ~/.wgetrc для пользователя, под которым запускается апдейтер:

~/.wgetrc
use_proxy=yes
http_proxy=http://proxy_server_ip:port
https_proxy=https://proxy_server_ip:port
no_proxy=localhost
  • No labels