Эксплуатация
Начало работы
Altera устанавливается в систему в виде одного или нескольких бинарных пакетов, которые запускаются как systemd-сервисы. Это описывается на стартовой странице документации в разделе Быстрый старт.
Часть параметров systemd-сервисов можно переопределить через редактирование .service-файлов. Ниже в разделе Конфигурация описаны эти параметры, которые задаются через переменные среды.
Конфигурация
Настройки считываются из окружения; изменения применяются после перезапуска. Основные значения:
| Переменная | По умолчанию | Служба | Назначение |
|---|---|---|---|
ALTERA_WEB_ENABLE | true | altera-web | Включение веб-входа |
ALTERA_WEB_LOCALHOST_ONLY | true | altera-web | Bind на 127.0.0.1 и локальная проверка Origin |
ALTERA_WEB_IP | 0.0.0.0 | altera-web | IPv4 для bind при отключённом localhost-only |
ALTERA_WEB_PORT | 2003 | altera-web | Порт |
ALTERA_WEB_TLS_ENABLE | false | altera-web | Встроенный HTTPS/WSS |
ALTERA_JWT_TTL | 86400 | altera-sessions | Срок Bearer-сессии в секундах |
ALTERA_LOG | info | altera, altera-web, altera-sessions | Фильтр tracing |
ALTERA_PING_INTERVAL | 5 | altera-web | Интервал Ping, секунды |
ALTERA_PONG_TIMEOUT | 10 | altera-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-functions | Shell-помощник для модулей backend3 |
altera-sh-functions | Shell-помощник для модулей 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-клиент».