update services documentations
This commit is contained in:
Emmanuel Garette
parent
ae8910830c
commit
a1277bbbc7
7 changed files with 98 additions and 66 deletions
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
## Un condition
|
## Un condition
|
||||||
|
|
||||||
Les conditions permettent d'ajouter ou de supprimer des propriétés à une [variable](../variable/README.md), une [famille](../family/README.md), un [service](../service/service.md), un [fichier](../service/file.md) ou une [ip](../service/ip.md) suivant le contexte.
|
Les conditions permettent d'ajouter ou de supprimer des propriétés à une [variable](../variable/README.md), une [famille](../family/README.md), un [service](../service/README.md), un [fichier](../service/file.md) ou une [ip](../service/ip.md) suivant le contexte.
|
||||||
|
|
||||||
Nous allons nous concentrer ici sur la condition hidden_if_in, mais [il existe d'autre conditions](conditions.md).
|
Nous allons nous concentrer ici sur la condition hidden_if_in, mais [il existe d'autre conditions](conditions.md).
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -16,7 +16,7 @@ Il est possible de désactiver une [variable](../variable/README.md) ou une [fam
|
||||||
|
|
||||||
## Caché
|
## Caché
|
||||||
|
|
||||||
Il est possible de cacher une [variable](../variable/README.md), une [famille](../family/README.md), un [service](../service/service.md), un [fichier](../service/file.md) ou une [ip](../service/ip.md) avec les conditions :
|
Il est possible de cacher une [variable](../variable/README.md), une [famille](../family/README.md), un [service](../service/README.md), un [fichier](../service/file.md) ou une [ip](../service/ip.md) avec les conditions :
|
||||||
|
|
||||||
- hidden_if_in
|
- hidden_if_in
|
||||||
- hidden_if_not_in
|
- hidden_if_not_in
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,96 @@
|
||||||
# Les services
|
# La gestion d'un service
|
||||||
|
|
||||||
|
## La base service
|
||||||
|
|
||||||
|
Un service est inclut dans un conteneur [services](../services.md).
|
||||||
|
|
||||||
|
Cette balise permet de définir tous les éléments ([fichier](file.md), [IP](ip.md) et [réécriture](override.md)) liés à un service ou à démon.
|
||||||
|
|
||||||
|
Il faut, à la création du service, préciser son nom :
|
||||||
|
|
||||||
|
```
|
||||||
|
<?xml version='1.0' encoding='UTF-8'?>
|
||||||
|
<rougail>
|
||||||
|
<services>
|
||||||
|
<service name="squid"/>
|
||||||
|
</services>
|
||||||
|
</rougail>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Les types de service
|
||||||
|
|
||||||
|
Les services peuvent être de plusieurs type :
|
||||||
|
|
||||||
|
- service (valeur par défaut) : cela signifie que c'est un service systemd qui est activer au démarrage de la machine
|
||||||
|
- mount : fichier utilisé par systemd-mount
|
||||||
|
- swap : fichier utilisé par systemd-swap
|
||||||
|
|
||||||
|
```
|
||||||
|
<service name="dev-disk-by\x2dpartlabel-swap" type="swap"/>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Les targets de service
|
||||||
|
|
||||||
|
Active le service systemd pour une target systemd déterminé. Par défaut, l'activation du service n'est pas gérer par rougail.
|
||||||
|
|
||||||
|
```
|
||||||
|
<service name="squid" target="multi-user"/>
|
||||||
|
```
|
||||||
|
|
||||||
|
## La génération du fichier service
|
||||||
|
|
||||||
|
Le fichier de description du service peut être fourni directement par la distribution GNU/Linux utilisé, mais il peut également être fournit par l'administrateur.
|
||||||
|
Dans ce cas, il est possible de créé un template, dont le nom est obligatoirement la valeur de la balise "name" + "." + la valeur de la base "type".
|
||||||
|
|
||||||
|
Deux types de template sont aujourd'hui disponible :
|
||||||
|
|
||||||
|
- creole
|
||||||
|
- jinja2
|
||||||
|
|
||||||
|
```
|
||||||
|
<service name="dev-disk-by\x2dpartlabel-swap" type="swap" engine="creole"/>
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans ce cas, rougail utilisera le template "dev-disk-by\x2dpartlabel-swap.swap" pour générer le fichier systemd de gestion de ce service.
|
||||||
|
|
||||||
|
## Le service factice
|
||||||
|
|
||||||
|
Un service peut être factice, donc non géré par le système de service du système :
|
||||||
|
|
||||||
|
```
|
||||||
|
<service name="ldap_client" manage="False"/>
|
||||||
|
```
|
||||||
|
|
||||||
|
Un service factice est généralement une service qui n'existe pas réellement (par exemple si on configure un client). Il n'est là que pour contenir des fichiers.
|
||||||
|
|
||||||
|
## Désactiver le service
|
||||||
|
|
||||||
|
Il est possible de désactiver un service. Pour cela il faut rajouter l'attribut "disabled" à True :
|
||||||
|
|
||||||
|
```
|
||||||
|
<services>
|
||||||
|
<service name="test" disabled="True"/>
|
||||||
|
</services>
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans ce cas, le service et les éléments qu'il compose ([fichier](file.md), [IP](ip.md) et [réécriture](override.md) seront désactivés.
|
||||||
|
|
||||||
|
Il est possible de définir une [condition](../condition/README.md) de type "disabled_if_in" ou "disabled_if_not_in" sur une balise service :
|
||||||
|
|
||||||
|
```
|
||||||
|
<services>
|
||||||
|
<service name="test" servicelist="test">
|
||||||
|
</service>
|
||||||
|
</services>
|
||||||
|
<variables>
|
||||||
|
<variable name="condition" type="boolean"/>
|
||||||
|
</variables>
|
||||||
|
<constraints>
|
||||||
|
<condition name="disabled_if_in" source="condition">
|
||||||
|
<param>False</param>
|
||||||
|
<target type="servicelist">test</target>
|
||||||
|
</condition>
|
||||||
|
</constraints>
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans ce cas, tous les services et les éléments qu'il compose avec un attribut servicelist à "test" seront désactivés si la variable "condition" est False.
|
||||||
|
|
|
||||||
|
|
@ -1,4 +1,4 @@
|
||||||
# Override
|
# Réécriture du service
|
||||||
|
|
||||||
## La balise override
|
## La balise override
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,60 +0,0 @@
|
||||||
# La gestion d'un service
|
|
||||||
|
|
||||||
## La base service
|
|
||||||
|
|
||||||
Un service est inclut dans un conteneur [services](../services.md).
|
|
||||||
|
|
||||||
Cette balise permet de définir tous les éléments ([fichier](file.md), [IP](ip.md), ...) liés à un service ou à démon.
|
|
||||||
|
|
||||||
Il faut, à la création du service, préciser son nom :
|
|
||||||
|
|
||||||
```
|
|
||||||
<?xml version='1.0' encoding='UTF-8'?>
|
|
||||||
<rougail>
|
|
||||||
<services>
|
|
||||||
<service name="squid"/>
|
|
||||||
</services>
|
|
||||||
</rougail>
|
|
||||||
```
|
|
||||||
|
|
||||||
Un service peut ne pas être géré :
|
|
||||||
|
|
||||||
```
|
|
||||||
<service name="squid" manage="True"/>
|
|
||||||
```
|
|
||||||
|
|
||||||
Un service non géré est généralement une service qui n'existe pas réellement (par exemple si on configure un client).
|
|
||||||
|
|
||||||
Un service non géré ne peut conteneur que des fichiers.
|
|
||||||
|
|
||||||
## Désactiver la génération d'un service
|
|
||||||
|
|
||||||
Il est possible de désactiver un service. Pour cela il faut rajouter l'attribut "disabled" à True :
|
|
||||||
|
|
||||||
```
|
|
||||||
<services>
|
|
||||||
<service name="test" disabled="True"/>
|
|
||||||
</services>
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans ce cas, tous les services et les éléments qu'il compose ([fichier](file.md), ...) seront désactivés.
|
|
||||||
|
|
||||||
Il est possible de définir une [condition](../condition/README.md) de type "disabled_if_in" ou "disabled_if_not_in" sur une balise service :
|
|
||||||
|
|
||||||
```
|
|
||||||
<services>
|
|
||||||
<service name="test">
|
|
||||||
</service>
|
|
||||||
</services>
|
|
||||||
<variables>
|
|
||||||
<variable name="condition" type="boolean"/>
|
|
||||||
</variables>
|
|
||||||
<constraints>
|
|
||||||
<condition name="disabled_if_in" source="condition">
|
|
||||||
<param>False</param>
|
|
||||||
<target type="servicelist">test</target>
|
|
||||||
</condition>
|
|
||||||
</constraints>
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans ce cas, tous les services et les éléments qu'il compose ([fichier](file.md), ...) avec un attribut servicelist à "test" seront désactivés si la variable "condition" est False.
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
# Le conteneur des services
|
# Le conteneur des services
|
||||||
|
|
||||||
La balise "services" est le conteneur de l'ensemble des [services](service/service.md).
|
La balise "services" est le conteneur de l'ensemble des [services](service/README.md).
|
||||||
|
|
||||||
Il est placé à la racine du dictionnaire :
|
Il est placé à la racine du dictionnaire :
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@
|
||||||
|
|
||||||
### servicelist
|
### servicelist
|
||||||
|
|
||||||
Une cible peut être de type [service](../service/service.md) :
|
Une cible peut être de type [service](../service/README.md) :
|
||||||
|
|
||||||
```
|
```
|
||||||
<target type="servicelist">example</target>
|
<target type="servicelist">example</target>
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue