diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..245128c --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,35 @@ +# Contribuer + +## Règles de base + +- Ne jamais committer de credentials, mots de passe, clés SSH ou certificats privés +- Tester en `--dry-run` avant de pousser une modification +- Documenter tout changement de comportement dans `docs/` + +## Ajouter une étape + +1. Créer `scripts/admin/steps/06-.sh` +2. Ajouter l'étape dans `run-all.sh` : `STEP_ORDER=(01 02 03 04 05 06)` +3. Ajouter le nom dans la fonction `step_name()` +4. Documenter dans `docs/usage.md` + +## Modifier les valeurs par défaut + +Les valeurs par défaut des VMs sont en haut de `scripts/infra/deploy-vm.sh` : +```bash +DEFAULT_CORES=4 +DEFAULT_MEMORY=8192 +DEFAULT_DISK_GB=160 +``` + +## Tester + +```bash +# Dry-run complet +./scripts/admin/run-all.sh --vmid 9999 --name test --vlan 99 --dry-run + +# Vérifier la syntaxe bash +bash -n scripts/admin/run-all.sh +bash -n scripts/infra/deploy-vm.sh +for f in scripts/admin/steps/*.sh; do bash -n "$f" && echo "OK: $f"; done +``` \ No newline at end of file