EduBox Dev
fc61404271
- 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
106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# StudioE5 Setup Wizard
|
||
|
||
Assistant d’installation graphique Windows pour studioE5 Agent.
|
||
|
||
## Rôle
|
||
|
||
Ce wizard guide l’utilisateur pas à pas pour :
|
||
|
||
1. Vérifier les prérequis (RAM, disque, Windows, environnement virtuel, Podman).
|
||
2. Installer l’**environnement 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](https://dotnet.microsoft.com/download/dotnet/8.0)
|
||
- Visual Studio 2022 ou Visual Studio Code (optionnel)
|
||
|
||
## Structure
|
||
|
||
```text
|
||
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 :
|
||
|
||
```powershell
|
||
dotnet build -c Release
|
||
```
|
||
|
||
Pour publier un exécutable autonome (pas besoin du runtime .NET sur le poste cible) :
|
||
|
||
```powershell
|
||
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true
|
||
```
|
||
|
||
L’exécutable se trouve dans :
|
||
|
||
```text
|
||
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 l’agent (`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 l’image 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/`.
|
||
6. Builder et publier le wizard.
|
||
|
||
## Lancement
|
||
|
||
### Mode installation
|
||
|
||
```powershell
|
||
.\StudioE5-SetupWizard.exe
|
||
```
|
||
|
||
### Mode désinstallation
|
||
|
||
```powershell
|
||
.\StudioE5-SetupWizard.exe /uninstall
|
||
```
|
||
|
||
## Notes
|
||
|
||
- Le wizard doit être exécuté **en administrateur**.
|
||
- L’installation de WSL2 nécessite un **redémarrage** de l’ordinateur. Le wizard s’enregistre dans `RunOnce` pour se relancer automatiquement.
|
||
- Le wizard configure WSL2 avec **8 Go de RAM et 4 CPU** via le fichier `.wslconfig` de l’utilisateur.
|
||
- Le MSI Podman doit correspondre à l’architecture `x64`.
|