notes-techniques/scripts/INSTALL.md

3.3 KiB
Raw Blame History

📥 Installation des scripts

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
  • Les droits administrateur (sudo)

🚀 Installation

1 Cloner le dépôt

Si vous souhaitez récupérer l'intégralité du projet, utilisez :

git clone https://git.abonnel.fr/cedricAbonnel/notes-techniques.git
cd notes-techniques/scripts

2 Télécharger uniquement un dossier spécifique

Si vous ne souhaitez pas cloner tout le projet, utilisez Git sparse checkout :

git clone --depth 1 --filter=blob:none --sparse https://git.abonnel.fr/cedricAbonnel/notes-techniques.git
cd notes-techniques
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 :

cd scripts/server-mail
./setup_server.sh

Suivez ensuite les instructions affichées.


🔄 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 :

  • 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 :

sudo apt update && sudo apt install -y wget dialog

(Sur une distribution utilisant yum ou dnf, adaptez la commande en conséquence.)

📥 Installation

1 Télécharger le script

wget -O fetch_scripts.sh https://git.abonnel.fr/cedricAbonnel/notes-techniques/raw/branch/main/scripts/fetch_scripts.sh

2 Rendre le script exécutable

chmod +x fetch_scripts.sh

3 Exécuter le script

./fetch_scripts.sh

⚙️ 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
  • 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 :

./fetch_scripts.sh

🛠 Problèmes courants

  • Erreur : whiptail: command not found

    • Assurez-vous que whiptail est installé :
      sudo apt install dialog  # ou sudo yum install dialog
      
  • Erreur de connexion au dépôt

    • Vérifiez votre connexion internet
    • Assurez-vous que l'URL du dépôt est correcte

📖 Support & Contribution

Si vous rencontrez un problème ou souhaitez proposer une amélioration, consultez le fichier CONTRIBUTING.md ou ouvrez une issue sur le dépôt.

Bonne installation ! 🚀