Avertissement |
---|
Cette documentation ne concerne que la version v2.X de Pod et non la version 3.X de Pod. Le module utilisé sera supprimé de Pod dans une future version de Pod v2.8, prévue en avril 2021.. Une solution à cette problématique est en cours de travaux. |
Sommaire |
---|
Contexte et solution apportée
Contexte
Suite à la pandémie de COVID-19, il a été mis en place, à l'université de Montpellier, un système de classe virtuelle Open Source reposant sur Big Blue Button (BBB).
Astuce | ||
---|---|---|
| ||
Le script pod/scripts/bbb-pod-live.php sera mis à jour dans la prochaine version v2.8.2 de Pod. Les modifications réalisées sont les suivantes :
|
Contexte et solution apportée
Contexte
Suite à la pandémie de COVID-19, il a été mis en place, à l'université de Montpellier, un système de classe virtuelle Open Source reposant sur Big Blue Button (BBB).
Pour informations, BigBlueButton (https://bigbluebutton.org/) est un Pour informations, BigBlueButton (https://bigbluebutton.org/) est un outil de classe virtuelle ayant les fonctionnalités suivantes :
...
Avertissement | ||
---|---|---|
| ||
Les informations concernant les modérateurs dans BigBlueButton dépendent du client BBB utilisé : Greenlight ou le plugin mod_bigbluebuttonbn pour Moodle. Le système réalisé n'a été testé qu'avec le plugin mod_bigbluebuttonbn pour Moodle (CASifié, donc les données proviennent de notre annuaire LDAP); cela signifie que les modérateurs sont définis - dans mon cas - sous la forme "Prenom Nom". Il est possible de paramétrer ce format, via le paramètre BBB_USERNAME_FORMAT. A l'heure actuelle, les formats "Prenom Nom" ou "Nom Prenom" peuvent être gérés via ce paramétrage. Ce point est crucial pour que le système fonctionne correctement : une correspondance doit exister sur le "Prenom Nom" ou "Nom Prenom" (selon la configuration BBB_USERNAME_FORMAT) des modérateurs de BigBlueButton et le "Prenom Nom" des utilisateurs dans la base de données de Pod. A priori, cela devrait pouvoir fonctionner avec Greenlight si celui-ci est configuré pour utiliser l'annuaire LDAP de l'établissement et les champs givenName et sn. |
...
bbb-recorder | BigBlueButton-liveStreaming | |
---|---|---|
Exporte un cours BBB en direct live | ||
Enregistre un cours BBB en vidéo | format webm, mp4 | peut enregistré le cours qu'il publie en live au format mkv |
Indépendance vis-à-vis de BigBlueButton | peut-être installé sur n'importe quel serveur | peut-être installé sur n'importe quel serveur |
Contenu de la vidéo finale | audio vidéo partage d'écran chat whiteboard | présentation présentation audio vidéo partage d'écran chat whiteboard |
Possibilité de chat depuis la page de direct avec BBB | ||
Possibilité de faire plusieurs streams sur une même VM | ||
Technologies | NodeJS, xvfb, Chrome, ffmpeg, shell | Docker, python, xvfb, ffmpeg, shell |
Mise à jour régulière | ||
Notion de charge | Le fichier vidéo fait entre 2 et 4Mo par minute, en webm ou mp4 | 1 stream nécessite 4-6 vCPU + 4 Go RAM le fichier vidéo fait ~19Mo par minute, en mkv |
...
Installation et configuration à réaliser sur les serveurs bbb-pod-live
Installation des prérequis de BigBlueButton-liveStreaming
Pour installer les prérequis de BigBlueButton-liveStreaming, il suffit de consulter la documentation officielle du projet : https://github.com/aau-zid/BigBlueButton-liveStreaming
Au final, il suffit d'avoir Docker qui tourne sur cette machine bbb-pod-live.
...
-live
Installation des prérequis de BigBlueButton-liveStreaming
Pour installer les prérequis de BigBlueButton-liveStreaming, il suffit de consulter la documentation officielle du projet : https://github.com/aau-zid/BigBlueButton-liveStreaming
Au final, il suffit d'avoir Docker et Docker-compose qui tournent sur cette machine bbb-pod-live.
Info |
---|
Il n'est pas utile d'installer BigBlueButton-liveStreaming à ce stade. C'est le script PHP qui installera automatiquement BigBlueButton-liveStreaming et qui initialisera sa configuration. |
Installation Docker et Docker-compose sous CentOS 7
Personnellement, sous Cent OS 7, j'ai utilisé les documentations suivantes :
- Installation de Docker sous CentOS 7 : https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-centos-7
- (Au cas où) Installation de Docker sous Scientific Linux 7 : https://medium.com/@Dylan.Wang/how-to-install-docker-ce-on-scientific-linux-7-8-180e161f5947
- Installation de Docker-compose sous CentOS 7 : https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-compose-on-centos-7
- Installer Docker et Docker-compose depuis les dépôts officiels : https://computerz.solutions/centos-docker/
Au final, voici les commandes utilisées.
Installation Docker
Astuce | ||
---|---|---|
| ||
Personnellement, sous Cent OS 7, j'ai utilisé les documentations suivantes : Installation de Docker sous CentOS 7 :#Anciennement Au final, voici les commandes utilisées : sudo yum check-updatecurl -fsSL https://get.docker.com/ | sh sudo systemctl start docker sudo systemctl status docker sudo systemctl enable docker | sh sudo yum install -y yum-utils device-mapper-persistent-data lvm2 sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # Installation de la version 20.10.5 sudo systemctl enable docker && sudo systemctl start docker |
Installation Docker-compose
Astuce | ||
---|---|---|
| ||
sudo curl -L "https://github.com/docker/compose/releases/download/1.2329.21/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose docker-compose --version |
Gestion des droits
Ces droits permettent de pouvoir lancer docker sans sudo et d'éviter l'erreur de type Permission denied.
Astuce | ||
---|---|---|
| ||
chown %USER% /usr/local/bin/docker-compose -R En cas d'erreur type Permission denied :#Si le groupe docker n'existe pas, on peut le créer sudo groupadd docker #Ajout de l'utilisateur à ce groupe sudo usermod -aG docker %USER% #Astuce permettant d'être sûr de ne plus avoir de problèmes de droit sudo chmod 666 /var/run/docker.sock |
Après avoir ajouté le user au groupe docker, ne pas oublier de fermer sa session et de se reconnecter pour que cela soit pris en compte.
Installation Docker et Docker-compose sous Ubuntu 20.04
Astuce | ||
---|---|---|
| ||
Sous Ubuntu 20.04, j'ai utilisé la documentation suivante : https://docs.docker.com/engine/install/ubuntu/ Ce qui donne : sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu \ |
...
Info | ||
---|---|---|
| ||
Ce répertoire bbb-pod-live va contenir les différentes instances de BigBlueButton-liveStreaming, qui peuvent contenir les vidéos enregistrées (lorsque l'enseignant a sélectionné l'enregistrement du direct). Il faut donc prévoir un stockage suffisant (typiquement un minimum de 5Go par instance de BigBlueButton-liveStreaming souhaitée). |
- Vérifier qu'il y ait bien le script bbb-pod-live.php et le fichier docker-compose.default.yml dans ce répertoire, avec les bons droits utilisateurs.
...
Fichier docker-compose.yml
Il est primordial de ne pas modifier le fichier docker-compose.default.yml : il servira de modèle pour les containers bbb-liveStreaming.
Lors de la première exécution, le fichier de référence docker-compose.default.yml va être copié en tant que fichier docker-compose.yml et sera positionné dans chaque répertoire bbb-live-streaming créé :
...
Bloc de code | ||||
---|---|---|---|---|
| ||||
crontab -e */1 * * * * /usr/bin/bash -c 'cd /home/user%USER%/bbb-pod-live/; php -f ./bbb-pod-live.php' |
...
- soit il faut configurer Pod pour être en mode debug (cf. settings_local.py).
Attention : le mode debug ne doit pas être activé dans un environnement de production. - soit modifier directement le script /django_projects/podv2/pod/video/management/commands/bbb.py pour qu'il affiche directement les traitements réalisés (cf. fonction print_if_debug).
...