[[./accueil| ↩ Retour à l'accueil du projet]]
====== 7) Script : Ajouter une VM Conteneur ======

Ce document définit la structure logique et les étapes automatisées lors du déploiement d'un nouvel environnement virtuel isolé (conçu comme une "VM conteneur" légère) sur le serveur VPS.

===== 1. Cinématique de Déploiement =====

Lors de son exécution via le [[./04_menu_principal|Menu Principal]], le script réalise les actions suivantes :
  * **Collecte des paramètres :** Demande à l'administrateur le nom unique à attribuer à ce conteneur (ex: ''ynh-template'' ou ''client-projet'').
  * **Création de l'espace isolé :** Initialise un environnement d'exécution étanche (partageant le noyau de l'hôte pour économiser la RAM, mais disposant de son propre espace de fichiers et de processus).
  * **Configuration du système invité :** Injecte la configuration réseau de base et s'assure que le système d'initialisation interne est prêt à démarrer ses propres services indépendamment du VPS.

===== 2. Raccordement Réseau Intégré =====

Pour que le conteneur puisse communiquer avec l'extérieur et partager l'IP publique, le script automatise son intégration au réseau privé :
  * **Création de l'interface réseau virtuelle :** Relie le conteneur à l'interface interne gérée par le VPS.
  * **Attribution d'une IP VPN fixe :** Alloue une adresse IP dédiée au conteneur dans la plage privée (ex: ''10.66.66.10'').
  * **Génération des clés d'accès :** Configure le tunnel Wireguard interne pour que l'hôte accepte immédiatement le trafic en provenance et à destination de ce nouveau conteneur.

===== 3. Bilan Visuel & Journalisation =====

  * **Contrôle d'allumage :** Le script démarre le conteneur et vérifie visuellement son état d'exécution.
  * **Affichage terminal :** Un résumé s'affiche à l'écran confirmant le succès de l'opération, le nom de l'instance et son IP réseau dédiée.
  * **Traçabilité :** L'action est enregistrée de manière permanente avec horodatage dans le journal système ''/var/log/vps-gateway.log''.

===== 4. Accès aux Ressources Techniques =====

Pour consulter le code source de ce script ou télécharger l'archive globale du projet :
➔ [[./12_telechargements_sources|🛠️ Aller au module 12) Téléchargements du projet et sources des scripts]]

[[./accueil| ↩ Retour à l'accueil du projet]]
