README

README.md

@@ -1,18 +1,22 @@
 # gsb2024
 
-2024-12-19 ps
+2024-12-21 ps
 
 Environnement et playbooks ansible pour le projet GSB 2024
 
 ## Quickstart
+
 Prérequis : 
-  * une machine Debian Bookworm
+  * une machine LInux Debian Bookworm ou Windows
   * VirtualBox
+  * git 
   * fichier machines virtuelles **ova** :
     * **debian-bookworm-gsb-2023c.ova**
     * **debian-buster-gsb-2023a.ova**
 
 
+## Les machines 
+
   * **s-adm** : routeur adm, DHCP + NAT, deploiement, proxy squid 
   * **s-infra** : DNS maitre, autoconfiguration navigateurs avec **wpad**
   * **r-int** : routage, DHCP 
@@ -38,6 +42,7 @@ Prérequis :
 
 ## Les playbooks
 
+Il existe un playbook ansible pour chaque machine à installer, nommé comme la machine avec l'extension **.yml**
 
 ## Installation
 
@@ -49,25 +54,26 @@ et pour **s-fog** :
   * **debian-buster-2023a.ova** (2023-01-06)
     * Debian Buster 10 - 2 cartes - 1 Go - stockage 20 Go
 
+Les images **.ova** doivent etre stockées dans le répertoire habituel de téléchargement de l'utilisateur courant.
+
 ### Création d'une VM
 
-Récupérer le dépot gsb2024.git avec :
+Sur la machine physique, récupérer le dépot **gsb2024.git** avec :
 ```shell
    git clone https://gitea.lyc-lecastel.fr/gsb/gsb2024.git
-   cd gsb2024
 ```
 
 On utilisera le script (bash) **mkvm** ou (PowerShell) **mkvm.ps1** pour créer une VM Virtualbox.
 
 ```shell
-gsb2024>
-cd scripts
-$ mkvm -r s-adm
+cd gsb2024/scripts
+mkvm -r s-adm
 
 ```
 
 ### Machine s-adm
   * créer la machine virtuelle **s-adm** avec **mkvm** comme décrit plus haut.
+  * démarrer la VM puis ouvir une session
   * utiliser le script de renommage comme suit :
 ```shell
 bash chname <nouveau_nom_de_machine>` , puis redémarrer
@@ -89,20 +95,35 @@ bash chname <nouveau_nom_de_machine>` , puis redémarrer
   
 ### Pour chaque machine
 
+####  Etape 1
+
   - créer la machine avec **mkvm -r**, les cartes réseau sont paramétrées par **mkvm** selon les spécifications 
-  - utiliser le script de renommage comme suit : `bash chname <nouveau_nom_de_machine>`
-  - redémarrer
+  - ouvrir une session sur la machine considérée
+  - renomme la machine soit
+     * en utilisant le script de renommage comme suit : 
+        ` /root/tools/ansible/gsb2024/scripts/chname <nouveau_nom_de_machine>`
+     * soit avec :  
+```shell
+NHOST=mavm   
+sed -i "s/bookworm/${NHOST}/g" /etc/host{s,name}
+sudo reboot # on redemarre
+``` 
+
+#### Etape 2
+
   - utiliser le script **gsb-start** : `bash gsb-start`
   - ou sinon:
 ```shell
 mkdir -p tools/ansible ; cd tools/ansible
 git clone https://gitea.lyc-lecastel.fr/gsb/gsb2024.git
 cd gsb2024/pre
-export DEPL=192.168.99.99
-bash gsbboot
+DEPL=192.168.99.99 bash gsbboot
 cd ../..
 bash pull-config
 ```
+
+#### Etape 3
+
   - redémarrer
   - **Remarque** : une machine doit avoir été redémarrée pour prendre en charge la nouvelle configuration