edubox/agent/installer/setup-wizard/SUIVI_INSTALLER.md

Feuille de route — Installateur studioE5 Agent

Objectif

Fournir un installateur professionnel Windows pour studioE5 Agent, guidé pas à pas, qui gère les prérequis (WSL2 / Podman) et propose une désinstallation complète.

Architecture choisie

• Wizard C# Windows Forms (.NET 8) : setup-wizard/
  • Détecte les prérequis.
  • Installe WSL2 si besoin (avec reprise après redémarrage via RunOnce).
  • Installe Podman depuis le MSI officiel.
  • Initialise et démarre la machine Podman.
  • Lance le package Inno Setup de studioE5 Agent.
  • Mode désinstallation via /uninstall.
• Package agent (Inno Setup) : studioE5-agent.iss
  • Installe studioE5-agent.exe + binaires Tailscale.
  • Crée les raccourcis.
  • Gère la désinstallation.

État actuel

✅ Réalisé

• Wizard C# avec 7 étapes guidées.
• Détection des prérequis : Windows, RAM, disque, WSL2, Podman.
• Installation WSL2 en plusieurs étapes contrôlées avec suivi visuel :
  1. Activation des fonctionnalités Windows (Microsoft-Windows-Subsystem-Linux et VirtualMachinePlatform) avec gestion du code 3010 (redémarrage nécessaire).
  2. Installation du package WSL2 complet depuis le bundle Microsoft Store offline (Microsoft.WSL_*.msixbundle) via Add-AppxPackage.
  3. Mise à jour du noyau WSL2 depuis le MSI bundlé (wsl_update_x64.msi) ou, en dernier recours, via wsl --update.
  4. Définition de WSL2 comme version par défaut (wsl --set-default-version 2).
  5. L’étape wsl --install --no-distribution n’est plus utilisée : l’installation est entièrement offline grâce au bundle.
  6. Conversion des distributions WSL1 existantes vers WSL2 (wsl --set-version <nom> 2) si nécessaire.
• Reprise automatique après redémarrage grâce à RunOnce (y compris redémarrage post-installation WSL2).
• Versioning indépendant du wizard (fichier setup-wizard/VERSION, affiché dans la fenêtre et la page d’accueil).
• Amélioration de l’interface : fenêtre agrandie à 800×600, AutoScaleMode = Dpi, meilleur rendu sur petits écrans (11 pouces).
• RunCommand capture désormais stdout + stderr pour des diagnostics et fallbacks plus fiables.
• Détection des prérequis vérifie que WSL2 (et non WSL1) est installé via wsl --status.
• Installation Podman via MSI bundlé.
• Configuration Podman (machine init + machine start), avec initialisation offline possible depuis une image locale (podman-machine.*.wsl.tar.zst).
• Lancement du package Inno Setup agent.
• Mode désinstallation complet.
• Script Inno Setup de base pour l’agent.

🔄 En cours / À tester

• Compilation et test du wizard sur Windows.
• Packaging final (wizard + MSI Podman + setup agent) en un seul dossier distribuable.

⏳ À venir

• Signature de l’exécutable pour éviter les alertes SmartScreen.
• Support macOS et Linux.
• Installateur silencieux possible pour déploiement GPO.

Build du wizard

Prérequis

• Windows 10/11
• .NET 8 SDK
• Inno Setup 6 (pour générer studioE5-agent-setup.exe)

Fichiers à placer

Dans setup-wizard/Resources/ :

podman-installer-windows-amd64.msi
studioE5-agent-setup.exe
Microsoft.WSL_2.7.10.0_x64_ARM64.msixbundle  # package WSL2 complet (offline)
podman-machine.x86_64.wsl.tar.zst            # image Podman machine pour WSL (offline)
docker-compose-windows-x86_64.exe            # Docker Compose standalone (offline)
wsl_update_x64.msi                           # optionnel, fallback noyau WSL2

Commande

cd setup-wizard
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true

Sortie

setup-wizard\bin\Release\net8.0-windows\win-x64\publish\StudioE5-SetupWizard.exe

Build du package agent (Inno Setup)

Structure attendue :

agent/
├── studioE5-agent.exe
├── tailscale-bin/
│   └── windows/
│       ├── tailscale.exe
│       ├── tailscaled.exe
│       └── wintun.dll
└── installer/
    └── studioE5-agent.iss

Ouvrir studioE5-agent.iss avec Inno Setup Compiler et compiler (Ctrl+F9).

Le fichier généré se trouve dans installer-output/.

Notes importantes

• Le wizard doit être exécuté en administrateur.
• L’installation de WSL2 nécessite un redémarrage de l’ordinateur après l’activation des fonctionnalités Windows.
• L’installation de WSL2 est découpée en étapes et chaque étape est enregistrée pour permettre la reprise après redémarrage.
• Podman nécessite WSL2 : le wizard vérifie donc que la version par défaut de WSL est 2.
• Le MSI Podman officiel pour Windows est podman-installer-windows-amd64.msi.
• Le bundle WSL2 offline est disponible sur https://github.com/microsoft/WSL/releases : Microsoft.WSL_2.7.10.0_x64_ARM64.msixbundle.
• L’image Podman machine offline est disponible sur https://github.com/containers/podman-machine-os/releases : podman-machine.x86_64.wsl.tar.zst.
• Docker Compose standalone est disponible sur https://github.com/docker/compose/releases : docker-compose-windows-x86_64.exe.
• Le wizard crée automatiquement un fichier .wslconfig allouant 8 Go de RAM et 4 CPU à WSL2, ce qui est nécessaire pour des applications lourdes comme PrestaShop.
• Pour la désinstallation, le MSI Podman doit être présent dans Resources/.

Liens utiles

• Releases Podman : https://github.com/containers/podman/releases
• Inno Setup : https://jrsoftware.org/isdl.php
• .NET 8 SDK : https://dotnet.microsoft.com/download/dotnet/8.0