Mise à jour README + .env.exemple

Résolution d'un conflit
This commit is contained in:
Nelson 2025-05-27 15:00:25 +02:00
parent 74d149f5f6
commit 85973baedb
2 changed files with 46 additions and 13 deletions

2
.env.exemple Normal file
View File

@ -0,0 +1,2 @@
FOG_API_TOKEN=""
FOG_USER_TOKEN""

View File

@ -1,6 +1,8 @@
# Fog_Reinitialisation # Fog_Reinitialisation
---
# **Attention, ce projet est en cours de dévelopement et peut ne pas fonctionner pour l'instant**
# Reinit - Réinitialisation rapide des PC via FogProject # Reinit - Réinitialisation rapide des PC via FogProject
Un script Bash permettant de **réinitialiser rapidement et simplement les PC des salles de TP** en s'appuyant sur l'API de [FogProject](https://github.com/FOGProject/fogproject). Un script Bash permettant de **réinitialiser rapidement et simplement les PC des salles de TP** en s'appuyant sur l'API de [FogProject](https://github.com/FOGProject/fogproject).
@ -10,6 +12,8 @@ Un script Bash permettant de **réinitialiser rapidement et simplement les PC de
- Réinitialisation à distance des machines via FogProject - Réinitialisation à distance des machines via FogProject
- Automatisation simple par script Bash - Automatisation simple par script Bash
- Utilisation prévue dans des environnements scolaires ou universitaires - Utilisation prévue dans des environnements scolaires ou universitaires
- Déploiement transparent : Allumage via Wake On Lan -> Déploiement multicast -> Extinction des machines.
## 🛠️ Prérequis ## 🛠️ Prérequis
@ -17,12 +21,16 @@ Un script Bash permettant de **réinitialiser rapidement et simplement les PC de
- Accès à l'API REST de Fog (clé d'authentification si nécessaire) - Accès à l'API REST de Fog (clé d'authentification si nécessaire)
- Les machines clientes doivent être correctement enregistrées dans Fog - Les machines clientes doivent être correctement enregistrées dans Fog
## ⚠️ Problèmes connus
## ⚠️ Problèmes connus sur les machines Windows
### ❗ Erreur : `The NTFS partition is in an unsafe state` ### ❗ Erreur : `The NTFS partition is in an unsafe state`
#### 🧭 Cause #### 🧭 Cause
Cette erreur indique que **Windows ne s'est pas arrêté correctement**. Le système de fichiers NTFS est resté dans un état non sécurisé.
Cette erreur apparaît lors de la capture ou du déploiement d'une image via démarage réseau. Elle indique que **Windows ne s'est pas arrêté correctement**. Le système de fichiers NTFS est resté dans un état non sécurisé.
#### ✅ Solution #### ✅ Solution
1. Démarrer la machine sous Windows 1. Démarrer la machine sous Windows
@ -37,32 +45,54 @@ Cela assurera un arrêt propre de Windows, évitant les erreurs lors du démarra
## 📁 Structure du projet ## 📁 Structure du projet
```bash ```bash
reinit/ # Dossier du projet Fog_Reinitialisation/ # Dossier du projet
├── reinit.sh # Script Bash principal ├── reinitialisation_salle.sh # Script Bash principal
├── README.md # Ce fichier ├── .env.exemple # Variables pour l'API Fog
└── config.env # (Optionnel) Configuration pour l'API Fog └── README.md # Ce fichier
``` ```
## 🚀 Utilisation ## 🚀 Utilisation
1. Rendre le script exécutable : 1. Téléchargement, mettez vous dans le répertoire de votre choix pour installer le dossier du projet (De façon à ce qu'il ne soit pas déplacé par la suite):
```bash
curl -L "https://git.nelson-thomas.fr/nelson/Fog_Reinitialisation/archive/main.tar.gz" | tar -xz
```
2. Rentrer dans le répertoire du projet :
```bash
cd ./Fog_Reinitialisation
```
3. Mettre les token de l'api fog dans le .env.exemple et le renommer :
```bash
nano .env.exemple
```
Puis
```bash
mv .env.exemple ./.env
```
4. Rendre le script exécutable :
```bash ```bash
chmod +x reinit.sh chmod u+x reinitialisation_salle.sh
``` ```
2. (Optionnel) Installer globalement : 5. (Optionnel) Installer globalement :
```bash ```bash
sudo ln -s $(pwd)/reinit.sh /usr/local/bin/reinit sudo ln -s $(pwd)/reinitialisation_salle.sh /usr/local/bin/reinit
``` ```
3. Exécuter la commande depuis n'importe où : 6. Exécuter la commande depuis n'importe où :
```bash ```bash
reinit reinit
``` ```
--- ---
## 🔗 Ressources ## 🔗 Ressources
@ -71,3 +101,4 @@ reinit/ # Dossier du projet
* [Documentation officielle de Fog](https://wiki.fogproject.org/) * [Documentation officielle de Fog](https://wiki.fogproject.org/)