Параметры конфигурирования компонентаПараметры конфигурирования Шлюза задаются в конфигурационном файле |
При обновлении компонента «Универсальный диспетчер» и/или Шлюза |
Реализована обратная совместимость с прошлым файлом конфигурации: файл |
Для задания параметров конфигурирования Шлюза из файла нужно отредактировать файл /etc/termidesk/gateway.yaml, указав необходимые значения для параметров.
В примере файла значения параметров user и pass преобразованы c помощью утилиты gwpasswd, которая входит в состав компонента.
Пример файла /etc/termidesk/gateway.yaml:
_val0: &sslprof0
key: ${sslKey:/etc/termidesk/ssl-cert-snakeoil.key}
cert: ${sslCert:/etc/termidesk/ssl-cert-snakeoil.pem}
ca: ${sslCa}
passphrase: ${sslPassPhrase}
dhparams: ${sslDhParams}
ciphers: ${sslCiphers}
gwservers:
- listen: ${wsServerIP:0.0.0.0}:${wsServerPort:5099}
websocket:
pingtimeout: ${wsIdleTimeout:30}
checktoken:
url: ${urlCheckToken:https://disp.termidesk.local/api/wsproxy/v1.1/verify}
tcp_downstream:
reconnect: ${gwTCPReconnect:0}
- listen: ${wssServerIP:0.0.0.0}:${wssServerPort:10000}
websocket:
pingtimeout: ${wsIdleTimeout:30}
checktoken:
url: ${urlCheckToken:https://disp.termidesk.local/api/wsproxy/v1.1/verify}
tcp_downstream:
reconnect: ${gwTCPReconnect:0}
ssl: *sslprof0
mgtserver:
listen: ${mgtServerIP:0.0.0.0}:${mgtServerPort:8102}
path: ${healthCheckURL:/api/health}
token: ${healthCheckAccessKey}
ssl: *sslprof0
metrics:
path: ${metricsCheckURL:/api/health/metrics}
token: ${metricsAccessKey}
rabbitmq:
url: ${coordinatorUrl:amqp://USER:PASS@disp.termidesk.local:5672/termidesk}
user: ${coordinatorUser:AES256:F406D42BBA34B79A02AF73FFD1713A82}
pass: ${coordinatorPass:AES256:9E0A2FBFE5B03E31C8BC717C437D82E8}
timeout: ${coordinatorTimeout}
refreshtime: ${coordinatorRefreshTime:60}
single: ${coordinatorSingle:true}
exchange: ${coordinatorExchange}
routingkey: ${coordinatorRoutingKey}
loglevel:
info: ${logInfo:true}
debug: ${logDebug:false} |
Чтобы получить преобразованное значение параметра с помощью утилиты gwpasswd, нужно:
- выполнить команду:
sudo gwpasswd -e <значение> |
где:
-e - ключ для запуска преобразования переданной строки;
<значение> - строка, значение которой будет преобразовано;
Существует также второй способ передачи строки на вход утилите
|
- преобразованное значение будет отображено в интерфейсе командной строки. Полученное значение необходимо внести в соответствующий параметр конфигурационного файла с приставкой
AES256:. Значение допускается вносить как в ранее существующий файл/etc/termidesk/termidesk-gateway.conf, так и в/etc/termidesk/gateway.yaml. В приведенном выше примере значение было подставлено в параметр${coordinatorUser}:
rabbitmq:
url: ${coordinatorUrl:amqp://USER:PASS@disp.termidesk.local:5672/termidesk}
user: ${coordinatorUser:AES256:F406D42BBA34B79A02AF73FFD1713A82} |
- выполнить перезагрузку службы:
sudo systemctl restart termidesk-gateway.service |
Параметры, используемые в файле /etc/termidesk/gateway.yaml после установки, приведены в таблице.
Задание параметров может производиться и переменными окружения в формате: ${ENV} или ${ENV:DEFAULT}, где DEFAULT - значение для подстановки, если указанная переменная окружения не найдена.
Если переменная окружения существует с пустым значением, то пустое значение будет подставлено в |
Например, если нужно задать через переменные окружения адрес IP_ADDR и порт прослушивания службы PORT, то в конфигурационном файле /etc/termidesk/ gateway.yaml можно изменить значение следующим образом:
listen: ${IP_ADDR}:${PORT:8000} |
Либо эти значения можно задать напрямую в файле, без использования переменных окружения, тогда запись изменится к виду:
listen: "127.0.0.1:8181" |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Для проверки состояния Шлюза termidesk-gateway через утилиту curl нужно:
- получить значение переменной
HEALTH_CHECK_ACCSESS_KEY, определенной в конфигурационном файле/etc/opt/termidesk-vdi/termidesk.confузла «Универсального диспетчера»; на узле Шлюза отредактировать конфигурационный файл, присвоив параметру
token: ${healthCheckAccessKey}полученное значение, например:
token: ${healthCheckAccessKey:270c1e6a4cd013a3824982458a26ec4dcac17f60f80a74098a62994f775351e2} |
- выполнить команду проверки состояния Шлюза:
curl -v -s -X 'GET' "${HOSTNAME}:8102/api/health" -H 'accept: application/json' -H "Authorization: Token ${healthCheckAccessKey}" --fail -w "\n%{http_code}\n" |
Для получения информации по доступным аргументам командной строки нужно выполнить:
termidesk-gateway --help |