Files
edubox/agent/installer/setup-wizard/README.md
EduBox Dev fc61404271 feat: installation offline complete, HTTPS registry, 8Go WSL, v0.3.18
- Wizard: installation 100% offline (WSL bundle, Podman MSI, machine image, docker-compose)
- Wizard: suppression de wsl --install --no-distribution
- Wizard: .wslconfig avec 8Go RAM / 4 CPU
- Wizard: operations asynchrones pour eviter le freeze UI
- Wizard: detection automatique de podman.exe
- Wizard: version 0.1.1
- Agent: passage en v0.3.18
- Serveur: registry PrestaShop en HTTPS via gitea.alfrednobel.edudeploy.com
- Caddy: config gitea.alfrednobel.edudeploy.com
- Docs: mise a jour SUIVI_INSTALLER.md, README.md, seed.ts
2026-07-02 22:52:28 +00:00

3.5 KiB
Raw Permalink Blame History

StudioE5 Setup Wizard

Assistant dinstallation graphique Windows pour studioE5 Agent.

Rôle

Ce wizard guide lutilisateur pas à pas pour :

  1. Vérifier les prérequis (RAM, disque, Windows, environnement virtuel, Podman).
  2. Installer lenvironnement virtuel (WSL2) si nécessaire, avec reprise après redémarrage.
  3. Installer Podman depuis le MSI bundlé.
  4. Initialiser et démarrer la machine Podman.
  5. Lancer le package Inno Setup de studioE5 Agent.

Il propose aussi un mode désinstallation complet (/uninstall).

Prérequis de build

  • Windows 10/11
  • .NET 8 SDK
  • Visual Studio 2022 ou Visual Studio Code (optionnel)

Structure

setup-wizard/
├── SetupWizard.csproj
├── Program.cs
├── MainForm.cs
├── InstallerState.cs
├── PrerequisiteChecker.cs
├── app.manifest
└── Resources/
    ├── podman-installer-windows-amd64.msi          # MSI officiel Podman pour Windows
    ├── studioE5-agent-setup.exe                    # Package Inno Setup de l'agent
    ├── 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                          # Noyau WSL2 (optionnel, fallback)

Build

Ouvrir un terminal PowerShell dans ce dossier et exécuter :

dotnet build -c Release

Pour publier un exécutable autonome (pas besoin du runtime .NET sur le poste cible) :

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

Lexécutable se trouve dans :

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

Préparation du package

  1. Télécharger le MSI Podman Windows : https://github.com/containers/podman/releases Le renommer en podman-installer-windows-amd64.msi et le placer dans Resources/.
  2. Générer le package Inno Setup de lagent (studioE5-agent-setup.exe) et le placer dans Resources/.
  3. Télécharger le package WSL2 complet (offline) : https://github.com/microsoft/WSL/releases Par exemple : Microsoft.WSL_2.7.10.0_x64_ARM64.msixbundle. Le placer dans Resources/.
  4. Télécharger limage Podman machine pour WSL (offline) : https://github.com/containers/podman-machine-os/releases Par exemple : podman-machine.x86_64.wsl.tar.zst. Le placer dans Resources/.
  5. Télécharger Docker Compose standalone (offline) : https://github.com/docker/compose/releases Par exemple : docker-compose-windows-x86_64.exe. Le placer dans Resources/.
  6. (Optionnel, fallback) Télécharger le noyau WSL2 : https://github.com/microsoft/WSL/releases Par exemple : wsl.2.7.10.0.x64.msi, à renommer en wsl_update_x64.msi. Le placer dans Resources/.
  7. Builder et publier le wizard.

Lancement

Mode installation

.\StudioE5-SetupWizard.exe

Mode désinstallation

.\StudioE5-SetupWizard.exe /uninstall

Notes

  • Le wizard doit être exécuté en administrateur.
  • Linstallation de WSL2 nécessite un redémarrage de lordinateur. Le wizard senregistre dans RunOnce pour se relancer automatiquement.
  • Le wizard configure WSL2 avec 8 Go de RAM et 4 CPU via le fichier .wslconfig de lutilisateur.
  • Le MSI Podman doit correspondre à larchitecture x64.