Yoctobe Middleware – Guide de déploiement sous Linux et Windows

Linux

Le déploiement sous Linux est simple. Ouvrez un terminal, rendez-vous dans le dossier deployment et exécutez :

./deploy.sh

Le script vérifie si Docker est installé et propose de l’installer automatiquement si vous êtes sur Ubuntu. Une fois terminé, le middleware est en cours d’exécution.

Pour l’arrêter :

./stop.sh

C’est tout pour Linux.

Windows

Avant de commencer – un mot sur la virtualisation

Docker sous Windows repose sur une technologie appelée WSL 2 (Windows Subsystem for Linux), qui nécessite elle-même que la virtualisation au niveau du processeur soit activée. Sur la grande majorité des machines vendues depuis 2015, ce paramètre (Intel VT-x ou AMD-V) est déjà activé par défaut dans le BIOS, vous n’aurez donc jamais besoin d’y toucher. Cependant, si Docker refuse de démarrer même après avoir suivi toutes les étapes ci-dessous, c’est la première chose à vérifier. Les instructions pour cela se trouvent en bas de ce guide.

Prérequis

• Windows 10 ou Windows 11
• Droits administrateur sur la machine
• Une connexion internet

Déploiement étape par étape

Étape 1 – Ouvrir une invite de commandes en tant qu’administrateur

1. Appuyez sur la touche Windows, tapez cmd.
2. Faites un clic droit sur Invite de commandes et choisissez Exécuter en tant qu’administrateur.
3. Cliquez sur Oui si Windows vous demande une confirmation.

Étape 2 – Naviguer vers le dossier du projet

Tapez la commande suivante en remplaçant le chemin par l’emplacement réel du projet sur votre machine :

cd C:cheminversvotreprojetdeployment

Par exemple, si le projet se trouve sur votre Bureau :

cd C:UsersVotreNomDesktopyoctobedeployment

Appuyez sur Entrée.

Étape 3 – Lancer le script de déploiement

deploy.cmd

Appuyez sur Entrée et laissez le script s’exécuter. Voici ce qu’il fait automatiquement :

• Vérifie si les fonctionnalités Windows nécessaires (WSL et Virtual Machine Platform) sont activées, et les active si ce n’est pas le cas.
• Vérifie si Docker Desktop est installé, et l’installe via winget si ce n’est pas le cas.
• Démarre Docker Desktop et attend qu’il soit prêt.
• Construit et démarre le conteneur Yoctobe middleware.

Si le script vous demande de redémarrer : Cela n’arrive qu’une seule fois, lors du tout premier déploiement, si des fonctionnalités Windows devaient être activées. Sauvegardez votre travail, redémarrez, puis rouvrez l’invite de commandes en tant qu’administrateur et relancez deploy.cmd. La deuxième exécution se déroulera sans redémarrage supplémentaire.

Étape 4 – Vérifier que le middleware est en cours d’exécution

Une fois le script terminé sans erreur, ouvrez votre navigateur et accédez à :

http://localhost:1881

Si vous voyez l’interface Yoctobe, le middleware est opérationnel.

Connexion d’instruments série / USB

Ports COM (RS-232 / RS-485)

Le script de déploiement détecte automatiquement les ports COM présents sur la machine et les expose dans le conteneur sous la forme /dev/ttyUSB0, /dev/ttyUSB1, etc.

• Si aucun port COM n’est détecté, le script vous demande si vous souhaitez continuer quand même. Répondez O pour continuer sans accès aux instruments, ou N pour annuler, brancher votre appareil, puis réessayer.
• Pour confirmer sur quel port COM se trouve votre instrument, ouvrez le Gestionnaire de périphériques → Ports (COM et LPT).

Appareils USB qui n’apparaissent pas comme ports COM

Certains instruments se connectent via USB brut plutôt que via un port série virtuel. Pour ces appareils, vous avez besoin d’un outil appelé usbipd-win. Installez-le en exécutant la commande suivante dans votre invite de commandes administrateur :

winget install usbipd

Après l’installation, exécutez :

usbipd list

Repérez votre appareil dans la liste, notez son BUSID (par exemple 2-3), puis attachez-le :

usbipd attach --wsl --busid 2-3

Relancez ensuite le déploiement (deploy.cmd) pour que le conteneur prenne en compte l’appareil nouvellement attaché.

Arrêter le middleware

stop.cmd

Ou, si vous préférez PowerShell :

.stop.ps1

Points d’accès disponibles

Résolution des problèmes

La commande docker est introuvable Docker Desktop n’est pas installé, ou il vient d’être installé et le terminal n’a pas encore pris en compte le nouveau PATH. Fermez l’invite de commandes, rouvrez-la en tant qu’administrateur, et réessayez. Si le problème persiste, installez Docker Desktop manuellement depuis https://www.docker.com/products/docker-desktop.

“Engine not reachable” ou Docker Desktop ne démarre pas Ouvrez Docker Desktop depuis le menu Démarrer et attendez qu’il affiche Engine running dans le coin inférieur gauche. Relancez ensuite deploy.cmd.

Le conteneur échoue avec une erreur de volume ou /dev Ouvrez Docker Desktop → Paramètres → Général et vérifiez que Use the WSL 2 based engine est bien coché. Mettez ensuite Docker Desktop à jour vers la dernière version.

L’instrument n’est pas visible dans le conteneur

• Port COM : vérifiez dans le Gestionnaire de périphériques que le port est bien listé et notez son numéro.
• USB : assurez-vous d’avoir exécuté usbipd attach comme décrit ci-dessus, puis relancez le déploiement.

Docker ne démarre pas du tout – problème BIOS possible Si Docker Desktop indique que la virtualisation n’est pas disponible, vous devez l’activer dans le BIOS :

1. Redémarrez la machine.
2. Entrez dans la configuration BIOS/UEFI (la touche est généralement F2, F10, Suppr ou Échap – elle s’affiche brièvement à l’écran au démarrage).
3. Recherchez un paramètre appelé Intel Virtualization Technology, VT-x ou AMD-V (il se trouve souvent dans une section Avancé ou Processeur).
4. Réglez-le sur Activé.
5. Sauvegardez et quittez. Windows démarrera normalement et Docker devrait fonctionner.

Si vous n’êtes pas sûr de la touche qui ouvre votre BIOS, recherchez en ligne le modèle de votre PC ou de votre carte mère suivi de « touche BIOS ».