Pour les cours avancés nécessitant du matériel embarqué (ex. Arduino) ou une machine virtuelle isolée (Ubuntu Lab VM), l’Agent Local (xkat-cli) relie votre navigateur à votre ordinateur en toute sécurité.
Sécurité : L’agent local n’ouvre aucun port sur Internet. Il communique exclusivement en interne sur votre machine (
localhost:127.0.0.1). Les commandes ne sont exécutées qu’avec votre accord.1. Démarrage Rapide (Quick Start)
Ouvrez le terminal de votre ordinateur (PowerShell, Terminal ou Bash) et exécutez cette commande :2. Guide par Système d’Exploitation
- Windows
- macOS
- Linux
Configuration sous Windows
- Terminal : Ouvrez PowerShell, Windows Terminal ou l’Invite de commandes (CMD).
- Commande :
- Machine Virtuelle (Lab VM) :
- Windows 10/11 64 bits recommandé.
- Ouvrez le Gestionnaire des tâches (Ctrl+Maj+Échap) → onglet [Performances] et vérifiez que Virtualisation : Activé est bien affiché.
3. Dépannage et FAQ (Troubleshooting)
Si vous rencontrez des difficultés de connexion, suivez les indications ci-dessous :1. Commande 'npx' ou 'node' introuvable
1. Commande 'npx' ou 'node' introuvable
Cela signifie que l’environnement Node.js n’est pas installé sur votre système.
- Windows : Téléchargez et installez la version LTS depuis nodejs.org ou via PowerShell :
- macOS : Installez depuis nodejs.org ou via Homebrew :
- Linux (Ubuntu/Debian) :
npx -y xkat-cli@latest up.3. Échec lors de la création ou du démarrage de la Machine Virtuelle (Lab VM)
3. Échec lors de la création ou du démarrage de la Machine Virtuelle (Lab VM)
- Virtualisation Windows :
- Si la virtualisation est désactivée dans le Gestionnaire des tâches, activez Intel VT-x ou AMD SVM dans les paramètres BIOS/UEFI au démarrage de votre PC.
- Réinitialisation complète de la VM :
- Lancez la commande suivante pour régénérer la VM proprement :
- Lancez la commande suivante pour régénérer la VM proprement :
4. Comment arrêter l'agent après la session de pratique
4. Comment arrêter l'agent après la session de pratique
Exécutez cette commande dans votre terminal pour libérer les ressources en arrière-plan :