Fusion de 'Guide de déploiement de nœud. Ajout jargon sur «nœud» (copie de #7)' (#8) depuis vincent-main vers main

Étudié sur: https://git.deuxfleurs.fr/Deuxfleurs/guide.deuxfleurs.fr/pulls/8

5 files changed, 177 insertions, 14 deletions

diff --git a/content/operations/_index.md b/content/operations/_index.md
index e0c38ae..7ab49f2 100644
--- a/content/operations/_index.md
+++ b/content/operations/_index.md
@@ -9,7 +9,9 @@ Ce manuel recense notre savoir-faire technique, il a pour but d'accompagner nos
 
 # Notre jargon
 
-* _Une grappe_, c'est **un ensemble d'ordinateurs** qui **coopèrent** pour fournir un **service**.
+* _Un nœud_, c'est un **ordinateur** configuré pour fournir un **service** en collaborant avec d'autres.
+
+* _Une grappe_, c'est **un ensemble de nœuds** qui **coopèrent** pour fournir un **service**.
 
 	Une grappe est **gérée de façon cohérente** (avec le même système logiciel), **plus ou moins autonome** (elle ne dépend pas du reste du monde pour fournir des services web), **par une entité définie** (une personne physique ou un groupe de personnes).
   
diff --git a/content/operations/deploiement/noeud/SSH_sans_écran.md b/content/operations/deploiement/noeud/SSH_sans_écran.md
new file mode 100644
index 0000000..0f4c04b
--- /dev/null
+++ b/content/operations/deploiement/noeud/SSH_sans_écran.md
@@ -0,0 +1,54 @@
+---
+title: Installer NixOS en SSH
+description: Installer NixOS en SSH sans écran ni clavier
+published: true
+date: 2022-08-24
+tags: installation, serveur, infrastructure, réseau, sysadmin, site géographique, technique, administration
+editor: markdown
+dateCreated: 2021-08-24
+weight: 12
+---
+
+Quick tip avant d'oublier pour installer une de nos machines ThinkCentre via SSH sous NixOS ; c'est la seule solution quand on a pas d'écran ni de clavier sous la main.
+Pré-requis : une clé USB, un ordi sous NixOS.
+
+On va créer une image d'installation nous même qui démarre le SSH et configure root avec notre clé. On créer un fichier `iso.nix` :
+
+```nix
+{config, pkgs, ...}:
+{
+  imports = [
+    <nixpkgs/nixos/modules/installer/cd-dvd/installation-cd-minimal.nix>
+
+    # Provide an initial copy of the NixOS channel so that the user
+    # doesn't need to run "nix-channel --update" first.
+    <nixpkgs/nixos/modules/installer/cd-dvd/channel.nix>
+  ];
+
+  systemd.services.sshd.wantedBy = pkgs.lib.mkForce [ "multi-user.target" ];
+  users.users.root.openssh.authorizedKeys.keys = [
+    "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDT1+H08FdUSvdPpPKdcafq4+JRHvFVjfvG5Id97LAoROmFRUb/ZOMTLdNuD7FqvW0Da5CPxIMr8ZxfrFLtpGyuG7qdI030iIRZPlKpBh37epZHaV+l9F4ZwJQMIBO9cuyLPXgsyvM/s7tDtrdK1k7JTf2EVvoirrjSzBaMhAnhi7//to8zvujDtgDZzy6aby75bAaDetlYPBq2brWehtrf9yDDG9WAMYJqp//scje/WmhbRR6eSdim1HaUcWk5+4ZPt8sQJcy8iWxQ4jtgjqTvMOe5v8ZPkxJNBine/ZKoJsv7FzKem00xEH7opzktaGukyEqH0VwOwKhmBiqsX2yN quentin@dufour.io"
+  ];
+}
+```
+
+On construit l'image à partir de ce fichier de conf :
+
+```bash
+nix-build '<nixpkgs/nixos>' -A config.system.build.isoImage -I nixos-config=iso.nix
+
+```
+
+On le copie sur la clé USB :
+
+```
+dd if=result/iso/*.iso of=/dev/??? status=progress
+sync
+```
+
+On branche la clé sur le serveur, on branche le serveur sur le réseau, on démarre le serveur et on surveille le routeur pour connaitre son IP (nom de domaine `nixos`).
+Ensuite on se connecte dessus :
+
+```
+ssh root@192.168.1.X
+```
\ No newline at end of file
diff --git a/content/operations/deploiement/noeud/_index.md b/content/operations/deploiement/noeud/_index.md
new file mode 100644
index 0000000..844d2dc
--- /dev/null
+++ b/content/operations/deploiement/noeud/_index.md
@@ -0,0 +1,17 @@
+---
+title: Noeud
+description: Déploiement d'un noeud
+published: true
+date: 2022-08-23
+tags: installation, serveur, infrastructure, réseau, sysadmin, site géographique, technique, administration
+editor: markdown
+dateCreated: 2021-08-23
+sort_by: weight
+---
+
+# Déployer un nœud au sein de l'infrastructure Deuxfleurs
+Déployer un nœud au sein de l'infrastructure Deuxfleurs demande un certaine préparation et représente un processus particulier.
+
+Avant de se lancer, [mieux vaut vérifier les prérequis pour y parvenir](prerequis). Une fois ceci fait, on peut suivre [le guide décrivant la procédure](guide-creation-noeud).
+
+Si vous avez une machine à installer, mais aucun écran & clavier à brancher dessus pour la configurer, référez-vous au [guide d'installation de NixOs en SSH](ssh-sans-ecran).
diff --git a/content/operations/deploiement/noeud/guide_création_nœud.md b/content/operations/deploiement/noeud/guide_création_nœud.md
new file mode 100644
index 0000000..c7ee5aa
--- /dev/null
+++ b/content/operations/deploiement/noeud/guide_création_nœud.md
@@ -0,0 +1,100 @@
+---
+title: Guide de création d'un nœud
+description: Guide de création d'un nœud
+published: true
+date: 2022-08-23
+tags: installation, serveur, infrastructure, réseau, sysadmin, site géographique, technique, administration
+editor: markdown
+dateCreated: 2022-08-23
+weight: 11
+---
+
+# Guide d'initialisation de nœud Deuxfleurs
+Ce guide explique comment initialiser un nœud pour l'infrastructure de Deuxfleurs. Nous partons de zéro, c'est-à-dire avec une machine que nous venons de récupérer, avec une mémoire vide, et que nous venons de brancher. À titre d'exemple, nous illustrerons de temps en temps les opérations avec une de nos machines (un Thinkcentre de Lenovo).
+
+## Configuration de l'UEFI
+Configurons d'abord quelques paramètres dans l'UEFI de la machine. Démarrez-là et appuyez sur la touche pour accéder à ce menu. Chez nous, il s'agit de F1. Si le PXE est activé, désactivons-le : un attaquant présent sur le réseau local pourrait faire démarrer une machine sur une installation malveillante. Vérifions que les *C-States* sont pris en charge, cela permet une meilleure gestion de l'énergie. Configurons également la machine pour qu'elle démarre après avoir subi une coupure électrique, cela se révèlera pratique lorsqu'il y en aura une. Si l'option est là, autorisons le démarrage sans clavier branché, pour ne pas être embêté lorsque nous démarrons une machine pour SSH dessus. Enfin, dans le cadre de l'infrastructure Deuxfleurs, nous supporterons uniquement l'UEFI, nous pouvons donc désactiver les options de compatibilité BIOS.
+
+## Installation de NixOS
+
+> Aucun écran ou clavier n'est disponible pour l'ordinateur cible ? NixOS peut être installé en SSH. Suivre les instructions sur [cette page](/operations/deploiement/noeud/ssh-sans-ecran).
+
+Pour installer NixOS, nous aurons besoin d'une clé USB avec une image amorçable (*live*) de NixOS dessus. Nous pouvons télécharger la distribution linux en 64 bits et en version minimale (sans interface graphique et avec moins d'utilitaires) sur le [site officiel](https://nixos.org/download.html). Pour écrire l'image sur le support USB, on peut faire `dd if=chemin-vers-le-fichier-iso of=/dev/sdX status=progress; sync`, en remplaçant `sdX` par le fichier périphérique correspondant à la clé, trouvé avec `lsblk` par exemple.
+
+Branchons la clé USB et démarrons dessus. Chez nous, c'est possible grâce à un menu accessible via la touche F12. Lançons NixOS sans option particulière. Accordons-nous tous les droits et configurons un clavier habituel. On peut également vérifier la connexion internet :
+```
+$ sudo su
+# loadkeys fr-latin9
+# ping deuxfleurs.fr
+```
+Nous pouvons faire `lsblk` pour examiner les disques de la machine. Chez nous, nous avons simplement un disque dur complètement vide de 500Go associé à `/dev/sda`. Nous allons formater le disque avec `cgdisk` :
+```
+# cgdisk /dev/sda
+```
+Nous créons d'abord, avec l'option `New`, une partition qui commence au début, fait 512Mo, avec un code hexadécimal `EF00`, et que nous appelerons «EFI» : c'est le secteur de démarrage.
+Puis nous créons à la suite une partition de 8Go, avec un code hexadécimal `8200`, nommée «swap» : c'est l'espace d'échange.
+Enfin sur tout le reste, nous créons une partition avec un code hexadécimal `8300`, que nous appelerons par exemple «root» : c'est la racine du système linux.
+Pour appliquer les changements, nous utilisons l'option `Write`. Nous pouvons ensuite quitter avec `Quit`, et éventuellement vérifier le résultat avec `lsblk`.
+
+Finalisons les partitions. Dans notre cas, nous devons créer les systèmes avec :
+```
+# mkfs.fat -F 32 /dev/sda1
+# mkswap /dev/sda2
+# mkfs.xfs /dev/sda3
+```
+Nous utilisons ici xfs car nous sommes équipés d'un disque rotatif.
+
+Montons les partitions fraîchement créées.
+```
+# mount /dev/sda3 /mnt
+# mkdir /mnt/boot
+# mount /dev/sda1 /mnt/boot
+# swapon /dev/sda2
+```
+Le résultat est vérifiable avec `df -h`. À ce stade, nous pouvons générer la configuration de NixOS dans cette arborescence, et l'éditer par exemple avec `nano` :
+```
+# nixos-generate-config --root /mnt
+# nano /mnt/etc/nixos/configuration.nix
+```
+Ce fichier décrit la configuration du système de manière générale. NixOS le versionne, et à l'utilisation, chaque modification génère une nouvelle «génération». En cas d'erreur par exemple, nous pourrons revenir facilement à une génération précédente. Ainsi nous décrivons ici la première génération de notre système à venir. Nous n'allons en réalité modifier que quelques choses par rapport à la configuration par défaut. Décommentons et définissons le nom d'hôte et le fuseau horaire :
+```
+networking.hostName = "nomDeLaMachine";
+```
+```
+time.timeZone = "Europe/Paris";
+```
+Pour les propriétés d'internationalisation, nous pouvons par exemple définir ceci :
+```
+i18n.defaultLocale = "fr_FR.UTF-8";
+console = {
+  font = "Lat2-Terminus16";
+  keyMap = "fr-latin9";
+};
+```
+Attention en tout cas à ne pas définir en même temps `keyMap` et `useXkbConfig`, ces deux options peuvent se contredire. Pour l'utilisateur et les paquets du système, nous pouvons par exemple partir sur :
+```
+users.users.nomUtilisateur = {
+  isNormalUser = true;
+  extraGroups = [ "wheel" ];
+};
+```
+```
+environment.systemPackages = with pkgs; [
+  vim
+  wget
+  emacs
+];
+```
+Enfin activons le serveur SSH en décommentant :
+```
+services.openssh.enable = true;
+```
+Nous pouvons enregistrer et fermer le fichier, puis lancer l'installation avec :
+```
+# nixos-install
+```
+Au bout d'un certain temps, le processus va nous demander le mot de passe pour le compte root. Une fois donné, l'installation devrait être terminée. Nous pouvons redémarrer sur la machine, et nous connecter en tant que root. Définissons le mot de passe de l'utilisateur spécifié dans la configuration auparavant (nomUtilisateur) avec :
+```
+# passwd nomUtilisateur
+```
+Nous pouvons si nous le voulons nous déconnecter avec `exit` et tester la connexion sur nomUtilisateur en local ou en SSH.
diff --git a/content/operations/deploiement/noeud.md b/content/operations/deploiement/noeud/prérequis.md
index 07306ea..e2dfdcc 100644
--- a/content/operations/deploiement/noeud.md
+++ b/content/operations/deploiement/noeud/prérequis.md
@@ -1,6 +1,6 @@
 ---
-title: Noeud
-description: Déploiement d'un noeud
+title: Prérequis pour un nœud
+description: Prérequis pour un nœud
 published: true
 date: 2022-01-09T13:29:29.710Z
 tags: installation, serveur, infrastructure, réseau, sysadmin, site géographique, technique, administration
@@ -39,14 +39,4 @@ On peut distinguer deux types de sites :
   On aura affaire à sa box (NAT, pare-feu...), au manque de garanties concernant notre adressabilité (IPv4 dynamique, IPv6 ? ...), ce qui va nous mener à devoir faire du routage. Le nœud du problème, c'est que chaque ordinateur de la grappe n'aura pas pignon sur rue (pas d'adresse IP publique et fixe par machine).
   
   Néanmoins, **on est chez nous !** Votre disque dur - qui contient les données personnelles de vos usagers chéris - est sous vos yeux, bien au chaud. Le seul curieux qui voit passer votre trafic réseau est votre FAI : *rien de nouveau sous le soleil*.
-  
-Dans les deux cas - grâce à [la magie des VPN](/Technique/Infra/Wireguard) - on pourra communiquer sans souci avec le reste du cluster de Deuxfleurs.
-  
-**À terme, chez Deuxfleurs, on compte héberger toute notre infrastructure chez des particuliers.** Mais [la route est encore longue](/Technique/Jalons/Interconnexion) avant que nous ayons assez de bonnes connexions et des ordinateurs suffisamment puissants, sans parler du système de gestion logiciel. 
-Ainsi, **pour le moment, il est tout à fait acceptable d'héberger des services Deuxfleurs en centre de données** : tant qu'on en informe nos usagers et qu'on fait attention à la sécurité.
-
-# Installation des ordinateurs
-
-Pour chaque ordinateur de notre future grappe, nous allons avoir besoin d'en configurer le ou les disques, de les chiffrer éventuellement, et d'installer son système d'exploitation.
-
-
+  
\ No newline at end of file