Начало работы с Flussonic Central
Эта статья поможет вам начать работу с Flussonic Central.
Вы узнаете:
- Как установить Flussonic Central на свой сервер и запустить его;
- Как подключить пир для работы с Flussonic Central;
- Как добавить поток в Flussonic Central.
Flussonic Central доступен как через пользовательский интерфейс, так и через API.
Установка и запуск Flussonic Central
Warning
Прежде чем перейти к установке Flussonic Central, обновите Flussonic Media Server до последней версии.
Чтобы установить Flussonic Central на выбранный сервер:
1) Выполните следующую команду в терминале:
apt install flussonic-central
2) После успешной установки Flussonic Central откройте файл конфигурации /etc/central/central.conf
. Отредактируйте URI database_url
, указав параметры подключения к вашей базе PostgreSQL вместо значений по умолчанию. Если ваша база требует поддержки SSL, то укажите параметр ssl
в конце строки URI с одним из возможных значений: false
, true
или required
. Например, postgres://central:pass@127.0.0.1/central_dev?ssl=required
. Значения параметров соотносятся со значениями sslmode в libpq следующим образом: false = disable
, true = prefer
, required = require
. По умолчанию ssl=false
.
Если у вас нет базы данных, то создайте её по инструкции ниже.
3) Задайте логин-пароль для UI и API-ключ, раскоментировав строки api_key
и edit_auth
и убрав символ "%" в начале строки. Замените значение API-ключа api_key
со значения по умолчанию (KEY0
) на ваше собственное (выбирается произвольно), а логин и пароль edit_auth
на логин и пароль администратора сервера Flussonic. API-ключ необходим для взаимодействия Flussonic Central с другими серверами Flussonic.
4) Вы также можете указать номер HTTP-порта (http_port
) отличный от используемого по умолчанию. Сохраните изменения и выйдите из редактора.
Warning
В будущем после того, как вы внесете изменения в файл конфигурации, перезапустите Flussonic Central с помощью команды service central restart
, чтобы применить изменения.
5) Запустите сервис Flussonic Central, выполнив в консоли следующую команду:
service central start
6) Откройте веб-интерфейс администратора Flussonic Central по следующей ссылке:
http://FLUSSONIC-IP:PORT_NUMBER/admin
, где:
FLUSSONIC-IP
— это IP-адрес сервера, на котором установлен Flusssonic Central,PORT_NUMBER
— это номер HTTP-порта, указанный вhttp_port
.
7) В открывшемся окне введите логин и пароль сервера Flussonic и нажмите Sign, чтобы войти на сервер:
Вы увидите веб-интерфейс Flussonic Central:
Подключение пира
Чтобы подключить пир в Flussonic Central:
1) Откройте боковое меню слева и перейдите в раздел Streamers.
2) На открывшейся странице Cluster перейдите во вкладку Settings и введите полное доменное имя (имя хоста) пира, который вы хотите подключить, в поле New peer hostname. Затем нажмите Save, чтобы применить настройки.
3) Перейдите в настройки пира, нажав на иконку редактирования.
4) Укажите ключ кластера (cluster_key) в поле Cluster key и нажмите Save, чтобы применить настройки. Тот же ключ кластера должен быть указан в конфигурации пира Flussonic Media Server, который вы подключаете.
5) Добавьте параметр config_external в конфигурацию пира Flussonic Media Server и укажите путь, по которому пир будет обращаться к Flussonic Central:
config_external http://API_KEY@CENTRAL-IP:CENTRAL_PORT/streamer/api/v3/streamers
, где:
API_KEY
— API-ключ, указанный в переменнойapi_key
в файле конфигурации/etc/central/central.conf
Flussonic Central,CENTRAL-IP
— IP-адрес Flussonic Central,CENTRAL_PORT
— номер HTTP-порта (http_port
) Flussonic Central.
6) Вернитесь в веб-интерфейс Flussonic Central, откройте раздел Streamers и перейдите на вкладку Overview, где должны отображаться данные состояния пира. Убедитесь, что пир подключен.
Создание потока
Создать поток в Flussonic Central можно как через пользовательский интерфейс, так и с помощью Flussonic Central API.
Note
После того, как поток создан, он запускается на одном из случайно выбранных пиров, подключенных к Flussonic Central.
Warning
Конфигурация потока, определённая в Flussonic Central, не будет записана в конфигурационном файле Flussonic Media Server, на котором запущен поток. Активный поток будет отображаться только в веб-интерфейсе сервера и будет доступен по API-запросу.
Создание потока через веб-интерфейс
Чтобы создать поток через веб-интерфейс:
1) Перейдите в раздел Media в боковом меню слева.
2) Нажмите на кнопку Add stream и укажите название вашего потока в поле Stream name и источник в поле Source URL. Затем нажмите Create, чтобы применить изменения.
3) Перейдите на вкладку Streams и убедитесь, что ваш поток запущен.
Создание потока с помощью API
Чтобы добавить поток с помощью API, используйте запрос PUT /streams/{name}.
Ниже представлен пример PUT-запроса для создания потока:
curl --request PUT --url http://CENTRAL-IP:CENTRAL_PORT/streamer/api/v3/streams/STREAM_NAME \
--header 'Authorization: Basic YWRtaW46YWRtaW4=' \
--header 'Content-Type: application/json' \
--data '{"name": STREAM_NAME", "inputs": [{"url": "fake://fake"}]}'
Note
Этот запрос можно использовать как для создания потока, так и для изменения его настроек, поэтому имя потока указывается дважды — в пути и в теле запроса. Если в пути и в теле указать разные значения name
, то приоритет имеет тот, что в теле.
Результат выполнения запроса будет следующим:
{"config_on_disk":{"inputs":[{"url":"fake://fake"}],"name":"STREAM_NAME"},"inputs":[{"url":"fake://fake"}],"name":"STREAM_NAME","named_by":"config"}
Создание базы данных PostgreSQL
Чтобы создать базу данных PostgreSQL:
1) Установите PostgreSQL по инструкции на сайте.
2) После успешной установки PostgreSQL создайте пользователя, выполнив следующую команду в терминале:
sudo -u postgres -i createuser -P central
Затем система попросит дважды ввести пароль, который будет у суперпользователя:
Caution
Логин и пароль не должны содержать символов @, ;, #, [, \, /, =, $
Enter password for new role: (придумайте и введите пароль суперпользователя базы данных)
Enter it again: (повторите пароль суперпользователя)
3) Создайте базу данных с суперпользователем-владельцем, которого вы создали на предыдущем шаге:
sudo -u postgres -i createdb -O central -e -E UTF8 -T template0 central_dev
Ответ системы в случае успешного создания базы данных будет следующим:
CREATE DATABASE central_dev OWNER central ENCODING 'UTF8' TEMPLATE template0;