Skip to content

Демонстрационный запуск

В этом документе дается минимальная инструкция по старту инсталяции Agora в простом окружении.

Для запуска вам необходимо:

  1. Иметь компьютер под управлением ОС Linux (или Mac) со свободными портами 9010, 9011
  2. На нём должен быть установлен docker вместе с docker compose
  3. От нас должен быть получен лицензионный ключ

Инструкция описывает следующие шаги:

  1. Инсталяцию Agora Controller с помощью docker compose
  2. Добавление тестового потока
  3. Регистрация локального стримера
  4. Запуск локального стримера
  5. Просмотр тестового потока

Инсталяция Agora Controller

Ниже приводится содержимое файла docker-compose.yml

services:
  controller:
    image: flussonic/agora:${AGORA_VERSION:-latest}
    build: .
    env_file:
      - .env
    environment:
      - DATABASE_URL=mongodb://mongo:27017/agora
      - STATS_DATABASE_URL=mongodb://mongo:27017/agora-stats
    ports:
      - 9010:8080
    depends_on:
      - mongo
    networks:
      - agora-network
  mongo:
    image: mongo:latest
    ports:
      - "27017"
    volumes:
      - mongo-data:/data/db
    networks:
      - agora-network
networks:
  agora-network:
    driver: bridge
volumes:
  mongo-data:
    driver: local

Этот файл надо сохранить локально и запустить:

docker compose up -d

Добавление пользователя

docker compose exec controller /app/create-account -l root -p pass

Теперь вы можете залогиниться в Agora с логин-паролем root и pass

Добавление тестового потока

  1. В разделе «Потоки» создаем новый поток под названием test-stream
  2. В секции настроек входов добавляем новый «Демо»

Регистрация стримера в Agora

Проверьте, что вы можете залогиниться по адресу http://localhost:9010/agora-admin/

Создание зон

Необходимо в разделе зон добавить новую с именем default и CIDR адресом: 0.0.0.0/0

Создание стримера

Необходимо создать стример с именем, например, origin1

Дальше в редактировании надо выставить следующие параметры:

  • API URL: http://localhost:9011. Если вы запускаете на Mac, то адрес будет http://docker.for.mac.localhost:9011 в силу особенностей работы docker под Mac
  • Роль: Origin
  • Зона: default
  • Урл воспроизведения: http://localhost:9011
  • API ключ для конфига: нажмите на иконку генерации
  • Авторизация edit api: нажмите на иконку генерации

Теперь надо стример сохранить, после этого скопировать streamer config external, это значение понадобится дальше

Запуск локального стримера

Запуск локального стримера происходит следующим образом:

mkdir origin1 && docker run -v `pwd`/origin1:/etc/flussonic -e STREAMER_CONFIG_EXTERNAL=http://docker.for.mac.localhost:9010/agora-admin/api/admin-v1/config-external/..... -e LICENSE_KEY="..." -p 9011:9011 flussonic/flussonic

Обратите внимание: в строке выше надо подставить актуальное значение STREAMER_CONFIG_EXTERNAL взятое из настроек стримера и лицензионный ключ, полученный от нас.

При этом если запуск происходит в докере под Mac, то в STREAMER_CONFIG_EXTERNAL надо будет поменять localhost на docker.for.mac.localhost

После запуска надо вернуться в Agora и на странице стримера увидеть, что с него получается телеметрия.

Просмотр тестового потока

Вам нужно зайти по адресу http://localhost:9010/agora/portal?stream=test-stream

Там вы увидите плеер, который можно будет запустить.