Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Load-Tests : tests de charge beWeapon sur Proxmox
Ce dépôt regroupe la chaîne complète utilisée pour les tests de montée en charge du client lourd beWeapon :
- construction d'un template Windows 11 (Packer) ;
- déploiement de N postes de test clonés depuis ce template (OpenTofu + Ansible, script
Deploy) ; - exécution d'une campagne de test pilotée par Appium/WinAppDriver (
hypervisor.sh) ; - collecte des résultats (CSV).
Les améliorations proposées sont listées dans Ameliorations.md.
1. Architecture
Poste admin
│ ssh installer@192.168.100.253
▼
Stid-GW (VM 111) ─── 192.168.100.253 / 192.168.110.x / 192.168.111.x
│ ssh 192.168.111.252 (clé de installer@stid-gw)
▼
stid-bastion (VM 100, 192.168.111.252, compte installer)
│ Packer, OpenTofu/Ansible (conteneur docker stid:1.3), scripts Python de test
│ API Proxmox https://192.168.111.220:8006
▼
pmx-002 (Proxmox, 192.168.100.220 / 192.168.111.220)
├── beWeapon-0..29 VM 400..429 Windows 11, Appium/WinAppDriver, beWeapon (vmbr2, DHCP 192.168.111.x)
├── beWeaponDB VM 230 Windows, SQL Server, base Omnitrack (192.168.111.200)
├── SqlServer VM 103
├── Stid-GW VM 111
└── template VM 1051 Win11-beWeapon-nov2026 (source des clones)
Les postes de test sont sur vmbr2 (192.168.111.0/24). Ce réseau n'a pas de lien
physique : il n'est joignable que depuis le bastion, la passerelle et le serveur Proxmox.
2. Arborescence
Emplacement réel : /data/Installer/Load-Tests sur stid-bastion.
| Dossier | Contenu | Ancien emplacement (lien symbolique conservé) |
|---|---|---|
template/ |
Build Packer du template Windows 11 | /data/Installer/MyTemplate |
deploy/ |
OpenTofu (main.tf) + playbooks Ansible, liste des postes machines_ip.csv |
/data/Tofu |
bin/Deploy |
Menu de déploiement des postes | /usr/local/bin/Deploy (lien) |
tests/ |
Scénarios de test beWeapon-LT (Python/Appium) | /data/stid-beweapon/beWeapon/beWeapon-LT |
archives/ |
Résultats et journaux des campagnes passées (hors git) | — |
Les anciens chemins restent valables grâce aux liens symboliques : les habitudes, le
script Deploy (qui monte /data/Tofu dans docker) et les environnements Python
(chemins absolus dans lt-env et dans le venv de deploy/) continuent de fonctionner.
Dépôts git
| Dossier | Dépôt | Remarque |
|---|---|---|
Load-Tests/ |
gitea.easylinux.fr/easylinux/Bastion-Stid |
Ce dépôt : template, deploy, bin, documentation |
tests/ |
o.gillet/beWeapon-LT (alias ssh gitea-jump) |
Dépôt indépendant, exclu de ce dépôt |
/data/stid-beweapon |
gitea.aipice.local/HEXA-H/stid-beweapon |
Ancien dépôt, contient aussi une copie de beWeapon-LT (voir Ameliorations.md) |
Ne sont pas versionnés (voir .gitignore) : jetons API Proxmox (*.tfvars,
*.tfstate, my.pkrvars.hcl, deploy/proxmox-secret.yml), venv Python, ISO et
installeurs (template/tmp/, template/iso/install/, *.iso), résultats (archives/).
Les mots de passe de test (compte Windows installer, sa SQL Server) sont versionnés
volontairement : ils ne servent qu'à cet environnement isolé.
Dossiers obsolètes (à ne plus utiliser)
/data/Installer/Template: ancienne version du build Packer./data/stid-beweapon/beWeapon/LoadTests: ancienne version des scénarios (remplacée par beWeapon-LT)./data/stid-beweapon.old,/usr/local/bin/Deploy.old, fichiers*.bak*.
3. Étape 1 : construire le template (Packer)
Dossier : template/
cd /data/Installer/Load-Tests/template
./build.sh # packer build -var-file=my.pkrvars.hcl -var-file=windows-11.pkrvars.hcl -on-error=ask .
| Fichier | Rôle |
|---|---|
generic.pkr.hcl |
Source proxmox-iso + liste des scripts de provisioning |
variables.pkr.hcl |
Déclaration des variables et valeurs par défaut |
my.pkrvars.hcl |
Connexion Proxmox (jeton API), nœud, vmid, stockages (secret, hors git) |
windows-11.pkrvars.hcl |
ISO Windows 11 25H2, ISO virtio-win, taille disque |
iso/ |
Autounattend.xml, setup.ps1, generalize.ps1 et installeurs → unattended-win.iso |
http/*.ps1 |
Scripts de provisioning exécutés via WinRM |
Ordre des scripts de provisioning (generic.pkr.hcl) :
| Script | Rôle |
|---|---|
Drivers.ps1, GuestTools.ps1 |
Pilotes virtio et agent QEMU |
DotNet.ps1, Windows.ps1 |
Runtimes .NET 10 (x64) et Windows Desktop (x86) |
s0_autologon.ps1 |
Ouverture de session automatique du compte Installer (indispensable pour l'UI Automation) |
s1_beweapon.ps1 |
Installation de beWeapon (setup_weapon_tracer*.msi, OmnitrackSettings) |
s2_appium.ps1 |
Node.js, Appium, WinAppDriver |
s3_pysnapcap.ps1 |
Extraction de l'outil pysnapcap |
s4_dotNet.ps1 |
.NET Framework 3.5 |
s6_tasks.ps1 |
Copie des scripts de démarrage (start_beweapon.ps1…), pilotes système, mode développeur Windows (requis par WinAppDriver) |
s5_com0com.ps1 (ports série virtuels) et s7_CDremove.ps1 existent mais ne sont pas appelés.
Le template produit porte le vmid défini dans my.pkrvars.hcl (actuellement 901),
alors que le déploiement clone le template 1051 (deploy/terraform.tfvars).
Après un nouveau build, il faut mettre à jour vm_template_id.
4. Étape 2 : déployer les postes (Deploy)
Deploy # menu interactif
| Choix | Action | Commande exécutée dans le conteneur stid:1.3 (dossier deploy/ monté sur /data) |
|---|---|---|
| 1 | Déploiement de N postes (1 à 30) | tofu apply -var="vm_count=N" -auto-approve |
| 2 | Démarrage des postes + récupération des IP | ansible-playbook start-2.yaml |
| 3 | Arrêt des postes | ansible-playbook stop.yaml |
| 4 | Suppression des postes | tofu destroy -auto-approve |
| I | Information (IP des postes) | ansible-playbook info.yaml |
Caractéristiques des postes (deploy/main.tf) : VM beWeapon-<n>, vmid 400+n,
clone lié du template 1051 sur PVE-Thin, 4 vCPU x86-64-v2-AES, 6 Go de RAM,
carte réseau e1000 sur vmbr2.
Les IP (DHCP) sont lues par l'agent QEMU et écrites dans deploy/machines_ip.csv
(Nom_VM,ID_Proxmox,Adresse_IP). Ce fichier est l'entrée de la campagne de test.
Le jeton API Proxmox des playbooks est dans deploy/proxmox-secret.yml (hors git,
modèle : proxmox-secret.yml.sample). Celui d'OpenTofu est dans deploy/terraform.tfvars.
Séquence habituelle : 1 (déploiement) → 2 (démarrage + IP) → attendre que Windows ait fini de démarrer → campagne.
5. Étape 3 : lancer une campagne (hypervisor.sh)
cd /data/Installer/Load-Tests/tests # obligatoire : les scripts utilisent des chemins relatifs
./hypervisor.sh # 1 palier de 30 postes × 200 utilisateurs (comportement historique)
# Campagne par paliers (montée en charge) :
PALIERS="1 5 10 20 30" USERS_PER_WKST=10 RETURN_TIME=60 ./hypervisor.sh
# Campagne longue détachée de la session ssh :
PALIERS="1 5 10 20 30" USERS_PER_WKST=10 RETURN_TIME=60 \
setsid nohup ./hypervisor.sh > ../archives/campagne_$(date +%Y%m%d_%H%M).log 2>&1 < /dev/null &
Déroulement de hypervisor.sh :
- arrête les sessions Python d'un test précédent (
pkill) ; - active le venv
lt-env; - lit les IP dans
/data/Tofu/machines_ip.csv; - vérifie les postes avec
check_wkst.py(VM joignable, Appium, beWeapon). Si un poste est KO, le test est annulé ; - archive le contenu de
results/dans../archives/results_<date>; - pour chaque palier, appelle
run-XP.sh 9995 9985 1 1 <USERS_PER_WKST> <IP des N premiers postes>.
run-XP.sh <users_db> <items_db> <pause> <nb_sites> <users_par_poste> <postes...> :
| Étape | Script | Rôle |
|---|---|---|
| 1 | Generate-Users.py, Generate-Items.py |
Génère results/NewUsers.sql, results/NewItems.sql |
| 2 | Import-Users-SQLcmd.py, Import-Items-SQLcmd.py |
Import dans la base Omnitrack (192.168.111.200) |
| 3 | Generate-Yaml.py |
Répartit utilisateurs et équipements par poste → results/inputs-xp.yaml |
| 4 | s1_a_RFID_time_beWeapon.py |
Scénario : un processus par poste, pilotage de beWeapon via Appium |
Les étapes 1 et 2 ne sont exécutées qu'au premier palier (SKIP_DB=1 ensuite).
Variables d'environnement
| Variable | Défaut | Effet |
|---|---|---|
PALIERS |
30 |
Liste des nombres de postes à tester successivement |
USERS_PER_WKST |
200 |
Utilisateurs (sessions) enchaînés par poste |
RETURN_TIME |
300 |
Secondes entre la sortie et le retour d'un équipement |
USER_PAUSE |
0 |
Pause entre deux utilisateurs d'un même poste |
CHECK_WKST=0 |
Désactive la vérification préalable des postes | |
REPAIR_WKST=1 |
Tente de réparer les postes (relance d'Appium, pare-feu) avant la vérification | |
SKIP_KO=1 |
Lance le test sans les postes KO | |
SKIP_DB=1 |
Ne régénère pas et ne réimporte pas utilisateurs et équipements |
Scénario s1_a_RFID_time_beWeapon.py
Pour chaque poste (en parallèle), après un délai aléatoire de 10 à 120 s, puis pour chaque utilisateur :
- connexion à beWeapon (
LOGIN_OUTPUT) ; - changement de site (
CHANGE_LOCATION) ; - sortie de l'équipement par RFID (
EQUIPMENT_OUTPUT) ; - déconnexion (
LOGOUT_OUTPUT) ; - attente de
RETURN_TIMEsecondes, puis connexion, retour de l'équipement et déconnexion (*_INPUT).
Un temps de réflexion de 2 s sépare les actions.
6. Résultats
Dossier tests/results/ (campagne en cours), puis archives/results_<date>/ :
| Fichier | Contenu |
|---|---|
detailed_user_metrics.csv |
Une ligne par étape : date, site, poste, utilisateur, étape, PASS/FAIL, durée (s), erreur |
global_metrics.csv |
Une ligne par palier : nb postes, utilisateurs/poste, succès, échecs, temps moyens par type d'étape |
logs.csv |
Journal détaillé de tous les processus |
inputs-xp.yaml |
Jeu de données du test (contient des mots de passe) |
NewUsers.sql, NewItems.sql, sites.json |
Données injectées dans la base |
Outils annexes dans tests/ :
| Script | Rôle |
|---|---|
check_wkst.py [--check-only] |
Vérifie (et répare) Appium, beWeapon et le pare-feu de chaque poste via WinRM |
etat_vms.py |
Relevé de l'état des postes (CSV dans etat_vms/) |
beweapon_metrics.py --since "AAAA-MM-JJ HH:MM" |
Récupère les métriques collectées sur les postes |
Process_results.py |
Mise en forme des résultats (non appelé par défaut) |
7. Dépannage
| Symptôme | Piste |
|---|---|
Test ANNULÉ : n poste(s) KO |
REPAIR_WKST=1 ./hypervisor.sh ou python check_wkst.py |
| Pas d'IP pour un poste | Agent QEMU non démarré : relancer 2 dans Deploy, vérifier la VM dans Proxmox |
| Échecs Appium en série | Session Windows verrouillée ou fermée (connexion RDP sur le poste) : redémarrer le poste |
ConnectionRefusedError dans le journal |
Le gestionnaire multiprocessing a été tué (pkill d'un autre lancement en parallèle) : ne lancer qu'une campagne à la fois |
| Accès au bastion | Uniquement par rebond : ssh installer@192.168.100.253 puis ssh 192.168.111.252 |