split
This commit is contained in:
parent
05c2e68e0d
commit
214de69489
|
|
@ -10,6 +10,12 @@
|
||||||
|
|
||||||
## [Terminologie](./definition.md)
|
## [Terminologie](./definition.md)
|
||||||
|
|
||||||
|
## [Types d'usagers](./user.md)
|
||||||
|
|
||||||
|
## [Types de données](./data.md)
|
||||||
|
|
||||||
|
## [Différents composants]('./components.md)
|
||||||
|
|
||||||
## [Fonctionnement général](./infrastructure.md)
|
## [Fonctionnement général](./infrastructure.md)
|
||||||
|
|
||||||
## [Gestion de configuration](./configuration.md)
|
## [Réseau d'administration](./admin_network.md)
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,23 @@
|
||||||
|
### Réseau d'administration
|
||||||
|
|
||||||
|
#### Le réseau
|
||||||
|
|
||||||
|
Un réseau d'administration est mis en place.
|
||||||
|
|
||||||
|
Les administrateurs doivent être physiquement sur ce réseau pour faire des tâches d'administration sur les machines.
|
||||||
|
|
||||||
|
Ce réseau n'est pas routé.
|
||||||
|
|
||||||
|
Seul les tâches d'adminitration y sont autorisés.
|
||||||
|
|
||||||
|
Tout le traffic sur ce réseau doit être considéré comme illégitime et doit générer une alerte.
|
||||||
|
|
||||||
|
#### L'administration via ce réseau
|
||||||
|
|
||||||
|
- les administrateurs doivent pouvoir se connecter via le réseau d'administration sur les différentes machines
|
||||||
|
- il faut que l'administrateur ait des droits spécifiques sur la machine
|
||||||
|
- les droits utilisateurs sont définit dans les données de configuration
|
||||||
|
- le compte nécessite un mot de passe pour devenir root
|
||||||
|
- les connexions sont valide sans passer par le mécanisme TOFU
|
||||||
|
- le répertoire de connexion est temporaire et créé à la connexion, aucune donnée utilisateur dans ce répertoire ne sera conservé
|
||||||
|
- mode secours : il existe un mode secours où l'administrateur peut se connecter en root via TTY. Ce mode n'est a utilisé qu'en dernier recours et doit être justifié. Une alerte doit être remontée.
|
||||||
|
|
@ -0,0 +1,88 @@
|
||||||
|
### Différents composants
|
||||||
|
|
||||||
|
#### Description de l'infrastructure
|
||||||
|
|
||||||
|
La description de l'infrastructure se fait par les administrateurs suivant les droits.
|
||||||
|
L'infrastructure est décrit via la ligne de commande.
|
||||||
|
|
||||||
|
L'infrastructure se défini avec les objets suivant :
|
||||||
|
|
||||||
|
- le cluster de virtualisation
|
||||||
|
- des noeuds de calculs
|
||||||
|
- des sites
|
||||||
|
- des zones
|
||||||
|
- des services
|
||||||
|
|
||||||
|
#### Génération des données de configuration
|
||||||
|
|
||||||
|
FIXME description de la partie Rougail
|
||||||
|
|
||||||
|
#### Installation du système
|
||||||
|
|
||||||
|
Les données du système sont installés de façon automatique.
|
||||||
|
L'installation se fait en suivant les recettes mis à diposition par les contributeurs.
|
||||||
|
|
||||||
|
Les recettes sont spécifiques à la distribution.
|
||||||
|
|
||||||
|
Le système installé est ensuite mis à disposition dans le disque prévu à cette effet. Ce disque est générique et peut servir pour plusieurs service de même type.
|
||||||
|
|
||||||
|
#### Personnalisation des fichiers de configuration
|
||||||
|
|
||||||
|
Les fichiers de configuration sont générés à partir des recettes fournis par les contributeurs et la configuration défini par l'administrateur.
|
||||||
|
|
||||||
|
L'administrateur prépare la configuration via la ligne de commande.
|
||||||
|
|
||||||
|
L'administrateur peut faire des modèles de serveurs contenant les valeurs par défaut des différents serveurs hérité de ce serveur modèles. Le multi-héritage et l'héritage multiple est possible.
|
||||||
|
|
||||||
|
L'administrateur commence par faire un "brouillon" de configuration qu'il devra valider lorsqu'il sera satisfait.
|
||||||
|
C'est cette configuration qui sera utilisée pour générer les fichiers de configuration.
|
||||||
|
|
||||||
|
Ces fichiers de configuration sont ensuite mis à disposition dans le disque prévu à cette effet.
|
||||||
|
|
||||||
|
#### Approvisionnement et mise à jour des données mutables
|
||||||
|
|
||||||
|
L'approvisionnement et la mise à jour se fait via des procédures prévus dans la recette et dans les fichiers de configuration suivant les besoins du service.
|
||||||
|
|
||||||
|
#### Fournisseur
|
||||||
|
|
||||||
|
FIXME décrire le fonctionnement de factory
|
||||||
|
|
||||||
|
#### Fournisseur d'identité
|
||||||
|
|
||||||
|
#### PKI
|
||||||
|
|
||||||
|
- SSL
|
||||||
|
|
||||||
|
L'ensemble des certificats doivent être signé par une autorité de certification centralisée.
|
||||||
|
|
||||||
|
Il est nécessaire de gérer 2 types d'autorités :
|
||||||
|
|
||||||
|
- une autorité extérieur pour que les services soient valide avec des acteurs hors de la plateforme
|
||||||
|
- une autorité interne
|
||||||
|
|
||||||
|
Aucun certificat généré sur la machine ne doit être utilisé.
|
||||||
|
|
||||||
|
- SSH
|
||||||
|
|
||||||
|
Les clé SSH sont signés par une autorité géré par l'usine d'infrastructure.
|
||||||
|
|
||||||
|
Cette signature :
|
||||||
|
|
||||||
|
- n'a une validité que d'une journée
|
||||||
|
- autorise la connexion au serveur via un compte nominatif
|
||||||
|
|
||||||
|
#### Les secrets
|
||||||
|
|
||||||
|
Différents mots de passe :
|
||||||
|
|
||||||
|
- pour se connecter aux différents machines via root (mode secours)
|
||||||
|
- un mot de passe par administrateur pour se connecté sur une machine
|
||||||
|
- pour se connecter en lecture ou en écriture sur les différents services
|
||||||
|
|
||||||
|
#### Outil de l'administrateur
|
||||||
|
|
||||||
|
L'administrateur peut piloter l'infrastructure via une ligne de commande unique.
|
||||||
|
|
||||||
|
L'utilisateur doit avoir une ouvrir une session d'administration pour avoir accès aux différentes fonctionnalités de la plateforme.
|
||||||
|
|
||||||
|
Les droits d'accès sont validé par la plateforme.
|
||||||
207
configuration.md
207
configuration.md
|
|
@ -1,207 +0,0 @@
|
||||||
## Configuration
|
|
||||||
|
|
||||||
### Types de données
|
|
||||||
|
|
||||||
#### Différents type de données
|
|
||||||
|
|
||||||
Voici les différents types de données :
|
|
||||||
|
|
||||||
- données système : le système d'exploitation mais également les différentes applications et la configuration par défaut. Généralement installés depuis une distribution.
|
|
||||||
- données de configuration : les personnalisations (issue des recettes fait par les contributeurs en suivant les configurations utilisateurs)
|
|
||||||
- données temporaire :
|
|
||||||
- illimité : conservées jusqu'au redémarrage de la machine. Par exemple cache squid, cache base de donnée, ...
|
|
||||||
- limité dans le temps : données temporaires qui seront supprimés au démarrage ou si elles sont perimées. Par exemple : session, copie de fichier avant traitement, ...
|
|
||||||
- la SWAP
|
|
||||||
- données utilisateurs : données produits par l'utilisateur.
|
|
||||||
|
|
||||||
#### Les disques
|
|
||||||
|
|
||||||
|
|
||||||
Il existe trois types de disques :
|
|
||||||
|
|
||||||
- le disque système qui contiendra les données systèmes
|
|
||||||
- le disque de configuration qui comprendra les données de configuration
|
|
||||||
- le disque de données qui comprendra les données temporaires et les données utilisateurs
|
|
||||||
|
|
||||||
Dans ces disques, il peut y avoir des partitions séparées.
|
|
||||||
|
|
||||||
#### La mutabilité des données
|
|
||||||
|
|
||||||
|
|
||||||
Les données système sont immuables.
|
|
||||||
Les données de configuration sont immuables.
|
|
||||||
Les données temporaires sont mutables.
|
|
||||||
Les données utilisateurs sont mutables.
|
|
||||||
|
|
||||||
#### Approvisionnement
|
|
||||||
|
|
||||||
Toutes les données immuables sont approvisionnées, reproductible et non modifiable.
|
|
||||||
Les données mutables peuvent être approvisionnées pour les initialiser.
|
|
||||||
Les répertoires temporaires mutables n'ont pas vocation a être provisionnés.
|
|
||||||
|
|
||||||
Les données mutables peuvent être facilement réinitialisé par l'administrateur et re approvisionnées.
|
|
||||||
|
|
||||||
#### Mise à jour
|
|
||||||
|
|
||||||
- des données systèmes d'une machine physique :
|
|
||||||
- la machine doit passer dans un état mutable pour les données systèmes
|
|
||||||
- la mise à jour système (notamment de la distribution) est effectuée
|
|
||||||
- la machine est redémarré
|
|
||||||
- des données systèmes d'une machine virtuelle :
|
|
||||||
- l'image est regénéré (pas de mise à jour)
|
|
||||||
- mise à disposition
|
|
||||||
- la machine est redémarré
|
|
||||||
- des données immuables de configuration :
|
|
||||||
- regénéré
|
|
||||||
- mise à disposition
|
|
||||||
- la machine est redémarré
|
|
||||||
- des données mutables utilisateurs : peuvent être mise à jour si nécessaire
|
|
||||||
- des données mutables temporaires : ne sont pas mise à jour, elles sont réinitialisés par un redémarrage.
|
|
||||||
|
|
||||||
#### Les recettes
|
|
||||||
|
|
||||||
Il existe deux grandes familles de recette :
|
|
||||||
|
|
||||||
- les recettes pour construire les données systèmes :
|
|
||||||
- pour mettre à disposition un système de base par système d'exploitation et par version
|
|
||||||
- pour installer les paquets spécifiques au service, les fichiers, script a exécuter, ...
|
|
||||||
- les recettes pour construire les données de configuration et approvisionnées les données mutables :
|
|
||||||
- les fichiers de configuration
|
|
||||||
- activation de service, ...
|
|
||||||
- le nécessaire pour faire les différents approvisionnement et mises à jour
|
|
||||||
|
|
||||||
#### Sauvegardes
|
|
||||||
|
|
||||||
Seules les données mutables sont sauvegardées.
|
|
||||||
|
|
||||||
Elles peuvent être sauvegardées :
|
|
||||||
|
|
||||||
- directement
|
|
||||||
- après extraction
|
|
||||||
|
|
||||||
#### Taille
|
|
||||||
|
|
||||||
La taille des disques de données est définit par le contributeur dans une recette et n'est pas modifiable par l'administrateur.
|
|
||||||
|
|
||||||
Seule les partitions mutables sont redimensionnable (il est possible de les augmenter). C'est le contributeur qui décide de les augmenter.
|
|
||||||
|
|
||||||
La taille des données système ne doivent pas dépasser idéalement les 500 Mo.
|
|
||||||
|
|
||||||
### Différents composants
|
|
||||||
|
|
||||||
#### Description de l'infrastructure
|
|
||||||
|
|
||||||
La description de l'infrastructure se fait par les administrateurs suivant les droits.
|
|
||||||
L'infrastructure est décrit via la ligne de commande.
|
|
||||||
|
|
||||||
L'infrastructure se défini avec les objets suivant :
|
|
||||||
|
|
||||||
- le cluster de virtualisation
|
|
||||||
- des noeuds de calculs
|
|
||||||
- des sites
|
|
||||||
- des zones
|
|
||||||
- des services
|
|
||||||
|
|
||||||
#### Génération des données de configuration
|
|
||||||
|
|
||||||
FIXME description de la partie Rougail
|
|
||||||
|
|
||||||
#### Installation du système
|
|
||||||
|
|
||||||
Les données du système sont installés de façon automatique.
|
|
||||||
L'installation se fait en suivant les recettes mis à diposition par les contributeurs.
|
|
||||||
|
|
||||||
Les recettes sont spécifiques à la distribution.
|
|
||||||
|
|
||||||
Le système installé est ensuite mis à disposition dans le disque prévu à cette effet. Ce disque est générique et peut servir pour plusieurs service de même type.
|
|
||||||
|
|
||||||
#### Personnalisation des fichiers de configuration
|
|
||||||
|
|
||||||
Les fichiers de configuration sont générés à partir des recettes fournis par les contributeurs et la configuration défini par l'administrateur.
|
|
||||||
|
|
||||||
L'administrateur prépare la configuration via la ligne de commande.
|
|
||||||
|
|
||||||
L'administrateur peut faire des modèles de serveurs contenant les valeurs par défaut des différents serveurs hérité de ce serveur modèles. Le multi-héritage et l'héritage multiple est possible.
|
|
||||||
|
|
||||||
L'administrateur commence par faire un "brouillon" de configuration qu'il devra valider lorsqu'il sera satisfait.
|
|
||||||
C'est cette configuration qui sera utilisée pour générer les fichiers de configuration.
|
|
||||||
|
|
||||||
Ces fichiers de configuration sont ensuite mis à disposition dans le disque prévu à cette effet.
|
|
||||||
|
|
||||||
#### Approvisionnement et mise à jour des données mutables
|
|
||||||
|
|
||||||
L'approvisionnement et la mise à jour se fait via des procédures prévus dans la recette et dans les fichiers de configuration suivant les besoins du service.
|
|
||||||
|
|
||||||
#### Fournisseur
|
|
||||||
|
|
||||||
FIXME décrire le fonctionnement de factory
|
|
||||||
|
|
||||||
#### Fournisseur d'identité
|
|
||||||
|
|
||||||
#### PKI
|
|
||||||
|
|
||||||
- SSL
|
|
||||||
|
|
||||||
L'ensemble des certificats doivent être signé par une autorité de certification centralisée.
|
|
||||||
|
|
||||||
Il est nécessaire de gérer 2 types d'autorités :
|
|
||||||
|
|
||||||
- une autorité extérieur pour que les services soient valide avec des acteurs hors de la plateforme
|
|
||||||
- une autorité interne
|
|
||||||
|
|
||||||
Aucun certificat généré sur la machine ne doit être utilisé.
|
|
||||||
|
|
||||||
- SSH
|
|
||||||
|
|
||||||
Les clé SSH sont signés par une autorité géré par l'usine d'infrastructure.
|
|
||||||
|
|
||||||
Cette signature :
|
|
||||||
|
|
||||||
- n'a une validité que d'une journée
|
|
||||||
- autorise la connexion au serveur via un compte nominatif
|
|
||||||
|
|
||||||
#### Les secrets
|
|
||||||
|
|
||||||
Différents mots de passe :
|
|
||||||
|
|
||||||
- pour se connecter aux différents machines via root (mode secours)
|
|
||||||
- un mot de passe par administrateur pour se connecté sur une machine
|
|
||||||
- pour se connecter en lecture ou en écriture sur les différents services
|
|
||||||
|
|
||||||
#### Outil de l'administrateur
|
|
||||||
|
|
||||||
L'administrateur peut piloter l'infrastructure via une ligne de commande unique.
|
|
||||||
|
|
||||||
L'utilisateur doit avoir une ouvrir une session d'administration pour avoir accès aux différentes fonctionnalités de la plateforme.
|
|
||||||
|
|
||||||
Les droits d'accès sont validé par la plateforme.
|
|
||||||
|
|
||||||
### Sécurisation de l'infrastructure
|
|
||||||
|
|
||||||
#### Réseau d'administration
|
|
||||||
|
|
||||||
Un réseau d'administration est mis en place.
|
|
||||||
|
|
||||||
Les administrateurs doivent être physiquement sur ce réseau pour faire des tâches d'administration sur les machines.
|
|
||||||
|
|
||||||
Ce réseau n'est pas routable.
|
|
||||||
Seul les tâches d'adminitration y sont autorisés.
|
|
||||||
|
|
||||||
Tout le traffic sur ce réseau doit être considéré comme illégitime et doit générer une alerte.
|
|
||||||
|
|
||||||
#### Connexion sur un interpreteur de commande
|
|
||||||
|
|
||||||
Il y a deux type de connexion sur un interpréteur de commande :
|
|
||||||
|
|
||||||
- automatisée : les connexions se font via SSH avec un compte générique autorisé sur l'ensemble des machines. Ce compte peut devenir root sans mot de passe
|
|
||||||
- manuelle :
|
|
||||||
- il faut que l'utilisateur ait les droits
|
|
||||||
- les droits utilisateurs sont définit dans les données de configuration
|
|
||||||
- la connexion est autorisé via SSH
|
|
||||||
- la connexion est autorisé via TTY
|
|
||||||
- le compte nécessite un mot de passe pour devenir root
|
|
||||||
- les connexions SSH sont valide sans passer par le mécanisme TOFU
|
|
||||||
- le répertoire de connexion est temporaire et créé à la connexion, aucune donnée utilisateur dans ce répertoire ne sera conservé
|
|
||||||
- mode secours : il existe un mode secours où l'utilisateur peut se connecter en root via TTY. Ce mode n'est a utilisé qu'en dernier recours et doit être justifié. Une alerte doit être remontée.
|
|
||||||
|
|
||||||
L'ensemble des connexions se font via le réseau administratif.
|
|
||||||
|
|
@ -0,0 +1,86 @@
|
||||||
|
### Types de données
|
||||||
|
|
||||||
|
#### Différents type de données
|
||||||
|
|
||||||
|
Voici les différents types de données :
|
||||||
|
|
||||||
|
- données système : le système d'exploitation mais également les différentes applications et la configuration par défaut. Généralement installés depuis une distribution.
|
||||||
|
- données de configuration : les personnalisations (issue des recettes faites par les contributeurs en suivant les configurations utilisateurs)
|
||||||
|
- données temporaire :
|
||||||
|
- illimité : conservées jusqu'au redémarrage de la machine. Par exemple cache squid, cache base de donnée, ...
|
||||||
|
- limité dans le temps : données temporaires qui seront supprimés au démarrage ou si elles sont perimées. Par exemple : session, copie de fichier avant traitement, ...
|
||||||
|
- la SWAP
|
||||||
|
- données utilisateurs : données produits par l'utilisateur.
|
||||||
|
|
||||||
|
#### Les disques
|
||||||
|
|
||||||
|
Il existe trois types de disques :
|
||||||
|
|
||||||
|
- le disque système qui contiendra les données systèmes
|
||||||
|
- le disque de configuration qui comprendra les données de configuration personnalisées
|
||||||
|
- le disque de données qui comprendra les données temporaires et les données utilisateurs
|
||||||
|
|
||||||
|
Dans ces disques, il peut y avoir des partitions séparées.
|
||||||
|
|
||||||
|
#### La mutabilité des données
|
||||||
|
|
||||||
|
Les données système sont immuables.
|
||||||
|
Les données de configuration sont immuables.
|
||||||
|
Les données temporaires sont mutables.
|
||||||
|
Les données utilisateurs sont mutables.
|
||||||
|
|
||||||
|
#### Approvisionnement
|
||||||
|
|
||||||
|
Toutes les données immuables sont approvisionnées, reproductible et non modifiable.
|
||||||
|
|
||||||
|
Les données mutables peuvent être approvisionnées pour les initialiser.
|
||||||
|
|
||||||
|
Les répertoires temporaires mutables n'ont pas vocation a être provisionnés.
|
||||||
|
|
||||||
|
Les données mutables peuvent être facilement réinitialisé par l'administrateur et re-approvisionnées.
|
||||||
|
|
||||||
|
#### Mise à jour
|
||||||
|
|
||||||
|
- des données systèmes d'une machine physique :
|
||||||
|
- la machine doit passer dans un état mutable pour les données systèmes
|
||||||
|
- la mise à jour système (notamment de la distribution) est effectuée
|
||||||
|
- la machine est redémarré
|
||||||
|
- des données systèmes d'une machine virtuelle :
|
||||||
|
- l'image est regénéré (pas de mise à jour)
|
||||||
|
- mise à disposition
|
||||||
|
- la machine est redémarré
|
||||||
|
- des données immuables de configuration :
|
||||||
|
- regénéré
|
||||||
|
- mise à disposition
|
||||||
|
- la machine est redémarré
|
||||||
|
- des données mutables utilisateurs : peuvent être mise à jour si nécessaire
|
||||||
|
- des données mutables temporaires : ne sont pas mise à jour, elles sont réinitialisés par un redémarrage.
|
||||||
|
|
||||||
|
#### Les recettes
|
||||||
|
|
||||||
|
Il existe deux grandes familles de recette :
|
||||||
|
|
||||||
|
- les recettes pour construire les données systèmes :
|
||||||
|
- pour mettre à disposition un système de base par système d'exploitation et par version
|
||||||
|
- pour installer les paquets spécifiques au service, les fichiers, script a exécuter, ...
|
||||||
|
- les recettes pour construire les données de configuration et approvisionnées les données mutables :
|
||||||
|
- les fichiers de configuration
|
||||||
|
- activation de service, ...
|
||||||
|
- le nécessaire pour faire les différents approvisionnement et mises à jour
|
||||||
|
|
||||||
|
#### Sauvegardes
|
||||||
|
|
||||||
|
Seules les données mutables sont sauvegardées.
|
||||||
|
|
||||||
|
Elles peuvent être sauvegardées :
|
||||||
|
|
||||||
|
- directement
|
||||||
|
- après extraction
|
||||||
|
|
||||||
|
#### Taille
|
||||||
|
|
||||||
|
La taille des disques de données est définit par le contributeur dans une recette et n'est pas modifiable par l'administrateur.
|
||||||
|
|
||||||
|
Seule les partitions mutables sont redimensionnable (il est possible de les augmenter). C'est le contributeur qui décide de les augmenter.
|
||||||
|
|
||||||
|
La taille des données système ne doivent pas dépasser idéalement les 500 Mo.
|
||||||
15
user.md
15
user.md
|
|
@ -1,25 +1,20 @@
|
||||||
Types d'usagers
|
### Types d'usagers
|
||||||
===============================
|
|
||||||
|
|
||||||
Développeur
|
#### Développeur
|
||||||
-----------------
|
|
||||||
|
|
||||||
Personne qui travail sur le générateur de plate forme
|
Personne qui travail sur le générateur de plate forme
|
||||||
|
|
||||||
Contributeur
|
#### Contributeur
|
||||||
-------------------
|
|
||||||
|
|
||||||
Personne qui réalise les recettes et les mets à disposition.
|
Personne qui réalise les recettes et les mets à disposition.
|
||||||
|
|
||||||
Administrateur
|
#### Administrateur
|
||||||
-------------------
|
|
||||||
|
|
||||||
Personnes qui ont accès à l'ensemble ou une partie des éléments de l'infrastructure
|
Personnes qui ont accès à l'ensemble ou une partie des éléments de l'infrastructure
|
||||||
|
|
||||||
Une gestion des droits permettra de définir ce que l'utilisateur à le droit d'administrer.
|
Une gestion des droits permettra de définir ce que l'utilisateur à le droit d'administrer.
|
||||||
|
|
||||||
Utilisateur
|
#### Utilisateur
|
||||||
--------------
|
|
||||||
|
|
||||||
Usager de l'infrastructure.
|
Usager de l'infrastructure.
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue