Infra/rougail
9
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

documentation + fallback on condition

Browse Source
This commit is contained in:
Emmanuel Garette
2021-02-16 10:22:29 +01:00
parent 0585ab0b11
commit bd299e3d2b
28 changed files with 210 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
doc/service/file.md
View File

@ -112,9 +112,7 @@ Il est possible de définir une [condition](../condition/README.md) de type "dis
</service>
</services>
<variables>
<family name="general">
<variable name="condition" type="boolean"/>
</family>
<variable name="condition" type="boolean"/>
</variables>
<constraints>
<condition name="disabled_if_in" source="condition">

75
doc/service/ip.md
View File

@ -1,15 +1,72 @@
# La gestion d'une IP
## La balise ip
## La balise IP
La gestion des IP se fait dans un conteneur de [service](service.md).
FIXME
La déclaration de l'attribut permet d'associer une IP autorisé à accéder au service.
<!ELEMENT ip (#PCDATA)>
<!ATTLIST ip iplist CDATA #IMPLIED >
<!ATTLIST ip ip_type (NetworkOption|variable) "NetworkOption">
<!ATTLIST ip interface_type (UnicodeOption|variable) "UnicodeOption">
<!ATTLIST ip interface CDATA #REQUIRED>
<!ATTLIST ip netmask_type (NetmaskOption|variable) "NetmaskOption">
<!ATTLIST ip netmask CDATA "255.255.255.255">
Il est nécessaire, au minimum, de spécifier son adresse IP et l'interface :
```
<ip interface="ens3">192.168.0.1</ip>
```
L'IP peut être un variable :
```
<ip interface="ens3" ip_type="variable">variable_ip</ip>
```
## La gestion d'un réseau
L'adresse IP peut être un réseau :
```
<ip interface="ens3" netmask="255.255.255.0">192.168.0.0</ip>
```
Le masque de réseau peut être un variable :
```
<ip interface="ens3" netmask_type="variable" netmask="variable_netmask" ip_type="variable">variable_ip</ip>
```
## L'interface
Il est possible de spécifier le nom de l'interface si on la connait :
```
<ip interface="ens3">192.168.0.1</ip>
```
Mais il est possible de calculer automatiquement cette valeur :
```
<ip interface="auto">192.168.0.1</ip>
```
Dans ce cas l'interface est déduite à partir de la table de routage.
## Désactiver la génération d'une IP
Il est possible de définir une [condition](../condition/README.md) de type "disabled_if_in" ou "disabled_if_not_in" sur une balise IP :
```
<services>
<service name="test">
<ip interface="ens3" iplist="test_ip">192.168.0.1</ip>
</service>
</services>
<variables>
<variable name="condition" type="boolean"/>
</variables>
<constraints>
<condition name="disabled_if_in" source="condition">
<param>False</param>
<target type="iplist">test_ip</target>
</condition>
</constraints>
```
Dans ce cas, tous les IP avec un attribut iplist à "test_ip" seront désactivé si la variable "condition" est False.