Installation par script (bonnes pratiques)

De nombreux logiciels (Docker, Pterodactyl, Froxlor, etc.) proposent une installation via curl | bash, wget -O - | sh ou un script téléchargé puis exécuté. Ce guide rappelle les bonnes pratiques : vérification du script, droits, idempotence, et donne des exemples et des liens vers les guides dédiés.

Prérequis

• Accès root ou sudo
• curl ou wget selon le script
• Connexion Internet

1. Vérifier avant d’exécuter

• Lire le script (ou au moins les premières et dernières lignes) avant de le lancer.
  Ex. : curl -sSL https://get.docker.com | less ou télécharger puis cat install.sh | less.
• Vérifier l’URL : doc officielle, domaine connu (get.docker.com, get.pterodactyl.io, etc.). Éviter les liens courts ou des sources inconnues.
• Checksum : si l’auteur fournit un SHA256, télécharger le script et vérifier :
  sha256sum install.sh puis comparer.

2. Préférer télécharger puis exécuter

• Au lieu de curl URL | bash, préférer :
  curl -sSL -o install.sh https://example.com/install.sh
  puis :
  chmod +x install.sh et ./install.sh (ou bash install.sh).
• Avantages : relecture possible, pas d’exécution « à la volée » pendant le téléchargement, sauvegarde du script pour audit.

3. Droits et environnement

• Lancer le script avec les droits requis : root ou sudo si le script le demande.
• Répertoire : certains scripts exigent d’être exécutés depuis un répertoire précis (ex. /opt, $HOME).
• Variables d’environnement : DRY_RUN=1, VERSION=1.2.3, etc. — à utiliser si le script les documente.

4. Idempotence et rollback

• Idempotence : un script bien conçu peut être relancé sans tout casser. En cas de doute, consulter la doc.
• Rollback : savoir comment désinstaller ou restaurer (doc, option --uninstall, sauvegardes).
• Sauvegardes : faire un backup des configs (etc/, /etc) et des données importantes avant une grosse installation.

5. Exemples (officiels ou répandus)

• Docker :
  curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
  Voir install-docker-linux.

• Pterodactyl Panel :
  curl -sSL https://get.pterodactyl.io | sudo bash
  (À vérifier sur pterodactyl.io pour la dernière procédure.)
  Voir install-pterodactyl-auto.

• Froxlor :
  Dépôt + apt install froxlor ; un script ou des étapes peuvent compléter.
  Voir froxlor-linux.

• Proxmox :
  Script plesk-installer ou proxmox : télécharger l’installeur, vérifier le checksum, puis l’exécuter.
  Voir install-proxmox.

6. En cas de problème

• Logs : rediriger la sortie : ./install.sh 2>&1 | tee install.log.
• Erreurs : lire le message (paquets manquants, droits, dépôts) ; installer les dépendances indiquées.
• Annuler : arrêter le script (Ctrl+C) ; suivre la procédure de désinstallation ou de nettoyage de la doc.

Bonnes pratiques

• Ne pas exécuter un script dont vous ne comprenez pas la source ou le contenu sans au moins une revue rapide.
• Documenter : noter l’URL, la version du script et les options utilisées pour reproduire ou mettre à jour.
• Pour des installations détaillées : install-docker-linux, install-pterodactyl-auto, froxlor-linux, install-proxmox.

Ressources

• [Documentation des projets cités] ; toujours privilégier la doc officielle à jour.

Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.