84 lines
2.7 KiB
Markdown
84 lines
2.7 KiB
Markdown
# Role : docker_jitsimeet
|
|
|
|
Installation de jitsimeet sur un serveur docker_host sans traefik
|
|
|
|
## Variables
|
|
|
|
Fournir les variables suivantes. Par exemple :
|
|
|
|
```yaml
|
|
# Le fqdn pour accéder à jitsimeet
|
|
docker_jitsimeet_fqdn: jitsimeet.example.com
|
|
# Version de l'image jitsimeet
|
|
docker_jitsimeet_version: stable-7648-4
|
|
# L'emplacement dans lequel se trouvent les volumes de donnees docker pour le service
|
|
docker_jitsimeet_data_dir: /data1
|
|
# Le nom de service souhaité : conditionne le nommage des dossiers et le routage par traefik
|
|
docker_jitsimeet_service_id: jitsimeet
|
|
# Mdp de jicofo ; générer avec `openssl rand -hex 16`
|
|
docker_jitsimeet_jicofo_auth_password: "coller_ici_jicofo_auth_password"
|
|
# Mdp de jvb ; générer avec `openssl rand -hex 16`
|
|
docker_jitsimeet_jvb_auth_password: "coller_ici_jvb_auth_password"
|
|
# Adresse du serveur docker sur lequel écoute le service jvb
|
|
docker_jitsimeet_jvb_host_address: 10.11.12.13
|
|
```
|
|
|
|
## Certificat
|
|
|
|
La gestion d'un certificat est désactivée par défaut.
|
|
Pour l'activer, fournir les variables suivantes :
|
|
```yaml
|
|
docker_jitsimeet_letsencrypt_enabled: true
|
|
docker_jitsimeet_letsencrypt_email: adresse_pour_letsencrypt@example.com
|
|
```
|
|
|
|
## Notes de réunion
|
|
|
|
Pour utiliser un serveur etherpad comme support de notes collectives à la réunion, ajouter les variables suivantes :
|
|
|
|
```yaml
|
|
# Active l'utilisation d'un serveur etherpad
|
|
docker_jitsimeet_etherpad_enabled: true
|
|
# Adresse du serveur sur lequel partager un document par réunion
|
|
docker_jitsimeet_etherpad_public_url: https://pad.libretic.fr
|
|
```
|
|
|
|
## Serveur TURN
|
|
|
|
Pour utiliser un serveur turn, ajouter les variables suivantes :
|
|
|
|
```yaml
|
|
# Active l'utilisation d'un serveur turn
|
|
docker_jitsimeet_turnserver_enabled: true
|
|
# Adresse du serveur turn à utiliser
|
|
docker_jitsimeet_turnserver_fqdn: turn.example.com
|
|
# Secret partagé avec le serveur turn
|
|
docker_jitsimeet_turnserver_credentials: mdp_du_turnserver
|
|
# Port de connexion au serveur turn
|
|
docker_jitsimeet_turnserver_port: 1234
|
|
# Transport à utiliser (tcp ou udp)
|
|
docker_jitsimeet_turnserver_transport: tcp
|
|
```
|
|
|
|
## Métriques
|
|
|
|
Pour activer l'export de métriques par jvb, fournir les variables suivantes :
|
|
|
|
```yaml
|
|
docker_jitsimeet_exporter_enabled: true
|
|
docker_jitsimeet_exporter_port: 9888
|
|
```
|
|
|
|
Jvb peut alors servir les metriques en json sur l'adresse http://jvb:8080/colibri/stats.
|
|
|
|
Une fois les métriques activées, leur collecte peut se faire par prometheus par scrutation de l'adresse du serveur sur le port indiqué.
|
|
|
|
Exemple de job prometheus :
|
|
```yaml
|
|
- job_name: 'jitsi'
|
|
static_configs:
|
|
- targets:
|
|
- adresse_hote_docker:9888
|
|
```
|
|
|
|
Un exemple de tableau de bord grafana utilisable avec les métriques collectées sur prometheus : https://github.com/systemli/prometheus-jitsi-meet-exporter/tree/main/dashboards
|