Configuração do Sapsan¶

O Sapsan e o central formam um sistema inseparável e são fornecidos juntos. O Sapsan é configurado pela API do central.

Este manual do Sapsan pode apresentar os parâmetros das funções como trechos YAML. Esses trechos podem ser enviados pela API do central. Eles descrevem a configuração do Sapsan; consulte a documentação da solução escolhida para obter o endpoint e o formato das solicitações à API do central.

A estrutura da configuração e as regras para aplicá-la são descritas abaixo.

Consulte a adesão de streamers para adicionar uma máquina ao cluster e conhecer as janelas de adesão e a autenticação.

Estrutura da configuração¶

listeners:        # portas em que o servidor escuta
  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:              # armazenamento compartilhado do arquivo
  root: /storage
  disks:
  - path: d1

auth: {}            # autorização de reprodução e publicação
config_external: {} # gestão externa da configuração
rproxy: {}          # gateway Peeklio
api_auth:           # login/senha do Admin API
  login: admin
  password: secret

Validação¶

O Sapsan valida a configuração no carregamento e se recusa a iniciar com uma inválida:

• campos desconhecidos são erro (proteção contra erros de digitação);
• cada entrada de um stream deve conter exatamente um protocolo;
• as portas não podem ser reutilizadas entre listeners e streams;
• se um stream tem dvr habilitado, a seção global dvr deve existir.

Recarga a quente¶

As alterações de configuração são enviadas pela API do central. No nível do processo, o Sapsan permite recarregar sapsan.yaml com SIGHUP sem reiniciar:

• streams, autorização e DVR são reconfigurados na hora;
• os listeners só voltam a se vincular quando uma porta muda;
• o gateway rproxy mantém as conexões dos agentes entre recargas (mas trocar streampoint_key / endpoint_auth_url exige reiniciar o processo).