diff --git a/scripts/INSTALL.md b/scripts/INSTALL.md index 99dd8d4..d0ac1d6 100644 --- a/scripts/INSTALL.md +++ b/scripts/INSTALL.md @@ -3,16 +3,16 @@ Ce guide vous explique comment télécharger et exécuter les scripts d'installation et de configuration disponibles dans ce dépôt. ## 🛠 Prérequis - -Avant d'utiliser les scripts, assurez-vous d'avoir : -- Un système Linux Debian-like -- `git` installé sur votre machine si vous déployez avec GIT +Avant d'utiliser les scripts, assurez-vous de disposer des éléments suivants : +- Un système Linux de type Debian +- `git` installé si vous déployez avec GIT - Les droits administrateur (`sudo`) ## 🚀 Installation +Vous avez trois options pour récupérer les scripts. La troisième est recommandée. ### 1️⃣ Cloner le dépôt -Si vous souhaitez récupérer l'intégralité du projet, utilisez : +Si vous souhaitez récupérer l'intégralité du projet, utilisez la commande suivante : ```bash git clone https://git.abonnel.fr/cedricAbonnel/notes-techniques.git cd notes-techniques/scripts @@ -27,26 +27,26 @@ git sparse-checkout add scripts/server-mail ``` Remplacez `server-mail` par le dossier du service que vous souhaitez installer. -### 3️⃣ Exécuter le script d'installation personnalisé -Une fois dans le bon dossier, lancez le script d'installation correspondant. Par exemple, pour installer un serveur de messagerie : -```bash -cd scripts/server-mail -./setup_server.sh -``` -Suivez ensuite les instructions affichées. +### 3️⃣ Exécuter le script d'installation personnalisé (recommandé) +Un script personnalisé permet de télécharger un ou plusieurs scripts en fonction des éléments sélectionnés. Il offre les avantages suivants : +- Mise à jour automatique avec la dernière version disponible +- Téléchargement sélectif des scripts depuis le dépôt +- Interface interactive de sélection des scripts avec `whiptail` +- Suppression des fichiers obsolètes +- Application automatique des permissions d'exécution --- # 🔄 Installation et mise à jour automatique des scripts ## 🛠 Prérequis -Avant d'exécuter le script, assurez-vous que votre système répond aux conditions suivantes : +Avant d'exécuter le script, assurez-vous que votre système répond aux exigences suivantes : - Système d'exploitation Linux - `bash` installé - `wget` installé - `whiptail` (inclus dans `dialog` sur certaines distributions) -Vous pouvez installer les dépendances avec la commande suivante : +Pour installer les dépendances, utilisez la commande suivante : ```bash sudo apt update && sudo apt install -y wget dialog ``` @@ -68,17 +68,23 @@ chmod +x fetch_scripts.sh ./fetch_scripts.sh ``` +Accédez ensuite au dossier de votre choix et exécutez le script d'installation correspondant. Par exemple, pour installer un serveur de messagerie : +```bash +cd scripts/server-mail +./setup_server.sh +``` +Suivez ensuite les instructions affichées. + ## ⚙️ Fonctionnement du script Le script permet de : - Se mettre à jour automatiquement en téléchargeant la dernière version disponible -- Télécharger une liste de scripts disponibles depuis le dépôt -- Afficher une interface de sélection des scripts à télécharger avec `whiptail` -- Gérer la suppression des anciens fichiers non sélectionnés +- Télécharger une liste de scripts depuis le dépôt +- Offrir une interface interactive pour sélectionner les scripts à télécharger +- Supprimer les fichiers obsolètes - Appliquer les permissions d'exécution aux scripts téléchargés ## 🔄 Mise à jour des scripts -Le script se met à jour automatiquement à chaque exécution si une nouvelle version est disponible. -Si vous souhaitez forcer une mise à jour, exécutez simplement : +Le script se met à jour automatiquement à chaque exécution si une nouvelle version est disponible. Pour forcer une mise à jour, exécutez : ```bash ./fetch_scripts.sh ``` @@ -86,7 +92,7 @@ Si vous souhaitez forcer une mise à jour, exécutez simplement : ## 🛠 Problèmes courants - **Erreur : `whiptail: command not found`** - - Assurez-vous que `whiptail` est installé : + - Installez `whiptail` avec la commande suivante : ```bash sudo apt install dialog # ou sudo yum install dialog ```