LiveKit Ingress (livekit-ingress)

Optionnel, inutile à la téléphonie : importe des flux RTMP et WHIP (encodeurs, OBS, webinaires) dans les salles LiveKit. À n'installer que pour la diffusion ; les appels téléphoniques passent par LiveKit SIP.

Généré depuis catalog/services/livekit-ingress.yaml : ne pas modifier à la main.

Résumé

Version	1.5.0
Usage	installer et configurer
Couche	fonctionnelle (catalogue IA)
Catégorie	Inférence IA
Méthodes d'installation	podman
Connexion externe	non
Réservé au bac à sable	non

Licence

Identifiant SPDX	Apache-2.0
Politique de licence	licence socle (MIT ou Apache-2.0)
Exception de licence	-
Exceptions de licence de ses dépendances	LEX-033 (en attente de la décision du client)
Composant de la plateforme	livekit-ingress

Paquets et artefacts

Un paquet que publie le projet du service (son image, son archive binaire, son paquet Python ou système) porte la licence du service ; un paquet tiers porte la licence écrite sur sa ligne, lue dans les métadonnées officielles du projet amont.

Type	Paquet	Version	Licence	Détails
image de conteneur	docker.io/livekit/ingress	v1.5.0	Apache-2.0	clé d'image ingress, utilisée par ingress, condensé sha256:2e1d3fcf10bfaebddaea74dc8b965410cda6377ed154451361b86ab3a9ee9f99

Les images sont épinglées par étiquette dans le descripteur, et par condensé (digest) quand le descripteur en déclare un (le bundle hors ligne refuse alors une image téléchargée qui ne le porte pas) ; le condensé est enregistré dans le miroir du Manager à l'import du bundle hors ligne, et chaque téléchargement ou chargement est vérifié par rapport à lui.

Systèmes et architectures pris en charge

Méthode	Systèmes d'exploitation	Architectures
podman	famille RHEL (dnf), famille Debian (apt), Arch Linux (pacman)	x86_64, aarch64 (non restreintes par le descripteur)

Systèmes hôtes certifiés : RHEL 8/9/10, Rocky Linux 8/9/10, AlmaLinux 8/9/10, Oracle Linux 8/9, CentOS Stream 9/10, Ubuntu 22.04/24.04, Debian 12, Arch Linux (rolling). Le contrôle préalable des hôtes accepte ces systèmes (une autre version d'une famille connue donne un avertissement, une version en fin de vie est refusée) et les architectures x86_64 et aarch64.

Prérequis

Hôte

• au moins 4 CPU (avertissement, cpu).
• au moins 4096 Mo de mémoire (avertissement, memory).

Réseau et ports

Composant	Nom du port	Port	Ouvert dans le pare-feu de l'hôte
ingress	rtmp	1935/tcp	oui
ingress	whip	8086/tcp	oui
ingress	whip-media	7885/udp	oui
ingress	health	8593/tcp	non
ingress	metrics	6792/tcp	oui

Services et connexions nécessaires

• livekit : livekit.
• redis : redis.

Détail et résolution : voir Dépendances.

Méthodes et modes d'installation

Méthode	Défaut	Ce que la méthode utilise
podman	oui	les images de conteneur du descripteur, exécutées par Podman sous systemd

Composants

Composant	Type	Méthodes d'installation	Ports
Ingress (ingress)	travailleur	podman	1935/tcp, 8086/tcp, 7885/udp, 8593/tcp, 6792/tcp

Instance unique (single) (par défaut)

Une seule instance Ingress.

Ce que le mode déploie :

Composant	Placement
ingress	min 1, max 1

Pool (pool)

Plusieurs instances derrière un répartiteur TCP (RTMP) ou un proxy inverse HTTP (WHIP).

Ce que le mode déploie :

Composant	Placement
ingress	min 2, recommandé 2

Installer ce service

L'assistant d'installation du Navin Manager planifie, valide et exécute l'installation ; il faut la permission services:install sur le cluster.

1. Ouvrez l'assistant. Dans Clusters, choisissez l'action de ligne Installer des services du cluster cible. L'assistant s'ouvre sur sa première étape, Service.

2. Choisissez le service. À l'étape Service, sélectionnez LiveKit Ingress. La carte affiche la licence Apache-2.0 et les dépendances dont l'installation a besoin.

3. Choisissez les hôtes et le mode. À l'étape Hôtes, cochez les hôtes, puis choisissez le Mode : single (par défaut), pool. Chaque mode déploie les composants listés dans Méthodes et modes d'installation.

4. Liez les dépendances. À l'étape Liaisons, choisissez pour chaque dépendance (livekit, redis) Installer avec la plateforme ou Utiliser une connexion existante ; une dépendance facultative peut rester sur Aucune liaison.

5. Configurez. À l'étape Configuration, relisez les paramètres (voir Paramètres de configuration). Les mots de passe laissés vides avec une valeur générée par défaut sont générés et scellés par le Manager.

6. Relisez et installez. À l'étape Installation, le Manager valide le plan et affiche l'ordre d'installation ; quand il indique « Le plan est valide. Prêt pour l'installation. », choisissez Installer. Un mode hautement disponible n'est installé que si ses contrôles HA réussissent.

7. Vérifiez. L'opération se termine quand les contrôles de santé de chaque instance réussissent (voir Contrôles de santé) ; le service apparaît alors en marche dans Services.

Haute disponibilité

Cluster	aucun (none)
Haute disponibilité	redondance (redundancy)
Bascule	répartiteur (load-balancer)
Réplication	aucun (none)
Quorum	aucun (none)
Découverte	registre (registry)
Point d'entrée	répartiteur (load-balancer)
Documentation officielle	https://docs.livekit.io/transport/self-hosting/ingress/
Références	https://github.com/livekit/ingress

Prérequis

Prérequis	Doit être hautement disponible	Modes	Description
redis	oui	pool	Redis hautement disponible partagé avec le serveur LiveKit.

Topologie par mode

Modes	Niveau le plus haut du catalogue	Répartition	Composant du quorum	Domaines de panne	Description
single	autonome (standalone)	unique (single)	-	1	Une instance, sans tolérance aux pannes.
pool	ha (ha)	actif-actif (active-active)	-	2	Plusieurs instances derrière un répartiteur qui vérifie leur point de disponibilité.

Remarques

• Un flux tourne sur une instance : la perte de cette instance coupe le flux, l'encodeur se reconnecte par le répartiteur.

Paramètres de configuration

Réseau

Paramètre	Type	Défaut	Valeurs permises	Obligatoire	Secret	Redémarrage	Description
Port RTMP (rtmp_port)	port	1935	-	non	non	oui	Écouteur RTMP (TLS au répartiteur).
Port WHIP (whip_port)	port	8086	-	non	non	oui	Écouteur HTTP WHIP (TLS au proxy inverse).
Port média WHIP (ice_udp_port)	port	7885	-	non	non	oui	Port UDP unique des médias WHIP (ICE).
Port de santé (health_port)	port	8593	-	non	non	non	Santé (/) et disponibilité (/availability), local à l'hôte.
Port des métriques (metrics_port)	port	6792	-	non	non	non	Port Prometheus.
URL LiveKit (livekit_url)	string	(vide)	-	non	non	non	URL ws:// ou wss:// du serveur LiveKit ; vide : le premier serveur de la liaison livekit.

Dépendances

Pour chaque dépendance active, le Manager prend la première solution parmi : la liaison choisie dans l'assistant ; un service de la même installation qui la fournit ; un service déjà installé dans le cluster ; la seule connexion du type attendu. Sinon, une dépendance facultative reste non liée, et une dépendance obligatoire est ajoutée à l'installation dans son mode par défaut (la colonne ci-dessous nomme le service du catalogue ajouté).

Liaison	Fournie par	Type de connexion	Point d'accès	Facultative	Quand rien n'est lié	Description
livekit	livekit	-	signal	non	livekit est ajouté à l'installation	Serveur LiveKit des salles (son redis_bus doit être activé et ses URL de base Ingress désigner ce service).
redis	redis	redis	redis	non	redis est ajouté à l'installation	Le Redis du serveur LiveKit.

Commandes

Commande	Composant	Cible	Description
Journaux récents (logs)	ingress	hôte choisi	Dernières lignes du journal d'Ingress.

Contrôles de santé

Vivacité (par instance)

Composant	Contrôle	Détails
ingress	HTTP http://127.0.0.1:{{ config.health_port }}/	Attendu 200 ; 60 tentatives ; intervalle 2 s ; délai 3 s

Contrôles préalables

Contrôle	Type	Signification	Sévérité	Composants
cpu	cpu_count {"min": 4}	au moins 4 CPU	avertissement	tous les composants
memory	memory_mb {"min": 4096}	au moins 4096 Mo de mémoire	avertissement	tous les composants

Désinstallation

Chemins supprimés quand les données sont purgées : {{ paths.log }}.

Documentation amont

• Site : https://docs.livekit.io/transport/self-hosting/ingress/
• Sources : https://github.com/livekit/ingress
• Haute disponibilité : https://docs.livekit.io/transport/self-hosting/ingress/
• Haute disponibilité : https://github.com/livekit/ingress