mise à jour tronc commun

This commit is contained in:
2022-05-06 12:06:07 +02:00
parent fcdac6c12c
commit 840b914e42
21 changed files with 543 additions and 364 deletions

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 lentê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 dune 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 dune 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 laccè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}
}

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 dune 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 lentê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}
}

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}