vc-server

vc-server #

Сервер приложений SVA

Настраивается через переменные окружения.

Порты #

Контейнер запускает следующие порты:

  • 9103 http для вебсокетов и API

Переменные окружения #

  • LOGLEVEL установка уровня логирования (TRACE, DEBUG, INFO, WARN, ERRROR ), по-умолчанию INFO

Имя основного сайта #

  • VC_SERVER_URL в формате https://main.site.name

Именно этот URL всегда будет использоваться при генерации ссылок клиента и вообще коротких ссылок.

Параметры WebRTC подключений #

  • VC_SERVER_RTCP_SERVERS перечень используем stun и turn северов через запятую, например turn:turnserver.domain.com:19001
  • VC_SERVER_RTCP_SECRET секретный ключ, используемый при генерации данных аутентификации на TURN сервере. ДОЛЖЕН совпадать с заданным в конфигурации TURN сервера
  • VC_SERVER_RTCP_TTL время жизни сгенерированных данных аутентификации в секундах, по-умолчанию 43200 (12 часов). Должно быть достаточным для продолжительности смены Агента.
  • VC_SERVER_RTCP_USERNAME логин пользователя TURN сервера
  • VC_SERVER_RTCP_PASSWORD пароль пользователя TURN сервера
  • Параметры RTCPeerConnection
  • VC_SERVER_RTCP_BUNDLE_POLICY по-умолчанию max-bundle
  • VC_SERVER_RTCP_ICE_TRANSPORT_POLICY по-умолчанию all
  • VC_SERVER_RTCP_MUX_POLICY по-умолчанию negotiate

При одновременно заданных секретном ключе, логине и пароле будет использоваться секретный ключ

Таймеры вызовов #

Таймеры определяют время автоматического завершения вызова, если один из участников не подключился к вызову или отключился из активного вызова. Если таймер истекает, то вызов завершается автоматически.

Все значения в минутах.

  • VC_SERVER_TIMER_AGENT_START (по-умолчанию 10) Время ожидания с момента старта вызова до подключения к вызову Агента
  • VC_SERVER_TIMER_USER_JOIN (по-умолчанию 5) Время ожидания подключения к вызову Клиента с момента успешного подключения к вызову Агента
  • VC_SERVER_TIMER_USER_LEAVE (по-умолчанию 5) Время до автоматического завершения вызова, если вызов был корректно завершен пользователем или Агентом
  • VC_SERVER_TIMER_USER_DISCONNECT (по-умолчанию 5) Время до автоматического завершения вызова, если один из участников “отключился” от вызова.

таймеры VC_SERVER_TIMER_USER_LEAVE и VC_SERVER_TIMER_USER_DISCONNECT автоматически сбрасываются, если пользователь повторно успешно подключился к вызову

Провайдер геокодирования #

Настройка подключений к компонентам платформы #

Примеры compose файлов #

Запуск в докере локально
services:
  vc-server:
    image: cr.repo.altuera.ru/sva/prod/vc-server:${SVA_VERSION}
    restart: unless-stopped
    environment:
      LOGLEVEL: ${LOGLEVEL}
      VC_SERVER_URL: "https://localhost:8011"
Установка SVA на один сервер
services:
  vc-server:
    image: cr.repo.altuera.ru/sva/prod/vc-server:${SVA_VERSION}
    restart: unless-stopped
    environment:
      LOGLEVEL: ${LOGLEVEL}
      VC_SERVER_URL: "https://${FQDN}"
      VC_SERVER_GEO_PROVIDER: "nominatim"
      VC_SERVER_RTCP_SECRET: "secret123"
      VC_SERVER_RTCP_ICE_TRANSPORT_POLICY: "all"
      VC_SERVER_RTCP_SERVERS: >
        turn:${FQDN}:19001        
Установка SVA на несколько серверов
services:
  vc-server:
    image: cr.repo.altuera.ru/sva/prod/vc-server:${SVA_VERSION}
    restart: unless-stopped
    ports:
      - 9103:9103
    environment:
      LOGLEVEL: ${LOGLEVEL}
      VC_SERVER_URL: "https://${PUBLIC_FQDN}"
      VC_SERVER_GEO_PROVIDER: "nominatim"
      VC_SERVER_RTCP_TTL: 86400
      VC_SERVER_RTCP_SECRET: secret123
      VC_SERVER_RTCP_SERVERS: >
        turn:${PUBLIC_FQDN}:19001        
      DB_HOST: ${HOST_DB}
      DB_TLS_USE: true
      DB_CACERT_PATH: /certificates/CA.crt
      DB_USER: dbuser
      DB_PASSWORD: dbpassword
      MQTT_SERVER_HOST: ${HOST_DB}
      MQTT_SERVER_PORT: 8883
      MQTT_TLS_USE: true
      MQTT_CACERT_PATH: /certificates/CA.crt
      MQTT_USER_NAME: mqttuser
      MQTT_PASSWORD: mqttpassword
    volumes:
      - /srv/certificates/CA.crt:/certificates/CA.crt:ro
powered by Altuera