Эксплуатация

Начало работы

Altera устанавливается в систему в виде одного или нескольких бинарных пакетов, которые запускаются как systemd-сервисы. Это описывается на стартовой странице документации в разделе Быстрый старт.

Часть параметров systemd-сервисов можно переопределить через редактирование .service-файлов. Ниже в разделе Конфигурация описаны эти параметры, которые задаются через переменные среды.

Конфигурация

Настройки считываются из окружения; изменения применяются после перезапуска. Основные значения:

ПеременнаяПо умолчаниюСлужбаНазначение
ALTERA_WEB_ENABLEtruealtera-webВключение веб-входа
ALTERA_WEB_LOCALHOST_ONLYtruealtera-webBind на 127.0.0.1 и локальная проверка Origin
ALTERA_WEB_IP0.0.0.0altera-webIPv4 для bind при отключённом localhost-only
ALTERA_WEB_PORT2003altera-webПорт
ALTERA_WEB_TLS_ENABLEfalsealtera-webВстроенный HTTPS/WSS
ALTERA_JWT_TTL86400altera-sessionsСрок Bearer-сессии в секундах
ALTERA_LOGinfoaltera, altera-web, altera-sessionsФильтр tracing
ALTERA_PING_INTERVAL5altera-webИнтервал Ping, секунды
ALTERA_PONG_TIMEOUT10altera-webМаксимальное время без Pong, секунды

Переменную нужно задавать в окружении указанной службы. Для ALTERA_LOG каждая служба использует своё значение независимо от остальных.

Некорректные значения ряда числовых и логических настроек заменяются default. У Ping/Pong нуль также заменяется default. Не следует распространять это правило на все параметры: например, некорректный IP при запуске программы вызовет панику, поэтому нужно задать корректный IPv4. Для heartbeat timeout следует выбирать значение больше интервала Ping.

Unix-сокет создаётся с режимом 0666; это право подключиться к транспортному входу, а не разрешение выполнять backend-действия. Для этого пути политики действуют уже внутри Altera.

Реализованные ограничения

МеханизмЗначение / поведение
Тело /auth/loginДо 16 КиБ
Активные модули на соединениеДо 64
Очередь запросов одного модуля32 ожидающих сообщения
Запись запроса в stdin backendТайм-аут 4 секунды
Неинтерактивная Polkit-проверка10 секунд
Интерактивная авторизация120 секунд
Upload chunkДо 1 МиБ
Весь uploadРазмер задаётся в begin; лимит chunk не равен квоте файла или пользователя
Общий тайм-аут выполнения backendНе установлен; зависший модуль может задержать завершение обмена

Тайм-аут передачи запроса модулю не ограничивает время выполнения самой операции. Поведение при ошибках и разрыве соединения описано в клиентском протоколе.

Удалённый веб-доступ

При ALTERA_WEB_LOCALHOST_ONLY=false включается bind на ALTERA_WEB_IP; текущая функция проверки Origin перестаёт ограничивать его локальными адресами. Запросы без Origin допускаются и в локальном режиме.

Для удалённого доступа нужно организовать HTTPS/WSS, установить сертификат и ключ либо использовать доверенный TLS-прокси. Встроенный режим настраивается через ALTERA_WEB_TLS_ENABLE=true и фиксированные пути со страницы Транспорт, маршруты и размещение файлов. Пример браузерного клиента использует один origin с сервером.

CORS-заголовки в текущей реализации включают Access-Control-Allow-Origin: *. Они обслуживают HTTP API; их нельзя считать заменой проверке Bearer-сессии или самостоятельной защитой WebSocket. E1

Наблюдаемость

Отслеживайте логи запущенной в виде сервиса альтеры через системный журнал:

journalctl -u altera.service -f

Если отладочной информации недостаточно, установите переменную окружения ALTERA_LOG в значение debug для целевой службы. В крайнем случае можно установить уровень лога trace, но тогда вероятно лог будет переполнено большим количеством ненужной информации.

На debug-уровне адаптеры могут выводить содержимое передаваемых запросов. Поэтому диагностические журналы следует считать потенциально чувствительными: в параметрах некоторых модулей могут присутствовать секреты. Это не структурированный аудит с гарантированным скрытием секретов.

Для поиска проблемы полезно разделять этапы: login → проверка Bearer-сессии/Upgrade → запуск CLI → Unix-peer → авторизация → запись в stdin → данные stdout → завершение операции. Последний этап особенно важен при зависшей write-блокировке.

Зависимости окружения

При установке RPM-пакета altera устанавливаются следующие зависимости:

ПакетНазначение
altera-commonОбщие каталоги для модулей и конфигурации Altera
dbusСистемная шина для обращения к Polkit
polkitПроверка разрешений на действия модулей
alterator-sh-functionsShell-помощник для модулей backend3
altera-sh-functionsShell-помощник для модулей backend4
jqОбработка JSON в shell-помощнике backend4; устанавливается как зависимость altera-common

Для веб-входа нужна PAM-конфигурация службы altera. Модули и их политики Polkit устанавливаются отдельно; зависимости конкретного модуля должны быть объявлены в его RPM-пакете. Например, Python-модулю, использующему altera_python_functions.py, нужен пакет altera-python-functions: основная служба не устанавливает его автоматически.

Обычная сборка использует SO_PEERPIDFD, доступный в Linux 6.5 и новее. Для старых ядер сервер и Unix-клиент должны поддерживать протокол идентификации сборки с legacy-unix-peer; подробнее — в разделе «Прямой Unix-клиент».

Источники