Download PDF
Download page Работа с интерфейсом командной строки ПК СВ "Брест".
Работа с интерфейсом командной строки ПК СВ "Брест"
ПК СВ "Брест" поддерживает набор команд для взаимодействия с ОС:
Переменные окружения
При работе с интерфейсом командной строки ПК СВ используются следующие переменные окружения:
Для того, чтоб задать значение переменном необходимо воспользоваться командой:
Для просмотра значения переменной необходимо воспользоваться командой:
ONE_XMLRPC
— URL-адрес прослушивая XML-RPC запросов. По умолчанию установленhttp://<идентификатор_сервера>:2633/RPC2
;ONE_XMLRPC_TIMEOUT
— время ожидания выполнения XML-RPC запроса (в секундах);ONE_ZMQ
— URL-адрес прослушивания очереди сообщений (ZeroMQ). По умолчанию установлен адресtcp://<идентификатор_сервера>:2101
;ONE_AUTH
— файл, содержащий ключ аутентификации. Если переменная не задана, то по умолчанию будет использоваться файл/.one/one_auth
. Содержание аутентификационного файла должно иметь вид:<имя_пользователя>:<токен>
CODEгде
- <имя_пользователя> — имя пользователя для подключения и исполнения команды;
<токен>
— токен назначенный пользователю в веб-интерфейсе ПК СВ или при выполнении команды:Пример вида файла:oneuser login
brestadmin:c1ed52ce40359fd622947667f3d5c1120d450e569cb60fd14d0915eea349c32a
CODEПосле настройки аутентификационного файла синтаксис команд будет выглядеть следующим образом:
При использовании незащищенного соединения
http://
:onehost list --endpoint http://192.168.70.172:2633/RPC2
- ONE_POOL_PAGE_SIZE — число результатов в ответе API ПК СВ на странице. API ПК СВ поддерживает постраничное отображение результатов запросов (пагинацию). По умолчанию установлено значение 300 результатов на страницу. Для отключения можно установить нечисловое значение (например
disable
); ONE_PAGER
—определяет способ постраничного отображения вывода команд при работе в интерактивной сессии оболочки. По умолчанию используется утилита отображения текстаless
. При необходимость пользователь может назначить другую утилиту отображения текста.Для отключения постраничного отображения необходимо установить значение переменной
--no-pager
. Этот параметр установит в значение переменнойONE_PAGER
командуcat
.ONE_LISTCONF — параметр определяющие вид макета отображения выводов команд. Позволяет пользователю использовать альтернативный макет для отображения выводов. Макеты определены в
/etc/one/cli/onevm.yaml;
Пример стандартного макета при использовании команды
onevm list
:ID USER GROUP NAME STAT UCPU UMEM HOST TIME 20 oneadmin oneadmin tty-20 fail 0 0K localhost 0d 00h32 21 oneadmin oneadmin tty-21 fail 0 0K localhost 0d 00h23 22 oneadmin oneadmin tty-22 runn 0.0 104.7M localhost 0d 00h22
CODEПример пользовательского макета при использовании команды
onevm list
:ID NAME IP STAT UCPU UMEM HOST TIME 20 tty-20 10.3.4.20 fail 0 0K localhost 0d 00h32 21 tty-21 10.3.4.21 fail 0 0K localhost 0d 00h23 22 tty-22 10.3.4.22 runn 0.0 104.7M localhost 0d 00h23
CODEONE_CERT_DIR — дополнительный каталог доверенных сертификатов;
Перед добавлением сертификата необходимо привести его обозначение к виду <хэш_сумма>.0.
Для того, чтобы узнать хэш сумму сертификата можно воспользоваться командой:
openssl x509 -in <обозначение_сертификата> -hash
ONE_DISABLE_SSL_VERIFY — перемененная, которая позволяет отключить проверку SSL-сертификатов, для этого необходимо указать в ней любое значение;
Не рекомендуется использовать переменную
ONE_DISABLE_SSL_VERIFY
на объектах эксплуатации.- ONE_SUNSTONE — URL-адрес, используемый для загрузки приложений. Если эта переменная не определена, то она будет выведена из значения переменной ONE_XMLRPC (путем изменения порта XML-RPC на порт 9869). В случае, если переменная ONE_XMLRPC не определена, то будет использовано значение по умолчанию —
http://<идентификатор_сервера>:9869
; - ONEFLOW_URL — URL-адрес службы OneFlow. Если переменная не определена, то по умолчанию будет использоваться значение
http://<идентификатор_сервера>:2474
; - ONEFLOW_USER — имя пользователя службы OneFlow, если переменная не задана, то будет использоваться имя пользователя из аутентификационного файла, определенного в переменной ONE_AUTH;
- ONEFLOW_PASSWORD — пароль пользователя службы OneFlow, если переменная не задана, то будет использоваться пароль пользователя из аутентификационного файла, определенного в переменной ONE_AUTH.