Configuración de Sapsan¶

Sapsan y central forman un sistema inseparable y se entregan juntos. Sapsan se configura mediante la API de central.

Este manual de Sapsan puede presentar los parámetros de las funciones como fragmentos YAML. Estos fragmentos se pueden enviar mediante la API de central. Describen la configuración de Sapsan; consulte la documentación de la solución elegida para conocer el endpoint y el formato de las solicitudes a la API de central.

A continuación se describen la estructura de la configuración y las reglas para aplicarla.

Consulte la unión de streamers para añadir una máquina al clúster y conocer las ventanas de unión y la autenticación.

Estructura de la configuración¶

listeners:        # puertos en los que escucha el servidor
  http:
    - port: 80
  rtsp:
    - port: 554
  rtmp:
    - port: 1935
  webrtc:
    - port: 5005

streams:          # lista de streams
  - name: cam1
    inputs:
    - rtsp:
        url: rtsp://admin:password@10.0.0.5/stream0
    dvr: {}

dvr:              # almacenamiento compartido del archivo
  root: /storage
  disks:
  - path: d1

auth: {}            # autorización de reproducción y publicación
config_external: {} # gestión externa de la configuración
rproxy: {}          # pasarela Peeklio
api_auth:           # usuario/contraseña del Admin API
  login: admin
  password: secret

Validación¶

Sapsan valida la configuración al cargarla y se niega a arrancar con una que no sea válida:

• los campos desconocidos son un error (protección contra erratas);
• cada entrada de un stream debe contener exactamente un protocolo;
• los puertos no pueden repetirse entre listeners y streams;
• si un stream tiene dvr habilitado, debe existir la sección global dvr.

Recarga en caliente¶

Los cambios de configuración se envían mediante la API de central. A nivel de proceso, Sapsan admite la recarga de sapsan.yaml con SIGHUP sin reiniciarse:

• los streams, la autorización y el DVR se reconfiguran sobre la marcha;
• los listeners solo se vuelven a enlazar cuando cambia un puerto;
• la pasarela rproxy conserva las conexiones de los agentes entre recargas (pero cambiar streampoint_key / endpoint_auth_url exige reiniciar el proceso).