Escalar horizontalmente: clústeres origen + edge
Cuando una máquina no alcanza, sumá nodos. Cómo el origen se auto-registra, los edge se unen y hacen heartbeat, y dónde traza sus líneas el soporte actual de clúster.
Cuando un nodo no alcanza
Un solo servidor StreamHub aguanta mucho — muchas salas concurrentes en una VM de tamaño medio. Pero en algún punto vas a querer repartir carga geográficamente o absorber más publicadores concurrentes de los que una máquina puede. Ahí entra el clustering.
Origen y edge
El modelo es origen + edge:
- El origen es el primer nodo que instalás. Se auto-registra en la tabla global
nodesy posee el registro autoritativo. - Los nodos edge se instalan con un flag de unión. Se registran contra el origen y luego hacen heartbeat cada 60 segundos para que el origen sepa que están vivos.
El instalador soporta ambas formas directamente — una instalación de origen y una instalación con --join — e incluye un timer de heartbeat para que la vitalidad sea automática.
Instalar un nodo edge
curl -fsSL https://www.streamhub.studio/install.sh | sudo bash -s -- \
--join --origin https://media.example.com --token <token-de-union>
El edge baja la misma pila fijada, se registra a sí mismo y arranca el heartbeat. Desde el origen podés ver cada nodo y su última vez visto vía /api/v1/nodes.
Lo que te da el clúster
- Una vista compartida de los nodos y su salud desde el origen.
- La posibilidad de ubicar los servicios de medios más cerca de publicadores o espectadores.
- Un único plano de control — gestionás la flota desde el registro del origen.
Conocé los límites
El clustering es real pero acotado, y es honesto sobre sus límites. Antes de diseñar alrededor de él, leé los dos documentos de operaciones que detallan exactamente qué está cubierto frente a qué es una limitación conocida: la guía de instalación de nodos y el informe de la prueba de dos nodos. Tratá el comportamiento entre nodos como documentado-y-probado en lugar de asumir paridad activa-activa completa — los docs son explícitos sobre qué flujos están probados de punta a punta.
El camino pragmático
Para la mayoría de las cargas, un único origen bien aprovisionado es la respuesta correcta, y el escalado vertical más HLS (que es amigable con CDN y barato de repartir) te lleva bastante lejos. Recurrí a los edge cuando realmente necesites distribución geográfica o capacidad de publicadores más allá de un nodo — y apoyate en los docs de nodos para quedarte dentro del sobre probado.