stephrobert/dsoxlab
stephrobert/dsoxlab has 113 GitHub stars and 5 forks. GitHot measured +1 stars in 24 hours. Last checked 2026-11-17 18:45 UTC. Last push 2026-11-14.
Progression mesurée des étoiles
- in 24h
- +1
- in 7 days
- Historique en cours
- in 15 days
- Historique en cours
- in 1 month
- Historique en cours
Variations nettes sur des périodes qui se chevauchent, pas des totaux quotidiens. Les mesures absentes restent vides. Les étoiles indiquent l’intérêt, pas la qualité.
À propos
Turn declarative exercises into reproducible, runnable and verifiable lab environments
Outils de développementREADME.fr.md
Originaldsoxlab — CLI DevSecOps XL Labs
Autre langue : English
dsoxlab transforme des exercices déclaratifs en environnements
reproductibles, exécutables et vérifiables. Un catalogue déclare ce qu'il
propose via un meta.yml à la racine et un lab.yaml par lab ; le moteur
provisionne ce que le lab demande, l'ouvre, et prouve le résultat par des tests
qui lisent l'état du système plutôt que les commandes tapées.
Rien de spécifique à un domaine ne vit dans le moteur : il sert aussi bien des labs Linux, Ansible, Kubernetes que Terraform, et tout autre catalogue qui respecte le contrat déclaratif. Il score aussi la progression et conserve l'historique en local, par catalogue.
Né pour accompagner les tutoriels de www.stephane-robert.info, et utilisable sans eux.
Deux façons d'entrer
| Installer l'outil | Télécharger l'appliance | |
|---|---|---|
| Pour | Linux, et macOS ou Windows si Python est là | Windows et macOS, ou qui préfère une machine jetable |
| Il faut | Python 3.11+ et uv ou pipx |
VirtualBox ou VMware, et 8 Go de RAM disponibles |
| On obtient | une commande, quelques mégaoctets | une VM Debian 13 avec bureau, Ansible et Terraform, ~450 Mo à télécharger |
| À lire | la section juste en dessous | L'appliance |
Sous Linux, installer l'outil est la bonne réponse : télécharger un demi-gigaoctet pour s'épargner une commande n'a aucun sens, et ce README le dit plutôt que de vendre les deux à égalité.
L'appliance quelques minutes après l'import : le bureau, 86 labs découverts, et le seul choix restant nommé avec la commande qui le règle.
Installer et jouer, en cinq minutes
Nécessite Python 3.11+ et uv
ou pipx pour l'installer. Rien à cloner, rien à compiler.
uv tool install dsoxlab # ou : pipx install dsoxlab
dsoxlab demo # installe un catalogue de démonstration d'un lab
cd ~/.local/share/dsoxlab/demo
dsoxlab course premiers-pas # la leçon
dsoxlab run premiers-pas # vous dépose dans le répertoire de travail
dsoxlab challenge premiers-pas # la mission
dsoxlab check premiers-pas # les tests, et la note
Le lab de démonstration a dsoxlab lui-même pour sujet, et ne demande ni VM, ni conteneur, ni Docker : il tourne partout où dsoxlab tourne.
Ou : l'appliance, en quatre étapes
Pour Windows et macOS, où uv tool install n'est pas une option. Aucune
connaissance de la virtualisation n'est nécessaire.
Installez VirtualBox depuis https://www.virtualbox.org/wiki/Downloads. L'Extension Pack proposé n'est pas nécessaire.
Téléchargez le fichier
.ovade la dernière release qui en porte un, et vérifiez son empreinte avec leSHA256SUMSpublié à côté.Importez et démarrez : dans VirtualBox, Fichier → Importer un appareil virtuel, choisissez le
.ova, Terminer, puis Démarrer. Le premier démarrage installe dsoxlab, les hyperviseurs et le bureau, puis redémarre tout seul : comptez cinq à quinze minutes, sans rien taper.Connectez-vous avec
student/dsoxlab— la machine exige de changer ce mot de passe, qui est public — puis, dans le terminal du bureau :dsoxlab demo && cd ~/.local/share/dsoxlab/demo dsoxlab course premiers-pas
Les labs vm demandent une étape de plus, la virtualisation imbriquée, qui
s'active sur votre ordinateur et non dans la machine : Configuration → Système
→ Processeur → Activer VT-x/AMD-V imbriqué, appliance éteinte. dsoxlab doctor le dit s'il manque.
Le détail de chaque étape, les prérequis chiffrés et un tableau de dépannage sont dans la page de l'appliance.
Les catalogues
Douze catalogues sont joués par ce moteur, et dsoxlab ne connaît aucun de
leurs sujets : chacun déclare tout dans son propre meta.yml et ses
lab.yaml. La table ci-dessous est mesurée sur le disque, jamais écrite
à la main, parce qu'une liste écrite de six en a caché six autres une fois.
| Catalogue | Labs | Ce qu'il enseigne |
|---|---|---|
ansible-training |
113 | Ansible, du premier playbook aux collections |
terraform-dsoxlab-training |
91 | Terraform et l'infrastructure as code |
linux-dsoxlab-training |
89 | Administration Linux, RHCSA et LFCS |
kubernetes-dsoxlab-training |
64 | Kubernetes sur cluster kubeadm, pour CKA, CKAD et CKS |
iam-dsoxlab-training |
16 | Gestion des identités et des accès, avec Keycloak et un annuaire |
devsecops-dsoxlab-training |
13 | DevSecOps, une application durcie version après version |
dev-pour-ops-dsoxlab-training |
10 | Le développement pour les Ops, autour d'un outil hérité |
python-dsoxlab-training |
7 | Python, la construction pas à pas d'un outil de sécurité |
cicd-dsoxlab-training |
5 | Les pipelines CI/CD, sur une forge locale et sans compte en ligne |
cloud-dsoxlab-training |
4 | Le cloud, pratiqué contre un émulateur local |
containers-dsoxlab-training |
1 | Les conteneurs, Docker, Compose et Swarm |
github-actions-training |
1 | GitHub Actions, des workflows rejoués en local |
414 labs dans 12 catalogues. Cette table est générée depuis src/dsoxlab/templates/catalogues.yml par scripts/gen-catalogues.py, le manifeste que lit dsoxlab catalog list.
Remettre votre résultat
Une preuve de ce que vous avez fait existe sous trois formes, et aucune ne
part d'elle-même : ni check, ni submit n'envoie quoi que ce soit.
dsoxlab submit <id> # affiche un lien qui porte le résultat
dsoxlab export -o preuve.json # la même preuve en fichier, portail ou pas
Quand un catalogue déclare un compte où se synchroniser, trois commandes apparaissent :
dsoxlab login # se connecter au portail que le catalogue déclare
dsoxlab push # envoyer vos tentatives, fusionnées avec ce que le compte porte
dsoxlab logout # oublier la session locale
push est la seule commande qui écrive sur votre compte, et elle n'écrit rien
quand le compte porte déjà exactement vos tentatives. La connexion est un flux
OAuth standard avec PKCE, et la session est liée au portail qui l'a émise : un
catalogue ne peut pas désigner un compte qui n'est pas le sien.
Ces trois commandes exigent un bloc learning.sync dans le meta.yml du
catalogue. Aucun catalogue public n'en déclare aujourd'hui : elles disent
donc qu'il n'y a nulle part où se connecter et nomment dsoxlab export, plutôt
que d'échouer obscurément.
Documentation
Chaque page nomme son public dès ses premières lignes, et l'index les répertorie toutes.
| Je veux… | Lire |
|---|---|
| Installer dsoxlab, jouer des labs, comprendre ma note | Pour l'apprenant |
Remettre un résultat : un lien, un fichier, ou un compte où push |
Pour l'apprenant |
| Jouer des labs sous Windows ou macOS, sans rien installer | L'appliance, une VM prête à jouer |
| Écrire mon propre catalogue de labs | Pour l'auteur de catalogue, puis le contrat v1 champ par champ |
| Monter les machines dont les labs ont besoin | Pour le formateur |
| Obtenir des VM jetables, sans aucun exercice à écrire | L'infrastructure sans labs |
| Appeler dsoxlab depuis un script ou une CI, et décider sur le résultat | Les codes de sortie, puis la sortie machine pour --json |
| Savoir où dsoxlab écrit sur mon disque | Où dsoxlab écrit |
| Voir toutes les commandes | Référence des commandes, produite par la CLI |
Dans le terminal, dsoxlab fullhelp affiche le guide complet de la plateforme,
en anglais comme en français.
Pourquoi dsoxlab
- Un moteur, plusieurs catalogues. Une seule CLI pilote tous les dépôts de
formation. On ajoute un domaine en écrivant un
meta.yml, pas en modifiant l'outil. - La validation prouve, elle ne fait pas confiance. Les labs sont évalués
sur l'état réel du système (
pytest-testinfra) et, quand le sujet le justifie, sur la persistance après reboot, le piège qui fait échouer les candidats RHCSA/LFCS. - Deux runtimes. Un lab se joue soit dans un shell sur votre machine, soit dans une vm provisionnée pour vous. Quel backend sert cette VM (KVM/libvirt, Incus, Outscale) est la décision du catalogue, pas celle du lab.
- Une progression qui persiste, par catalogue. Scores, coûts des indices et historique sont conservés dans le catalogue lui-même : deux catalogues ne mélangent jamais leurs historiques.
- Expérience bilingue. Chaque chaîne affichée existe en anglais et en
français (
DSOXLAB_LANG=en|fr).
Contribuer
git clone https://github.com/stephrobert/dsoxlab.git
cd dsoxlab
uv tool install --editable .
Voir CONTRIBUTING.fr.md pour l'installation de
développement, les contrôles de qualité et les règles non négociables (le moteur
reste neutre vis-à-vis du domaine, toute chaîne affichée passe par _() dans
les deux langues).
Sécurité
La posture de sécurité est appliquée, pas seulement affichée : chaque workflow est scanné par son propre outillage à chaque push et pull request.
- GitHub Actions durcies. Chaque action est épinglée par SHA de commit
complet, le token par défaut n'a aucune permission (chaque job demande le
strict minimum), et
checkoutne persiste jamais les identifiants. - zizmor analyse statiquement les
workflows à chaque PR (
ci.yml). - Plumber valide la CI/CD contre une politique de
confiance (
.plumber.yaml) au seuil de conformité 100%, et publie le badge de score (plumber.yml). - OpenSSF Scorecard suit la posture
supply-chain (
scorecard.yml). - Publication PyPI de confiance (OIDC). Les releases ne portent aucun token
durable et embarquent des attestations
PEP 740 (
release.yml). - Scan de secrets en pre-commit. TruffleHog et la détection de clés privées tournent en local avant chaque commit (voir CONTRIBUTING.fr.md).
Pour signaler une vulnérabilité, suivez SECURITY.fr.md.
La marque et ses fichiers sont documentés dans docs/brand.fr.md ; le nom et le logo ne sont pas couverts par la licence Apache 2.0.
Remerciements
Plusieurs personnes extérieures au projet ont amélioré dsoxlab en remontant ce sur quoi elles butaient, avec le diagnostic et souvent le correctif. Nommer ce que chaque retour a changé paraît plus utile qu'une liste de pseudonymes.
@cedric-ribier est le plus persévérant, et quatre versions viennent de ses remontées :
doctorne peint plus en rouge une installation saine à cause de tailles de disque nominales (0.1.94). Il a écrit que l'information était déroutante, ce qui était exactement le défaut : le contrôle comparait un maximum déclaré à une mesure ;- le provisionnement KVM fonctionne de nouveau sur libvirt 8 (0.1.92). Il a
reproduit le défaut
os.firmwaredu provider libvirt, documenté le contournement en amont, et c'est ce qui a rendu un correctif possible sur trois versions de libvirt ; - l'agent Incus est installé sur AlmaLinux, dont le noyau RHEL n'a pas le driver 9p, et l'attente de disponibilité des hôtes est devenue réglable (0.1.41). Les deux depuis un seul rapport, testé sur trois hôtes ;
doctornomme l'absence de virtualisation imbriquée au lieu de renvoyer au BIOS qu'une machine virtuelle n'a pas (0.1.95). Cela vient de son travail sur une image prête à l'emploi, discuté dans #91.
Et l'appliance elle-même est son idée. Il ne l'a pas demandée : il l'avait déjà construite de bout en bout, puis documentée dans #91. Celle que dsoxlab publie aujourd'hui s'inspire directement de la sienne — l'idée comme la démarche. C'est la contribution la moins visible dans un journal des modifications et la plus structurante pour le produit : sans elle, il n'y aurait rien à proposer à qui travaille sous Windows ou macOS.
@Gedd18 a trouvé que le conftest.py du
catalogue de labs ne se chargeait plus dès qu'aucun provider d'infrastructure
n'était résolu, ce qui bloquait en silence tous les labs shell, c'est-à-dire
les premiers qu'un apprenant joue. Sa traceback est ce qui a transformé une
chasse en correctif de cinq minutes.
@VictorVare a diagnostiqué deux labs dont
l'état de départ était inutilisable : un port 80 fermé sur un backend, et un port
LDAP fermé. Dans les deux cas, il a distingué No route to host de
Connection refused et d'une expiration, ce qui a nommé la cause au lieu de nous
laisser hésiter entre HAProxy, SELinux et le pare-feu.
Si vous butez sur quelque chose, le rapport vaut mieux que le contournement :
dsoxlab support --issue remplit le diagnostic pour vous.
Licence et attribution
Distribué sous licence Apache 2.0, voir LICENSE et NOTICE.
Vous pouvez utiliser, partager et adapter ce projet, y compris à des fins commerciales, à condition de créditer Stéphane Robert et de renvoyer par un lien vers https://www.stephane-robert.info, en indiquant si des modifications ont été apportées. Apache-2.0 conserve ces deux mêmes obligations, l'attribution et la mention des modifications, et y ajoute une concession de brevet explicite.
Jusqu'à la version 0.1.12 incluse, dsoxlab était distribué sous Creative
Commons Attribution 4.0 (CC BY 4.0). Cette concession est irrévocable : ces
versions restent disponibles sous CC BY 4.0. À partir de la 0.1.13, le
projet passe sous Apache-2.0 : les licences Creative Commons ne sont pas conçues
pour du logiciel, et celle-ci laissait la question des brevets ouverte tout en
faisant classer le paquet en Other/NOASSERTION sur PyPI.
© 2026 Stéphane Robert.