Установка¶

Agora ставится пакетами из репозитория Flussonic. Пакетов два, и выбор между ними — это выбор роли машины.

agora — коробка целиком: управляющий контур, панель и стример на одной машине. Её ставят первой, и на маленькой установке она единственная.
agora-base — сервер кластера: только стример, без панели и без базы. Его ставят на каждую машину, которую добавляют к контуру.

Пакет agora тянет agora-base за собой: коробка — это тот же сервер плюс то, что делает его контуром.

Как дойти от чистой машины до играющего эфира за один заход, написано на странице Быстрый старт. Здесь — то, что нужно знать про настоящую установку.

Что делает установка коробки¶

Пакет agora при установке:

спрашивает лицензионный ключ и кладёт его в /etc/agora/license.txt;
создаёт роль и базу agora;
генерирует пароль базы и пароль администратора и пишет их в /etc/agora/secrets.env (режим 0600, владелец root);
запускает agora.service, который на первом старте накатывает схему базы.

Пароли не печатаются в терминал — их читают из файла. Обновление и переустановка переиспользуют уже записанные секреты.

Про то, что делать с этими паролями дальше, — Администраторы: статические данные оставляют аварийным входом, а работают под именными учётными записями.

Что делает установка ноды¶

Пакет agora-base спрашивает, чем эта машина будет:

Адрес базы — если машина сама поднимает управляющий контур над готовой базой.
Присоединиться к кластеру — если нет: тогда установка спрашивает адрес контура и join-токен.

Токен берут в панели, в разделе Кластер → Стримеры, кнопкой Разрешить присоединение; окно действует час (см. Стримеры). После установки нода приходит в контур сама и появляется в списке.

Настроенную машину установка не переспрашивает: адрес с токеном пишутся один раз, и обновление пакета не задаёт вопрос повторно.

Где что лежит¶

/etc/agora/ — настройки коробки: файл лицензии и secrets.env.
/var/lib/agora/ — рабочее состояние.
agora.service — юнит systemd; им сервис останавливают и запускают.

Управляющих файлов с настройками кластера здесь нет намеренно: конфигурация — эфиры, шаблоны, зоны, права — живёт в базе управляющего контура и правится в панели. Машина хранит только то, что делает её этой машиной.

Обновление¶

Обновление — обычное apt:

apt update && apt install --only-upgrade agora

На кластере первым обновляют контур, потом ноды. Контур переживает ноды старше себя, обратное не гарантировано.

Обновление не переспрашивает лицензию и не трогает секреты. Схема базы приводится в порядок при первом старте новой версии.

Что нужно от сети¶

Зрителям — доступ к стримерам, а не к контуру: контур решает, куда их отправить, но эфир идёт с сервера.
Нодам — доступ к контуру: без него нода работает, но новых назначений не получает.
Установке — доступ наружу для активации лицензии.