Оркестратор. Настройка

После установки Оркестратора необходимо скорректировать файл конфигурации веб-сервера /etc/apache2/apache2.conf. Для этого следует найти и раскомментировать строку с параметром AstraMode, далее присвоить данному параметру значение off, точно соблюдая отступы и пробелы в файле.

Пример:

# Astra security mode.
#
AstraMode off

После перезапустить веб-сервер командой:

:~$ sudo systemctl restart apache2

При первой установке этот конфигурационный файл отсутствует. Его можно скопировать из шаблона /opt/termidesk/share/termidesk-orchestrator/src/config/orc_config.py.dist, для этого выполнить следующие действия:

• перейти в каталог с конфигурационными файлами:

:~$ cd /opt/termidesk/share/termidesk-orchestrator/src/config

• переключиться на пользователя termidesk:

:~$ sudo -u termidesk bash

• скопировать шаблон в новый файл:

:~$ cp orc_config.py.dist orc_config.py

• выйти из окружения пользователя termidesk:

:~$ exit

Параметры внутри разделов конфигурационного файла /opt/termidesk/share/termidesk-orchestrator/src/config/orc_config.py имеют следующую структуру:

ВНУТРЕННЯЯ_ПЕРЕМЕННАЯ = os.getenv("ПЕРЕМЕННАЯ_ОКРУЖЕНИЯ", "ЗНАЧЕНИЕ_ВВОДИМОЕ_ВРУЧНУЮ")

где:

ПЕРЕМЕННАЯ_ОКРУЖЕНИЯ - наименование переменной окружения, назначенной через команду export. Если переменная в окружении не задана, она добавится с указанным значением;

ЗНАЧЕНИЕ_ВВОДИМОЕ_ВРУЧНУЮ - новое значение переменной.

Пример файла /opt/termidesk/share/termidesk-orchestrator/src/config/orc_config.py:

Список доступных параметров конфигурационного файла приведен в таблице.

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

:~$ cd /opt/termidesk/share/termidesk-orchestrator/src/
:~$ python3 self_check.py

Если во время проверки возникает ошибка, подробную информацию о ней можно найти в файле /tmp/termidesk_self_check_crash.log. Файл журнала перезаписывается при каждом запуске проверок.

Добавить в автоматический запуск службу Оркестратора:

:~$ sudo systemctl enable termidesk-orchestrator.service

Затем запустить службу:

:~$ sudo systemctl start termidesk-orchestrator.service

• получить самоподписанный сертификат для обращения по протоколу HTTPS (опционально);
• получить токен приложения (обязательно).

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

:~$ echo quit | openssl s_client -showcerts -servername orchestrator.test.lan -connect orchestrator.test.lan:443 > /home/user/orchestrator.test.lan.pem

где:

orchestrator.test.lan - имя узла, на котором установлен Оркестратор;

/home/user/orchestrator.test.lan.pem - путь к pem файлу, в который будет сохранен сертификат.

Токен приложения используется для авторизации запросов пользователя и запрашивается на сервере OpenStack через функционал API.

Для выполнения API-запросов следует установить утилиту curl:

:~$ sudo apt install curl

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

:~$ curl -i \
  -H "Content-Type: application/json" \
  -d '
{ "auth": {
    "identity": {
      "methods": ["application_credential"],
      "application_credential": {
        "name": "orchestrator",
        "secret": "orchestrator_secret_key",
        "user": {
          "name": "admin",
          "domain": { "name": "Default" }
        }
      }
    }
  }
}' "http://IP-address/identity/v3/auth/tokens" | grep "X-Subject-Token" | sed -e 's/\r//' -e 's/\n//' 

где:

IP-address - IP-адрес сервера OpenStack.

Вывод команды будет содержать необходимый токен:

X-Subject-Token: gAAAAABjdlObymw<...cuted out...>-pJ2JcKNDI_s_FleOLuZOuyt-r

Полученный токен необходимо разместить в переменную окружения APP_TOKEN и подставлять в заголовок «X-ORC-TOKEN-APP» при каждом запросе к Оркестратору.

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

:~$ export APP_TOKEN="gAAAAABjdlObymw<...cuted out...>-pJ2JcKNDI_s_FleOLuZOuyt-r"

Проверка состояния Оркестратора (health check) выполняется запросом через утилиту curl:

:~$ curl -s -H "X-ORC-TOKEN-APP: $APP_TOKEN" --cacert orchestrator.test.lan.pem https://orchestrator.test.lan/api/draft/orc/health/ | python -m json.tool

где:

orchestrator.test.lan.pem - ранее сохраненный самоподписанный сертификат;

orchestrator.test.lan - имя узла, на котором установлен Оркестратор.

Проверка состояния универсального диспетчера Termidesk через Оркестратор выполняется запросом через утилиту curl:

:~$ curl -s -H "X-ORC-TOKEN-APP: $APP_TOKEN" --cacert orchestrator.test.lan.pem https://orchestrator.test.lan/api/draft/health/ | python -m json.tool

При правильном функционировании запрашиваемого компонента ответ должен содержать:

{
    "data": "ok"
}