Начало работы с 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

Подключение пира

Чтобы подключить пир в 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, где должны отображаться данные состояния пира. Убедитесь, что пир подключен.

Overview tab

Создание потока

Создать поток в 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;