Cadoles/formations
20
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

mise à jour tronc commun

Browse Source
This commit is contained in:
Emmanuel Garette 2022-05-06 12:06:07 +02:00
parent fcdac6c12c
commit 840b914e42
21 changed files with 543 additions and 364 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
slides/modules_EOLE_envole/commun/02-gen_config-pratique.tex Normal file
View File

@ -0,0 +1,21 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Faire un instantané ;
\item Démarrer la machine ;
\item se connecter et changer le mot de passe par défaut :
\begin{itemize}
\item copie du mot de passe par défaut en le sélectionnant,
\item utilisation de \commande{passwd} ;
\end{itemize}
\item noter les informations utiles :
\begin{itemize}
\item Adresse ip de la carte eth0,
\item Passerelle,
\item DNS : DNS de la machine hôte ;
\end{itemize}
\item exécuter la commande "gen\_config" dans un terminal.
\end{itemize}
\end{frame}
}

92
slides/modules_EOLE_envole/commun/02-gen_config.tex
View File

@ -1,93 +1,9 @@
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Nature d’une configuration}
\framesubtitle{L'application gen\_config}
\begin{itemize}
\item des familles regroupant les variables ;
\item des variables typées ;
\item des variables à la source identifiée ;
\item des contraintes affectant les variables.
\item gen\_config n'est qu'un éditeur de fichier config.eol ;
\item peut s'exécuter en ligne de commade ;
\item interface web disponible après instance si autorisé.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Types de variables}
Les variables de la configuration sont typées. Leur saisie est donc validée.
\begin{itemize}
\item nombre ;
\item chaîne de caractères ;
\item nom de domaine ;
\item adresse IP ;
\item \ldots{}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Contraintes}
Les contraintes affectent la valeur des variables, leur association ou leur disponibilité.
\begin{itemize}
\item variables obligatoires ;
\item variables calculées ;
\item variables verrouillées automatiquement ;
\item variables sauvegardées automatiquement ;
\item variables multi-valuées ;
\item variables groupées ;
\item variables avec choix (imposés ou ouverts) ;
\item variables cachées.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Application de configuration du module}
L’outil de configuration du module (\commande{gen\_config}) permet de saisir la configuration du module.
\begin{itemize}
\item accessible après instanciation à l’url https://ip\_server:7000/genconfig/ (si autorisé) ;
\item nécessite une authentification ;
\item barre de menu ;
\item les familles ;
\item la partie centrale.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Les modes de l’application de configuration du module}
Les variable de configuration sont classées en trois catégories qui permettent de filtrer leur affichage pour simplifier la saisie :
\begin{itemize}
\item mode basique ;
\item mode normal ;
\item mode expert.
\end{itemize}
\begin{block}{Mode assistant}
Le mode \emph{assistant} présente les variables obligatoires sur une seule page.
C’est le mode ouvert par défaut lorsqu’aucun fichier de configuration n’est présent.
\end{block}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Les informations de debug}
\begin{block}{Noms de variables et variables cachées}
Le mode \emph{debug} permet d’afficher les noms de variables tels que définis dans les dictionnaires creole ainsi que les variables cachées.
\end{block}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{sauvegarde et chargement de la configuration}
La configuration est composée des valeurs des variables de configuration.
\begin{itemize}
\item possibilité d'importer/exporter un fichier ;
\item page des variables obligatoires non renseignées ;
\item visualisation des différences avant l'enregistrement ;
\item enregistrement dans le fichier "config.eol".
\end{itemize}
\begin{block}{Déverrouiller les variables}<only@2>
Importer une configuration à l’effet secondaire de déverrouiller toutes les variables.
\end{block}
\begin{alertblock}{Contenu du fichier config.eol}<only@3->
Seules les variables dont les valeurs sont modifiées par l’administrateur sont sauvegardées dans un fichier.
\end{alertblock}
\end{frame}

115
slides/modules_EOLE_envole/commun/02-gen_config_1.tex Normal file
View File

@ -0,0 +1,115 @@
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Application de configuration du module}
L’outil de configuration du module (\commande{gen\_config}) permet de saisir la configuration du module.
\begin{itemize}
\item nécessite une authentification ;
\item barre de menu ;
\item les familles ;
\item la partie centrale.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Types de variables}
Les variables de la configuration sont typées. Leur saisie est donc validée.
\begin{itemize}
\item nombre ;
\item chaîne de caractères ;
\item nom de domaine ;
\item adresse IP ;
\item \ldots{}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Contraintes}
Les contraintes affectent la valeur des variables, leur association ou leur disponibilité.
\begin{itemize}
\item variables obligatoires ;
\end{itemize}
\skbfigure[center,width=2cm]{en/genconfig/obligatoire.png}
\begin{itemize}
\item variables calculées ;
\end{itemize}
\skbfigure[center,width=2cm]{en/genconfig/calculee.png}
\begin{itemize}
\item variables nom modifiable ;
\end{itemize}
\skbfigure[center,width=3cm]{en/genconfig/non-modif.png}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Contraintes}
\begin{itemize}
\item variables verrouillées automatiquement ;
\end{itemize}
\skbfigure[center,width=3cm]{en/genconfig/verrouille.png}
\begin{itemize}
\item variables sauvegardées automatiquement ;
\item variables multi-valuées ;
\end{itemize}
\skbfigure[center,width=5cm]{en/genconfig/multi.png}
\begin{itemize}
\item variables groupées ;
\end{itemize}
\skbfigure[center,width=4cm]{en/genconfig/master.png}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Contraintes}
\begin{itemize}
\item variables avec choix (imposés ou ouverts) ;
\end{itemize}
\skbfigure[center,width=4cm]{en/genconfig/choix.png}
\skbfigure[center,width=4cm]{en/genconfig/choix_ouvert.png}
\begin{itemize}
\item variables cachées (afficher en mode debug).
\end{itemize}
\skbfigure[center,width=3cm]{en/genconfig/cache.png}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Les modes de l’application de configuration du module}
Les variable de configuration sont classées en trois catégories qui permettent de filtrer leur affichage pour simplifier la saisie :
\begin{itemize}
\item mode basique ;
\item mode normal ;
\item mode expert.
\end{itemize}
\skbfigure[center,width=4cm]{en/genconfig/mode.png}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Assistant}
Le mode \emph{assistant} présente les variables obligatoires sur une seule page.
C’est le mode ouvert par défaut lorsqu’aucun fichier de configuration n’est présent.
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{sauvegarde et chargement de la configuration}
La configuration est composée des valeurs des variables de configuration.
\begin{itemize}
\item possibilité d'importer/exporter un fichier ;
\item page des variables obligatoires non renseignées ;
\item visualisation des différences avant l'enregistrement ;
\item enregistrement dans le fichier "config.eol".
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Configuration autonome}
\framesubtitle{Avancée}
\begin{block}{Déverrouiller les variables}
Importer une configuration à l’effet secondaire de déverrouiller toutes les variables.
\end{block}
\begin{alertblock}{Contenu du fichier config.eol}
Seules les variables dont les valeurs sont modifiées par l’administrateur sont sauvegardées dans un fichier.
\end{alertblock}
\end{frame}

11
slides/modules_EOLE_envole/commun/administration/ead/connexion-pratique.tex Normal file
View File

@ -0,0 +1,11 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Connexion EAD}
\begin{enumerate}
\item Démarrer un navigateur web sur son poste de travail ;
\item https://nom\_domaine\_server:4200/ ;
\item se connecter à l'EAD.
\end{enumerate}
\end{frame}
}

10
slides/modules_EOLE_envole/commun/administration/ead/fonctions-basiques-pratique.tex Normal file
View File

@ -0,0 +1,10 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Tester les fonctions de base}
\begin{enumerate}
\item lister le matériel ;
\item redémarrer un service.
\end{enumerate}
\end{frame}
}

2
slides/modules_EOLE_envole/commun/nouveautes28.tex
View File

@ -3,7 +3,7 @@
\begin{itemize}
\item Basé sur la distribution Focal Fossa (20.04) ;
\item support jusqu'en 2025 ;
\item peu de changement dans le cœur ;
\item passage à python 3.
\end{itemize}
\end{frame}

8
slides/modules_EOLE_envole/commun/nouveautes29.tex Normal file
View File

@ -0,0 +1,8 @@
\begin{frame}
\frametitle{Nouveautés 2.9}
\begin{itemize}
\item En cours de développement ;
\item basé sur la distribution Jammy Jellyfish (20.04) ;
\item support jusqu'en 2027.
\end{itemize}
\end{frame}

18
slides/modules_EOLE_envole/commun/quatre_phases-pratique.tex
View File

@ -1,24 +1,10 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Changer le mot de passe par défaut :
\begin{itemize}
\item copie du mot de passe par défaut en le sélectionnant ;
\item utilisation de \commande{passwd}.
\end{itemize}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Configurer le serveur via la commande gen\_config ;
\item informations utiles :
\begin{itemize}
\item Adresse ip de la carte eth0 ;
\item Passerelle ;
\item DNS : DNS de la machine hôte ;
\end{itemize}
\item enregistrer la configuration (attention il faut confirmer) ;
\item quitter gen\_config.
\end{itemize}
\end{frame}
}

8
slides/modules_EOLE_envole/commun/reconfigure-pratique.tex
View File

@ -3,9 +3,11 @@
\frametitle{Pratique}
\framesubtitle{Modification de la configuration}
\begin{enumerate}
\item Modifier la valeur de la variable swappiness,
\item sauvegarder la nouvelle configuration,
\item appliquer la nouvelle configuration en lançant la commande \commande{reconfigure}.
\item Démarrer gen\_config ;
\item modifier en mode expert "Système" / "Poids relatif de l'utilisation de la swap par rapport à la mémoire vive" => 10 ;
\item sauvegarder la nouvelle configuration ;
\item appliquer la nouvelle configuration en lançant la commande \commande{reconfigure} ;
\item vérifier l'application de la valeur avec la commande \commande{sysctl vm.swappiness}.
\end{enumerate}
\end{frame}
}

11
slides/modules_EOLE_envole/tronc-commun-1/application-zephir-pratique.tex Normal file
View File

@ -0,0 +1,11 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique : configuration Zéphir du serveur}
\begin{itemize}
\item Création d'un nouvel utilisateur "eole" ;
\item affecter tous les droits à l'utilisateur ;
\item se reconnecter avec ce nouvel utilisateur ;
\item ajouter un nouvel établissement.
\end{itemize}
\end{frame}
}

100
slides/modules_EOLE_envole/tronc-commun-1/application-zephir.tex
View File

@ -20,103 +20,3 @@
\item serveur : un module dans un établissement.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique : configuration Zéphir du serveur}
\begin{itemize}
\item Création d'un nouvel utilisateur "eole" ;
\item affecter tous les droits à l'utilisateur ;
\item se reconnecter avec ce nouvel utilisateur ;
\item ajouter un nouvel établissement.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Enregistrement Zéphir}
\begin{itemize}
\item Processus obligatoire et manuel ;
\item création dans la base + lien sécurisé ;
\item lancer : enregistrement\_zephir :
\begin{itemize}
\item connexion au réseau,
\item connexion à Zéphir,
\item création ou choix du serveur,
\item gestion des configurations :
\begin{itemize}
\item nouveau serveur : "récupérer les fichiers de la variante",
\item serveur configuré en mode autonome : "sauver la configuration actuelle",
\item serveur configuré en mode Zéphir : "utiliser la configuration définie sur Zéphir".
\end{itemize}
\end{itemize}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Enregistrement Zéphir : les contraintes 2.6}
\begin{itemize}
\item L'enregistrement ne fonctionne qu'avec un nom de domaine (pas une IP !) ;
\item il est nécessaire que la clef publique du Zéphir soit validé.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique : l'enregistrement Zéphir}
\begin{itemize}
\item Configure le serveur Scribe :
\begin{itemize}
\item aller dans gen\_config onglet expert "Réseau avancé" ;
\item "Déclarer des noms d'hôtes supplémentaires" : "oui" ;
\item "Adresse IP de l'hôte"
\item "Nom long de l'hôte"
\end{itemize}
\item reconfigurer le serveur ;
\item copier la clef publique : scp root@<ip\_zephir>:/etc/ssl/certs/ca\_local.crt /usr/local/share/ca-certificates/
\item update-ca-certificates
\item enregistrement du serveur sur le Zéphir en remontant la configuration.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique : créer un nouveau serveur}
\begin{itemize}
\item Dans la page de l'établissement, créer un nouveau serveur ;
\item générer la configuration.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Modification de la configuration dans l'application Zéphir}
\begin{itemize}
\item La configuration du serveur peut être renseignée sur Zéphir ;
\item même interface sur que le module ;
\item la configuration n'est pas envoyer immédiatement sur le serveur ;
\item gen\_config sur le serveur peut récupérer les modifications.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Dans la page d'état du serveur "modifier" la configuration du Scribe ;
\item modifier une valeur ;
\item enregistrer la configuration ;
\item sur le serveur Scribe lancer gen\_config et se logger sur le serveur Zéphir.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Sauvegarde Zéphir}
\begin{itemize}
\item sauvegarde de Zéphir : sauvegarde.sh ;
\item restauration du Zéphir : restauration.sh ;
\item emplacement des sauvegardes : /var/lib/zephir\_backups/ (avec la date).
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Lancer une sauvegarde du Zéphir ;
\item restaurer le serveur avec la sauvegarde réalisée.
\end{itemize}
\end{frame}

2
slides/modules_EOLE_envole/tronc-commun-1/application-zephir2.tex
View File

@ -7,6 +7,7 @@
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
@ -19,6 +20,7 @@
\item ajouter la clef à l'utilisateur.
\end{itemize}
\end{frame}
}
\begin{frame}
\frametitle{Groupe de serveurs}

26
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_1-pratique.tex Normal file
View File

@ -0,0 +1,26 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique : l'enregistrement Zéphir}
\begin{itemize}
\item Configure le serveur Scribe :
\begin{itemize}
\item aller dans gen\_config onglet expert "Réseau avancé" ;
\item "Déclarer des noms d'hôtes supplémentaires" : "oui" ;
\item "Adresse IP de l'hôte"
\item "Nom long de l'hôte"
\end{itemize}
\item reconfigurer le serveur ;
\item copier la clef publique : scp root@<ip\_zephir>:/etc/ssl/certs/ca\_local.crt /usr/local/share/ca-certificates/
\item update-ca-certificates
\item enregistrement du serveur sur le Zéphir en remontant la configuration.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique : créer un nouveau serveur}
\begin{itemize}
\item Dans la page de l'établissement, créer un nouveau serveur ;
\item générer la configuration.
\end{itemize}
\end{frame}
}

27
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_1.tex Normal file
View File

@ -0,0 +1,27 @@
\begin{frame}
\frametitle{Enregistrement Zéphir}
\begin{itemize}
\item Processus obligatoire et manuel ;
\item création dans la base + lien sécurisé ;
\item lancer : enregistrement\_zephir :
\begin{itemize}
\item connexion au réseau,
\item connexion à Zéphir,
\item création ou choix du serveur,
\item gestion des configurations :
\begin{itemize}
\item nouveau serveur : "récupérer les fichiers de la variante",
\item serveur configuré en mode autonome : "sauver la configuration actuelle",
\item serveur configuré en mode Zéphir : "utiliser la configuration définie sur Zéphir".
\end{itemize}
\end{itemize}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Enregistrement Zéphir : les contraintes 2.6}
\begin{itemize}
\item L'enregistrement ne fonctionne qu'avec un nom de domaine (pas une IP !) ;
\item il est nécessaire que la clef publique du Zéphir soit validé.
\end{itemize}
\end{frame}

11
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_2-pratique.tex Normal file
View File

@ -0,0 +1,11 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Dans la page d'état du serveur "modifier" la configuration du Scribe ;
\item modifier une valeur ;
\item enregistrer la configuration ;
\item sur le serveur Scribe lancer gen\_config et se logger sur le serveur Zéphir.
\end{itemize}
\end{frame}
}

9
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_2.tex Normal file
View File

@ -0,0 +1,9 @@
\begin{frame}
\frametitle{Modification de la configuration dans l'application Zéphir}
\begin{itemize}
\item La configuration du serveur peut être renseignée sur Zéphir ;
\item même interface sur que le module ;
\item la configuration n'est pas envoyer immédiatement sur le serveur ;
\item gen\_config sur le serveur peut récupérer les modifications.
\end{itemize}
\end{frame}

9
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_3-pratique.tex Normal file
View File

@ -0,0 +1,9 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Lancer une sauvegarde du Zéphir ;
\item restaurer le serveur avec la sauvegarde réalisée.
\end{itemize}
\end{frame}
}

8
slides/modules_EOLE_envole/tronc-commun-1/application-zephir_3.tex Normal file
View File

@ -0,0 +1,8 @@
\begin{frame}
\frametitle{Sauvegarde Zéphir}
\begin{itemize}
\item sauvegarde de Zéphir : sauvegarde.sh ;
\item restauration du Zéphir : restauration.sh ;
\item emplacement des sauvegardes : /var/lib/zephir\_backups/ (avec la date).
\end{itemize}
\end{frame}

113
slides/modules_EOLE_envole/tronc-commun-2/personnalisation-creole-templates-pratique.tex
View File

@ -1,113 +0,0 @@
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Récupérer la valeur de la variable adresse\_ip\_eth0
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\begin{itemize}
\item Modifier la valeur de la variable de vm\_swappiness à 10 ;
\item modifier ubuntu\_update\_mirrors à "eole.ac-dijon.fr inconnu.lan"
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Gérer le service vnstat}
\begin{enumerate}
\item Créer un dictionnaire dans le répertoire /usr/share/eole/creole/dicos/local,
\item ajouter l’entête \mintinline{xml}{<?xml version="1.0" encoding="utf-8"?>},
\item ajouter une balise \emph{creole},
\item ajouter une balise \emph{files} dans la balise \emph{creole},
\item ajouter une balise \emph{service} dans la balise \emph{files},
\item valider avec \commande{CreoleLint},
\item tester le comportement au \commande{reconfigure}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Gérer les accès réseau du service vnstat}
\begin{enumerate}
\item Ajouter au dictionnaire une balise \emph{service\_access} dans la balise \emph{files},
\item appliquer la modification avec \commande{reconfigure},
\item tester la gestion du port avec \commande{iptables-save}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Gérer les accès réseau du service vnstat}
\begin{enumerate}
\item Ajouter au dictionnaire une balise \emph{service\_restriction} dans la balise \emph{files},
\item appliquer la modification avec \commande{reconfigure},
\item tester la gestion du port avec \commande{iptables-save}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Ajouter une variable pour activer vnstat}
\begin{enumerate}
\item Ajouter une balise \emph{variables} dans la balise \emph{creole},
\item ajouter une balise \emph{family} dans la balise \emph{variables},
\item ajouter une balise \emph{variable} dans la balise \emph{family},
\item valider avec \commande{CreoleLint},
\item constater les changements dans \commande{gen\_config}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Rendre variable un paramètre de configuration}
\begin{enumerate}
\item Ajouter une balise \emph{file} dans la balise \emph{files},
\item copier le fichier /etc/vnstat.conf dans /usr/share/eole/creole/distrib,
\item utiliser la variable dans le template /usr/share/eole/creole/distrib/vnstat.conf,
\item générer le fichier avec \commande{CreoleCat -dt vnstat.conf}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Contraindre la valeur d’une variable}
\begin{enumerate}
\item Ajouter une balise \emph{constraints} dans la balise \emph{creole},
\item ajouter une balise \emph{check} dans la balise \emph{constraints},
\item modifier le template pour construire une valeur à partir de la variable,
\item générer le fichier avec \commande{CreoleCat -dt vnstat.conf}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Calculer la valeur d’une variable}
\begin{enumerate}
\item Ajouter deux balises \emph{variable} dans la balise \emph{family vnstat},
\item ajouter une balise \emph{fill} dans la balise \emph{constraints}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Conditionner l’accès aux variables}
\begin{enumerate}
\item Ajouter une balise \emph{condition} dans la balise \emph{constraints},
\item ajouter les balises \emph{target} pour la famille, le fichier et le service,
\item passer la variable \emph{activer\_vnstat} à \emph{non} et valider les désactivations avec \commande{reconfigure}.
\end{enumerate}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Documenter les variables et familles}
\begin{itemize}
\item Ajouter une balise \emph{help} dans la balise {creole},
\item ajouter les balises \emph{variable} dans la balise \emph{help}.
\end{itemize}
\end{frame}
}

304
slides/modules_EOLE_envole/tronc-commun-2/personnalisation-creole-templates.tex
View File

@ -1,37 +1,10 @@
\begin{frame}
\frametitle{Dictionnaire Creole}
\begin{itemize}
\item Un dictionnaire est un fichier XML Creole ;
\item décrit les variables présentes dans l'interface de configuration ;
\item informations utiles pour les services ;
\item les dictionnaires locaux sont dans /usr/share/eole/creole/dicos/local/.
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{CreoleLint}
\begin{itemize}
\item Vérifie la syntaxe du dictionnaire : \commande{CreoleLint -d} ;
\item test la génération d'un template suivant contrainte : \commande{CreoleLint -t nom\_du\_template}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{CreoleCat}
\begin{itemize}
\item Templatise un fichier sans faire de reconfigure (objectif de test) ;
\item \commande{CreoleCat -t nom\_du\_template}
\item \commande{CreoleCat -t nom\_du\_template -o /tmp/template.tmpl}
\item \commande{CreoleCat -s /tmp/nom\_du\_template -o /tmp/template.tmpl}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{CreoleGet}
\framesubtitle{Récupérer la valeur d’une variable}
\begin{itemize}
\item \commande{CreoleGet nom\_variable}
\item \commande{CreoleGet --list}
\item on retrouve le nom des variables dans gen\_config en mode debug
\end{itemize}
\end{frame}
@ -48,33 +21,66 @@
\end{alertblock}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les paquets}
\begin{itemize}
\item Les paquets fonctionnent sur le maitre ou dans un conteneur ;
\item permet d'installer les paquets sans passer par les dépendances de paquet.
\end{itemize}
\frametitle{Pratique}
\begin{itemize}
\item Récupérer la valeur de la variable adresse\_ip\_eth0
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les services}
\frametitle{Pratique}
\begin{itemize}
\item Modifier la valeur de la variable de vm\_swappiness à 12 ;
\item modifier ubuntu\_update\_mirrors à "eole.ac-dijon.fr inconnu.lan"
\end{itemize}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaire Creole}
\begin{itemize}
\item Services fonctionnent sur le maitre ou dans un conteneur ;
\item différentes méthodes : service, upstart (version EOLE inférieur à 2.6) ou apache.
\item Un dictionnaire est un fichier XML Creole ;
\item décrit les variables présentes dans l'interface de configuration ;
\item informations utiles pour les services ;
\item les dictionnaires locaux sont dans /usr/share/eole/creole/dicos/local/.
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Le firewall}
\frametitle{Pratique}
\framesubtitle{Gérer le service vnstat}
\begin{enumerate}
\item Créer le dictionnaire /usr/share/eole/creole/dicos/local/00\_vnstat.xml ;
\item ajouter l’entête \mintinline{xml}{<?xml version="1.0" encoding="utf-8"?>} ;
\item ajouter une balise \emph{creole} ;
% \item ajouter une balise \emph{files} dans la balise \emph{creole} ;
% \item ajouter une balise \emph{service} dans la balise \emph{files} ;
\end{enumerate}
\end{frame}
}
\begin{frame}
\frametitle{CreoleLint}
\begin{itemize}
\item On commence par ouvrir les accès (service\_access) ;
\item on ajoute ensuite les restrictions (service\_restiction).
\item Vérifie la syntaxe du dictionnaire : \commande{CreoleLint -d} ;
\item test la génération d'un template suivant contrainte : \commande{CreoleLint -t nom\_du\_template}
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Tester le dictionnaire}
\begin{enumerate}
\item Valider avec \commande{CreoleLint -d /usr/share/eole/creole/dicos/local/00\_vnstat.xml}.
\end{enumerate}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les familles}
@ -98,6 +104,129 @@
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Ajouter une variable pour activer vnstat}
\begin{enumerate}
\item Ajouter une balise \emph{variables} dans la balise \emph{creole},
\item ajouter une balise \emph{family} dans la balise \emph{variables},
\item ajouter une balise \emph{variable} dans la balise \emph{family},
\item ajouter de l'aide,
\item valider avec \commande{CreoleLint},
\item constater les changements dans \commande{gen\_config}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Ajouter une variable pour activer vnstat}
\begin{verbatim}
<?xml version="1.0" encoding="utf-8"?>
<creole>
<variables>
<family name="services">
<variable name="activer_vnstat" type="oui/non"
description="Activer la gestion statistique">
<value>non</value>
</variable>
</family>
</variables>
<help>
<variable name="activer_vnstat">Activer vnstat</variable>
</help>
</creole>
\end{verbatim}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Ajouter les variables vnstat}
\begin{enumerate}
\item ajouter une variable vnstat\_month\_rotate avec le nombre de rotation par mois ;
\item ajouter une variable vnstat\_interface pour définir sur quelle interface écouter ;
\item valider avec \commande{CreoleLint} ;
\item constater les changements dans \commande{gen\_config}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Ajouter les variables vnstat}
\begin{verbatim}
<family name="statistique">
<variable name="vnstat_month_rotate" type="number"
description="Rotation par mois" mode="expert">
<value>1</value>
</variable>
<variable name="vnstat_interface" type="string"
description="Interface sur laquelle écoute vnstat"
multi="True" mandatory="True"/>
</family>
\end{verbatim}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les paquets}
\begin{itemize}
\item Les paquets fonctionnent sur le maitre ou dans un conteneur ;
\item permet d'installer les paquets sans passer par les dépendances de paquet.
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Installer le paquet}
\begin{enumerate}
\item ajouter l'installation du paquet ;
\item valider avec \commande{CreoleLint}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Installer le paquet}
\begin{verbatim}
<files>
<package>vnstat</package>
</files>
\end{verbatim}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les services}
\begin{itemize}
\item Services fonctionnent sur le maitre ou dans un conteneur ;
\item différentes méthodes : service ou apache.
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Gérer le service}
\begin{enumerate}
\item gérer le service ;
\item valider avec \commande{CreoleLint}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Gérer le service}
\begin{verbatim}
<files>
<service servicelist="vnstat">vnstat</service>
</files>
\end{verbatim}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les fichiers templates}
@ -109,6 +238,34 @@
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Ajouter des contraintes}
\begin{enumerate}
\item ajouter le template ;
\item valider avec \commande{CreoleLint}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Ajouter des contraintes}
\begin{verbatim}
<files>
<file filelist="vnstat" name="/etc/vnstat.conf"/>
</files>
\end{verbatim}
\end{frame}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Copier le fichier de configuration}
\begin{enumerate}
\item Copier le fichier /etc/vnstat.conf dans /usr/share/eole/creole/distrib.
\end{enumerate}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Les contraintes}
@ -124,6 +281,46 @@
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Ajouter des contraintes}
\begin{enumerate}
\item la variable vnstat\_month\_rotate ne peut avoir qu'une valeur entre 0 et 4 ;
\item désactiver la famille, le service et la génération du template si désactivé ;
\item valider avec \commande{CreoleLint},
\item constater les changements dans \commande{gen\_config}.
\end{enumerate}
\end{frame}
\begin{frame}[fragile]
\frametitle{Correction}
\framesubtitle{Ajouter une variable pour activer vnstat}
\begin{verbatim}
<constraints>
<check name="valid_enum" target="vnstat_interface">
<param>['0', '1', '2', '3', '4']</param>
</check>
<condition name="disabled_if_in" source="activer_vnstat">
<param>non</param>
<target type="family">statistique</target>
<target type="servicelist">vnstat</target>
<target type="filelist">vnstat</target>
</condition>
</constraints>
\end{verbatim}
\end{frame}
}
\begin{frame}
\frametitle{Dictionnaires Creole}
\frametitle{Le firewall}
\begin{itemize}
\item On commence par ouvrir les accès (service\_access) ;
\item on ajoute ensuite les restrictions (service\_restiction).
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{Dictionnaires Creole}
\framesubtitle{Redéfinition de variables}
@ -156,3 +353,26 @@
\item nom de variable dans une variable : \begin{semiverbatim}\%set \%\%var='adresse\_ip\_eth0' \%\%getVar(\%\%var)\end{semiverbatim}
\end{itemize}
\end{frame}
\begin{frame}
\frametitle{CreoleCat}
\begin{itemize}
\item Templatise un fichier sans faire de reconfigure (objectif de test) ;
\item \commande{CreoleCat -t nom\_du\_template}
\item \commande{CreoleCat -t nom\_du\_template -o /tmp/template.tmpl}
\item \commande{CreoleCat -s /tmp/nom\_du\_template -o /tmp/template.tmpl}
\end{itemize}
\end{frame}
{\setbeamercolor{background canvas}{bg=TravauxPratiques}
\begin{frame}
\frametitle{Pratique}
\framesubtitle{Modifier le template}
\begin{enumerate}
\item utiliser la variable vnstat\_month\_rotate pour configurer MonthRotate ;
\item utiliser la variable vnstat\_interface pour configurer Interface ;
\item valider avec \commande{CreoleLint} ;
\item constater les changements dans \commande{CreoleCat}.
\end{enumerate}
\end{frame}
}

2
slides/modules_EOLE_envole/tronc-commun-2/personnalisation-creole.tex
View File

@ -62,7 +62,7 @@
\frametitle{Dictionnaire Creole : les services}
\begin{itemize}
\item Services fonctionnent sur le maitre ou dans un conteneur ;
\item différentes méthodes : service, upstart (version EOLE inférieur à 2.6) ou apache.
\item différentes méthodes : service ou apache.
\end{itemize}
\end{frame}