diff --git a/README.md b/README.md index 956c867..e0ae8ef 100644 --- a/README.md +++ b/README.md @@ -5,47 +5,47 @@ ![Network](https://img.shields.io/badge/Network-ifupdown-2563EB?style=for-the-badge) ![License](https://img.shields.io/badge/License-AGPLv3-blue?style=for-the-badge) -✨ Scripts utiles pour preparer rapidement une base serveur Debian sans environnement graphique. +✨ Scripts utiles pour préparer rapidement une base serveur Debian sans environnement graphique. ## 🎯 Objectif -Ce depot regroupe des scripts Bash pour automatiser les taches courantes de preparation, configuration et maintenance d'une base serveur Debian minimaliste. +Ce dépôt regroupe des scripts Bash pour automatiser les tâches courantes de préparation, configuration et maintenance d'une base serveur Debian minimaliste. L'objectif est de garder une collection de scripts : -- 🧱 simples a lire et a auditer ; -- 🔐 executables explicitement avec les privileges necessaires ; -- 🧭 adaptes a des serveurs sans environnement graphique ; -- 📚 documentes dans ce README au fur et a mesure des ajouts. +- 🧱 simples à lire et à auditer ; +- 🔐 exécutables explicitement avec les privilèges nécessaires ; +- 🧭 adaptés à des serveurs sans environnement graphique ; +- 📚 documentés dans ce README au fur et à mesure des ajouts. ## 🧰 Scripts disponibles -| Script | Role | +| Script | Rôle | | --- | --- | | `configure-debian-network.sh` | Configurer le hostname, l'IP statique, la gateway et les DNS | -| `install-docker-ce.sh` | Installer Docker CE depuis le depot officiel Docker | +| `install-docker-ce.sh` | Installer Docker CE depuis le dépôt officiel Docker | -Le script reseau cible une installation serveur Debian classique utilisant : +Le script réseau cible une installation serveur Debian classique utilisant : - 📄 `/etc/network/interfaces` - ⚙️ le service `networking` -- 🔐 une execution en root via `sudo` +- 🔐 une exécution en root via `sudo` -Il ne vise pas les postes avec NetworkManager, interface graphique ou gestion reseau desktop. +Il ne vise pas les postes avec NetworkManager, interface graphique ou gestion réseau desktop. -## 🚀 Utilisation reseau +## 🚀 Utilisation réseau -Configurer la base reseau : +Configurer la base réseau : ```bash sudo ./configure-debian-network.sh ``` -Le script reseau demande les informations une par une : +Le script réseau demande les informations une par une : ```text Nom de la machine (laisser vide pour ne pas modifier): -Adresse IP avec prefixe CIDR (ex: 192.168.1.50/24, laisser vide pour ne pas modifier le reseau): +Adresse IP avec préfixe CIDR (ex: 192.168.1.50/24, laisser vide pour ne pas modifier le réseau): ``` Exemples de cas d'usage : @@ -53,13 +53,13 @@ Exemples de cas d'usage : | Besoin | Action | | --- | --- | | 🏷️ Modifier uniquement le hostname | Renseigner le hostname, laisser l'IP vide | -| 🌐 Modifier uniquement le reseau | Laisser le hostname vide, renseigner l'IP | -| 🛠️ Modifier hostname et reseau | Renseigner toutes les informations | +| 🌐 Modifier uniquement le réseau | Laisser le hostname vide, renseigner l'IP | +| 🛠️ Modifier hostname et réseau | Renseigner toutes les informations | | 💤 Ne rien changer | Laisser hostname et IP vides | ## 🐳 Installation Docker CE -Installer Docker CE depuis le depot officiel Docker : +Installer Docker CE depuis le dépôt officiel Docker : ```bash sudo ./install-docker-ce.sh @@ -73,14 +73,14 @@ sudo ./install-docker-ce.sh olivier Le script Docker effectue les actions suivantes : -- 🧹 suppression des anciens paquets Docker conflictuels si presents ; -- 🔑 ajout de la cle GPG officielle Docker dans `/etc/apt/keyrings/docker.asc` ; -- 📦 ajout du depot APT officiel via `/etc/apt/sources.list.d/docker.sources` ; +- 🧹 suppression des anciens paquets Docker conflictuels si présents ; +- 🔑 ajout de la clé GPG officielle Docker dans `/etc/apt/keyrings/docker.asc` ; +- 📦 ajout du dépôt APT officiel via `/etc/apt/sources.list.d/docker.sources` ; - 🐳 installation de `docker-ce`, `docker-ce-cli` et `containerd.io` ; - 🧩 installation des plugins `docker-buildx-plugin` et `docker-compose-plugin` ; -- ⚙️ activation et demarrage du service `docker`. +- ⚙️ activation et démarrage du service `docker`. -Verification apres installation : +Vérification après installation : ```bash docker --version @@ -88,11 +88,11 @@ docker compose version systemctl status docker ``` -Si un utilisateur est ajoute au groupe `docker`, il doit ouvrir une nouvelle session avant de pouvoir utiliser Docker sans `sudo`. +Si un utilisateur est ajouté au groupe `docker`, il doit ouvrir une nouvelle session avant de pouvoir utiliser Docker sans `sudo`. ## 🛟 Sauvegardes -Avant modification, le script sauvegarde les fichiers concernes avec un suffixe date : +Avant modification, le script sauvegarde les fichiers concernés avec un suffixe date : ```text /etc/hostname.bak.YYYYMMDD-HHMMSS @@ -101,18 +101,18 @@ Avant modification, le script sauvegarde les fichiers concernes avec un suffixe /etc/resolv.conf.bak.YYYYMMDD-HHMMSS ``` -Seuls les fichiers necessaires sont sauvegardes selon les options choisies. +Seuls les fichiers nécessaires sont sauvegardés selon les options choisies. ## ✅ Validation -Verification syntaxique : +Vérification syntaxique : ```bash bash -n configure-debian-network.sh bash -n install-docker-ce.sh ``` -Verification manuelle recommandee apres execution : +Vérification manuelle recommandée après exécution : ```bash hostnamectl @@ -123,10 +123,10 @@ cat /etc/resolv.conf ## 📝 Notes Debian -Le script est adapte aux serveurs Debian minimalistes. Sur une machine utilisant NetworkManager ou systemd-networkd, il faut utiliser le backend reseau correspondant plutot que modifier directement `/etc/network/interfaces`. +Le script est adapté aux serveurs Debian minimalistes. Sur une machine utilisant NetworkManager ou systemd-networkd, il faut utiliser le backend réseau correspondant plutôt que modifier directement `/etc/network/interfaces`. ## ⚖️ Licence -Ce projet est distribue sous licence GNU Affero General Public License v3.0. +Ce projet est distribué sous licence GNU Affero General Public License v3.0. Voir [LICENSE](LICENSE) pour le texte complet.