Événements
Dans OpenVLE, les événements constituent le cadre organisationnel d'un environnement.
Ils regroupent les contenus d'environnement, les groupes d'utilisateurs et les machines virtuelles, et garantissent que les scénarios d'apprentissage ou de formation se déroulent de manière structurée sur les plans temporel, personnel et technique.
Où trouver cette section ?
Navigation :
Via le menu principal : Événements
Également accessible via : Accessible via les liens Utilisateurs, Environnements ou Machines virtuelles
Via le menu principal : Événements
Également accessible via : Accessible via les liens Utilisateurs, Environnements ou Machines virtuelles
Aperçu des fonctionnalités
- Créer, modifier et supprimer des événements
- Attribuer des environnements et des groupes d'utilisateurs
- Démarrer et arrêter des événements (déploiement et décommissionnement)
- Gérer les durées d'exécution et l'arrêt automatique
- Consulter les événements actifs, planifiés et terminés
Aperçu des champs importants
| Nom du champ | Description |
|---|---|
Début (date) | Date de début de l'événement. À partir de ce moment, les ressources attribuées sont disponibles. |
Début (heure) | DeprecatedN'est plus utilisé. |
Description | Champ de texte libre pour expliquer l'objectif ou le contenu de l'événement. Affiché dans les aperçus et les vues détaillées. |
Environnement | Référence à l'environnement attribué. Cet environnement définit les modèles, applications et paramètres réseau à utiliser pour l'événement. |
Fin (date) | Date de fin de l'événement. Si aucune date de fin n'est définie, l'événement se poursuit indéfiniment. Après avoir atteint la date de fin, une période de transition configurable commence (voir **Administration → Configuration**). Ensuite, les machines virtuelles, connexions et ressources associées sont automatiquement supprimées. |
Fin (heure) | DeprecatedN'est plus utilisé. |
Nom | Nom d'affichage de l'événement. Affiché dans les listes, les boîtes de dialogue et les noms de connexion. Après le déploiement, il fait partie du titre de connexion dans Apache Guacamole. |
Nom court | Abréviation de l'événement (4 à 8 caractères). Sont autorisés les lettres minuscules, les chiffres, les tirets bas (_) et les tirets (-). Intégré dans les noms des machines virtuelles créées lors du déploiement. |
Différents statuts d'un événement
Chaque événement dans OpenVLE passe par plusieurs phases de statut au cours de son cycle de vie.
L'aperçu suivant décrit les statuts possibles et leur signification :
| Statut | Description |
|---|---|
| Planifié | Défini automatiquement lors de la création. Un événement au statut Planifié est automatiquement déployé X jours avant la date de début, afin qu'il soit prêt avant le démarrage. Le nombre de jours est configurable dans les paramètres système (Système → Paramètres) et affiché dans la vue détaillée. Une transition manuelle depuis le statut Planifié n'est pas possible. |
| Deploying | L'événement est en cours de déploiement. Pendant ce processus, aucune modification ne peut être apportée et aucun participant ne peut être ajouté ou retiré. La progression actuelle peut être consultée via les tâches assignées à l'événement. Après un déploiement réussi, le statut passe automatiquement à Actif. En cas d'erreur, il passe à Erreur (Déploiement). |
| Actif | L'événement est en cours et toutes les VM et connexions associées sont disponibles. Des modifications (par ex. ajout ou retrait de participants) sont possibles dans ce statut. L'événement reste actif jusqu'à ce que la date de fin soit atteinte (le cas échéant) ou qu'il soit arrêté manuellement. |
| Erreur (Core) | Le déploiement n'a pas pu être lancé car une condition préalable fondamentale n'était pas remplie. Un rapport d'erreur détaillé est affiché dans la vue de l'événement. Depuis ce statut, une nouvelle tentative de déploiement peut être lancée. L'événement passe alors de nouveau au statut Deploying. La suppression est possible. |
| Erreur (Déploiement) | Le déploiement a échoué. Un rapport d'erreur détaillé est affiché dans la vue de l'événement. Depuis ce statut, une nouvelle tentative de déploiement peut être lancée. L'événement passe alors de nouveau au statut Deploying. La suppression n'est pas possible. |
| Erreur (Archivage) | L'archivage a échoué. Un rapport d'erreur détaillé est affiché dans la vue de l'événement. Depuis ce statut, une nouvelle tentative d'archivage peut être lancée. L'événement passe alors de nouveau au statut Archiving. La suppression n'est pas possible. |
| Archiving | Après l'expiration de la date de fin et de la période de transition configurée dans les paramètres système, ou après un arrêt manuel, l'événement passe automatiquement dans ce statut. Pendant le processus d'archivage, toutes les VM et connexions associées sont supprimées. Après un archivage réussi, le statut passe automatiquement à Archivé. En cas d'erreur, il passe à Erreur (Archivage). |
| Archivé | L'archivage a été terminé avec succès. Toutes les ressources ont été supprimées. Les événements dans ce statut ne peuvent plus être démarrés, mais peuvent être supprimés. |
| Inactif | État interne pour les événements désactivés ou arrêtés manuellement. Ce statut survient rarement et sert à des fins administratives. |
| Stopped | État temporaire lorsqu'un événement a été arrêté manuellement. Les VM associées sont dans ce cas éteintes et les connexions désactivées. L'événement peut être réactivé si nécessaire. |
Remarques importantes
- Un événement ne peut être supprimé que dans les statuts Planifié ou Archivé.
- Pendant les statuts Deploying ou Archiving, aucune modification n'est possible.
- Les transitions automatiques (par ex. de Planifié → Deploying → Actif ou Actif → Archiving → Archivé) sont gérées par des processus système et ne peuvent pas être déclenchées manuellement.
- Dans les paramètres système sous Système → Paramètres, le temps de préparation (pré-déploiement) ainsi que la période de transition après la fin peuvent être configurés.
Conseil :
Si une erreur survient de manière répétée dans le statut Deploying ou Archiving, vérifiez les tâches associées.
Vous y trouverez des messages d'erreur détaillés et des journaux concernant la cause.
Aperçu des transitions de statut
Créer un événement
- Ouvrez dans le menu principal la section Événements.
- Cliquez sur Ajouter pour créer un nouvel événement.
- Attribuez un nom et une description.
- Sélectionnez un environnement existant.
- Définissez la date de début et éventuellement la date de fin de l'événement.
- Enregistrez l'événement.
L'événement est alors créé avec le statut « Planifié ». - Ajoutez ensuite des participants.
Relation entre l'événement et les modèles de VM
Lors de la création d'un événement, l'environnement choisi n'est enregistré que comme référence. La relation directe entre l'événement et les modèles de VM n'est créée que lors du déploiement. Si l'environnement est modifié entre la création et le déploiement, l'événement utilisera la version actuelle de l'environnement lors du déploiement.
Modifier un événement
- Ouvrez dans le menu principal la section Événements.
- Recherchez l'événement souhaité dans la liste.
- Cliquez sur Modifier, ou ouvrez le menu contextuel de l'événement et sélectionnez Modifier.
- Le formulaire affiche toutes les données actuelles de l'événement.
- Ajustez les champs souhaités, par exemple Nom, Description ou Environnement.
- Enregistrez les modifications.
attention
Seuls les événements au statut « Planifié » peuvent être modifiés.
Les modifications du Nom, de la Description ou de l'environnement attribué ne sont plus possibles dans les autres statuts.
Déployer un événement
- Ouvrez dans le menu principal la section Événements.
- Recherchez l'événement souhaité dans la liste.
- Cliquez sur Déployer, ou ouvrez le menu contextuel de l'événement et sélectionnez Déployer.
- Le formulaire affiche toutes les données actuelles de l'événement.
- Confirmez le déploiement dans la boîte de dialogue affichée.
- L'événement passe au statut « Deploying » ; les machines virtuelles et les connexions sont créées.
Le créateur de l'événement est notifié par e-mail de la progression.
attention
Seuls les événements au statut « Planifié » peuvent être déployés.
remarque
Pendant le statut « Deploying », aucune modification de l'événement n'est possible.
Après un achèvement réussi, le statut passe à « Actif ».
Terminer un événement (archivage)
- Ouvrez dans le menu principal la section Événements.
- Recherchez l'événement souhaité dans la liste.
- Cliquez sur Arrêter, ou ouvrez le menu contextuel de l'événement et sélectionnez Arrêter.
- Le formulaire affiche toutes les données actuelles de l'événement.
- Confirmez l'arrêt dans la boîte de dialogue affichée.
- L'événement passe au statut « Archiving » ; les machines virtuelles et les connexions sont supprimées.
Le créateur de l'événement est notifié par e-mail de la progression.
attention
Seuls les événements au statut « Actif » peuvent être terminés.
remarque
Pendant le statut « Archiving », aucune modification de l'événement n'est possible.
Après un achèvement réussi, le statut passe à « Archivé ».
Actions en masse
Pour les événements actifs, des actions en masse sont disponibles pour effectuer des opérations groupées sur toutes les VM ou connexions d'un événement simultanément.
- Ouvrez dans le menu principal la section Événements.
- Recherchez dans la liste l'événement souhaité au statut « Actif ».
- Ouvrez la vue détaillée de l'événement.
- Cliquez sur le bouton Actions et sélectionnez l'action en masse souhaitée.
- Confirmez l'action dans la boîte de dialogue affichée.
- L'action est appliquée simultanément à toutes les VM ou connexions concernées de l'événement.
attention
Seuls les événements au statut « Actif » prennent en charge les actions en masse.
Actions sur les VM
Les actions suivantes peuvent être appliquées simultanément à toutes les machines virtuelles d'un événement :
- Démarrer toutes les VM -- Démarre l'ensemble des VM de l'événement
- Arrêter toutes les VM -- Arrête immédiatement l'ensemble des VM (arrêt forcé)
- Éteindre toutes les VM -- Éteint proprement l'ensemble des VM via le Guest Agent
- Redémarrer toutes les VM -- Redémarre l'ensemble des VM
- Réinitialiser toutes les VM -- Effectue un redémarrage forcé de toutes les VM
Actions sur les connexions
Les actions suivantes peuvent être appliquées simultanément à toutes les connexions d'un événement :
- Créer toutes les connexions -- Recrée toutes les connexions de l'événement
- Supprimer toutes les connexions -- Supprime l'ensemble des connexions de l'événement
Supprimer un événement
- Ouvrez dans le menu principal la section Événements.
- Recherchez l'événement souhaité dans la liste.
- Cliquez sur Supprimer, ou ouvrez le menu contextuel de l'événement et sélectionnez Supprimer.
- Confirmez la suppression dans la boîte de dialogue affichée.
- L'événement est alors définitivement supprimé.
attention
Seuls les événements au statut « Planifié » ou « Archivé » peuvent être supprimés.
Exemple ou cas d'utilisation
Exemple : Mettre à disposition un nouvel événement de formation
Une administratrice souhaite mettre à disposition une formation avec un environnement. Elle crée dans la section Événements l'entrée « Linux Fondamentaux -- Cours d'automne », définit les dates de début et de fin et sélectionne l'environnement Débutants et avancés. Après l'enregistrement, elle ajoute tous les participants et lance le déploiement. Toutes les machines virtuelles et connexions associées sont alors automatiquement créées et configurées.
Remarques / Particularités
- Un événement contient exactement un environnement, mais celui-ci peut référencer plusieurs modèles de VM.
- Les modifications apportées à l'environnement attribué (par ex. ajout ou retrait de modèles de VM) affectent les événements planifiés, car la relation directe entre l'événement et les modèles de VM n'est créée que lors du déploiement. Les événements actifs ne sont pas affectés.
- Lors du déploiement, des machines virtuelles sont créées et configurées pour chaque participant sur la base des modèles de VM attribués à l'environnement.
De plus, chaque participant reçoit des connexions individuelles basées sur les modèles de connexion attribués aux modèles de VM respectifs.
Les participants ayant le rôle Enseignant reçoivent en outre des connexions vers toutes les machines virtuelles de l'événement. - Via le bouton Arrêter, toutes les VM de l'événement peuvent être arrêtées et supprimées.
- Le créateur d'un événement reçoit automatiquement des permissions d'accès complet sur toutes les machines virtuelles et connexions créées.
- Les participants reçoivent automatiquement la permission « Lecture et contrôle de VM » sur leur propre machine virtuelle.
- Les modifications apportées à un événement en cours (par ex. ajout ou retrait de participants) prennent effet immédiatement.
- Les événements avec un déploiement actif ne peuvent être terminés que par des utilisateurs disposant de la permission (
events_actions_end). - Le démarrage ou l'arrêt d'un événement peut prendre un certain temps en fonction du nombre de VM.
Le créateur reçoit automatiquement une notification par e-mail dès que le déploiement ou l'arrêt/archivage est terminé ou qu'une erreur est survenue. - L'affichage se rafraîchit régulièrement tant que la section est ouverte.
Relations avec d'autres objets
De nombreux objets dans OpenVLE sont liés à d'autres éléments du système. L'aperçu suivant montre quelles relations existent et si elles déclenchent certaines automatisations.
| Objet | Description | Comportement automatique |
|---|---|---|
| Changelogs | Toutes les modifications de l'objet sont automatiquement enregistrées. | Suppression automatique lors de la suppression de l'objet. |
| Connexions | Un nombre illimité de connexions peut être attribué à un événement. | Lors de la terminaison de l'événement, toutes les connexions associées sont automatiquement supprimées. |
| E-mails | Un nombre illimité d'e-mails envoyés peut être attribué à un événement. | Aucune automatisation. |
| Environnements | Exactement un environnement est attribué à chaque événement. | Aucune automatisation. |
| Machines virtuelles (VM) | Un nombre illimité de VM peut être attribué à un événement. | Lors de la terminaison de l'événement, toutes les VM associées sont automatiquement supprimées. |
| Modèles de VM | Un nombre illimité de modèles de VM peut être associé à un événement. | Aucune automatisation. |
| Participants (Utilisateurs) | Un nombre illimité de participants peut être assigné à un événement. | Aucune automatisation. |
| Permissions | Les permissions spécifiques à l'objet peuvent être attribuées directement à l'objet. | Suppression automatique lors de la suppression de l'objet. |
| Tags | Les objets peuvent être marqués avec un nombre quelconque de tags pour les catégoriser ou les filtrer. | Suppression automatique lors de la suppression de l'objet. |
| Tasks | Tâches internes au système, automatiquement créées et surveillées lors d'actions (par ex. démarrage, arrêt ou clonage). | Création automatique pour certains processus ou actions. |
Permissions requises
Les permissions requises pour les actions peuvent être attribuées via des rôles ou individuellement. Si certains droits vous manquent, les fonctions correspondantes dans l'interface utilisateur sont masquées ou désactivées.
| Action | Permission requise | Chemin | Informations supplémentaires |
|---|---|---|---|
| Afficher les événements | events_read | / ou /<objectID> | |
| Créer des événements | events_create | / | |
| Modifier des événements | events_update | / ou /<objectID> | |
| Supprimer des événements | events_delete | / ou /<objectID> | |
| Démarrer des événements | events_actions_start | / ou /<objectID> | |
| Terminer des événements | events_actions_end | / ou /<objectID> | |
| Afficher les utilisateurs | users_read | / ou /<objectID> | |
| Afficher les environnements | courses_read | / ou /<objectID> |
info
Les permissions *_read, *_update et *_delete peuvent être définies sur un chemin spécifique, c'est-à-dire sur l'UUID d'un objet.
Exemple :
Si le chemin / est utilisé, la permission s'applique globalement à tous les objets de ce type.
Pour les permissions *_create, seul le chemin global / est autorisé.
Exemple :
/4a3bc312-d1af-4b3f-b222-f5e9cecbf007 – L'utilisateur n'a alors accès qu'à cet unique objet.Si le chemin / est utilisé, la permission s'applique globalement à tous les objets de ce type.
Pour les permissions *_create, seul le chemin global / est autorisé.