ПК СВ "Брест" поддерживает набор команд для взаимодействия с ОС:

Переменные окружения

При работе с интерфейсом командной строки ПК СВ используются следующие переменные окружения:

Для того, чтоб задать значение переменном необходимо воспользоваться командой:

<имя_переменной>="<значение_переменной>"

Для просмотра значения переменной необходимо воспользоваться командой:

export <имя_переменной>

  • 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
    CODE
  • ONE_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.