Ouvrir la console série d'une machine virtuelle
Le seul accès de secours du produit : ouvrir un terminal dans le navigateur, se connecter en un clic ou par un lien profond, et reconnaître une console qui reste déconnectée pour la rétablir en une action.
Exploiter au quotidien8 min de lectureUtilisateur propriétaire de la machine
Ce que vous obtenez : Un terminal connecté au port série de la VM, utilisable même si le réseau de la machine est cassé, et le bon réflexe quand la console reste bloquée sur « Déconnecté ».
Avant de commencer
- Une VM en cours d'exécution : le sélecteur de la console ne liste que les machines
running, et les boutons « Console » des autres écrans n'apparaissent que sur une machine allumée. - Un navigateur sans extension qui bloque les WebSocket : la console passe par un
wss://sur le même domaine.
1.Trois portes d'entrée, une seule console
L'écran s'appelle Console série (/app/shell). Il s'ouvre depuis n'importe quel écran de machines, et l'adresse suffit : /app/shell?vm=<nom> branche la console toute seule, sans clic. C'est le chemin à utiliser dans un lien, un ticket ou un signet, et le plus rapide à la main.
- VMs
- Cliquer la ligne de la VM
- Bouton « Console » de la barre du haut
Le bouton n'existe que si la machine tourne. La barre affiche alors, de gauche à droite : Console, Arrêter, Publier, Supprimer.
Quand aucune machine n'est choisie, par exemple à l'adresse /app/shell sans paramètre, le terminal affiche : « Sélectionnez une VM dans le sélecteur ci-dessus pour ouvrir la console. », et une ligne d'aide rappelle en bas : « Sélectionnez une VM dans le panneau de droite et cliquez sur la VM ou sur « Connexion » ». Rien ne se connecte tant qu'on n'a pas désigné une machine.
Running, avec leurs ressources et leur projet. (cliquez la capture pour l'agrandir)2.Le lien profond qui connecte tout seul
L'adresse /app/shell?vm=<nom-de-la-vm> déclenche l'auto-connexion : la page attend que la liste des machines soit chargée, vérifie que la machine existe et qu'elle tourne, puis ouvre la session seule. Rien à cliquer.
- Le nom dans l'adresse est celui de la VM, tel qu'affiché partout ailleurs. Après un renommage, l'ancienne adresse ne redirige pas.
- L'auto-connexion ne joue qu'une fois par visite : si vous cliquez sur Déconnecter, elle reste désarmée jusqu'au prochain chargement de page.
- Si la machine est arrêtée, la console affiche un écran d'attente avec un bouton Démarrer ; elle se reconnecte deux secondes après le démarrage.
/app/shell?vm=site-vitrine : le badge est ● CONNECTÉ, le terminal rejoue le journal de démarrage (« Ubuntu 24.04 LTS site-vitrine ttyS0 », « site-vitrine login: »), et le sélecteur VM : est grisé parce qu'une session est en cours. (cliquez la capture pour l'agrandir)3.Ce qu'on peut faire dans la session
Une fois le badge sur ● CONNECTÉ, chaque touche part directement à la machine : c'est un vrai terminal, pas une fenêtre en lecture seule. Le badge ne passe à « Connecté » qu'à la première donnée reçue de la machine, pas à l'ouverture du WebSocket : quelques secondes de silence sont normales.
| Ce qu'on fait | Comment | Ce qu'il faut savoir |
|---|---|---|
| Se connecter | Choisir la VM dans « VM : », puis Connexion | Le bouton reste « Connexion » tant que la première donnée n'est pas arrivée : un clic supplémentaire relance une tentative. |
| Se déconnecter | Bouton Déconnecter, ou Ctrl+O dans le terminal | Ctrl+O fait retomber le badge sur ● DÉCONNECTÉ. La déconnexion est volontaire : la reconnexion automatique est désarmée. |
| Changer de machine | Panneau MACHINES à droite, ou Déconnecter puis le sélecteur | Le sélecteur est grisé pendant une session : il faut d'abord se déconnecter. Le changement de machine ne garde pas d'historique : le bouton Précédent ne revient pas à la machine précédente. |
| Voir le démarrage | Rien à faire | La console rejoue le journal de la machine avant de brancher le direct. Le rejeu est borné : sur une machine qui écrit beaucoup, le début peut manquer. |
| Nettoyer l'écran | Ctrl+L | C'est la machine invitée qui l'interprète, pas le navigateur : cela dépend de son système. |
Les messages d'erreur ne s'affichent jamais dans le terminal
Quand la session se ferme, l'écran du terminal est détruit. Ne cherchez donc pas l'explication d'un échec dans le terminal : elle vit dans le bandeau au-dessus du terminal (et, quand il y en a un, dans un message temporaire en bas à droite).
Une seule console par personne et par machine
Le verrou est tenu par couple (vous, cette machine). Ouvrir la même console dans un second onglet échoue d'abord, puis réessaie automatiquement jusqu'à trois fois avant d'afficher un message définitif. Deux personnes différentes peuvent en revanche ouvrir chacune la leur.
4.Reconnaître une console qui reste déconnectée
Une console peut rester bloquée sur ● DÉCONNECTÉ après plusieurs tentatives. Voici comment la reconnaître, et la marche à suivre pour la rétablir.
- 1
Le symptôme
On ouvre
/app/shell?vm=<nom>sur une machine qui tourne. Il ne se passe rien de visible dans le terminal, puis le bandeau au-dessus du terminal porte le diagnostic. Deux bandeaux très différents se rencontrent ici, et ils ne disent pas la même chose : les deux étapes suivantes les séparent. - 2
Ce que le bandeau dit quand le serveur a fermé la console
Quand le raccordement est mort, le bandeau porte un statut court, écrit en rouge : « Console perdue, machine en marche ». Si l'invitée était déjà arrêtée, il dit « Console perdue, machine déjà arrêtée », et la console montre la dernière sortie conservée de son journal. L'explication qui tenait dans ce bandeau vit dans le piège « Une console perdue ne revient jamais toute seule ».
- 3
Le code du serveur, et pourquoi il est traduit
Le serveur n'écrit plus de phrase : il ferme en posant un code court, comme
console_lost_vm_runningouconsole_socket_missing. L'interface le traduit en un statut d'une ligne, et le code brut ne s'affiche jamais. Un code qu'elle ne connaît pas retombe sur « Console perdue, machine en marche ». - 4
Ce que le bandeau dit quand c'est un verrou
S'il n'y a aucune raison serveur à afficher, le navigateur réessaie trois fois en annonçant « nouvelle tentative (n/3)… », puis conclut : « Impossible d'ouvrir la console : une autre session la détient probablement encore. Fermez l'onglet qui l'utilise s'il est ouvert, puis Réessayez en cliquant sur « Connexion ». »
- 5
Pourquoi un verrou arrive sans raison du serveur
Un verrou est refusé avant l'ouverture de la WebSocket : le navigateur n'y reçoit alors qu'une raison VIDE. Une raison non vide veut donc dire « console perdue », et jamais « console occupée ».
- 6
Le diagnostic à retenir
Si le bandeau parle d'une autre session, vérifiez qu'aucune autre fenêtre n'utilise la console : c'est le seul cas où ce message peut être faux. S'il annonce une console perdue, aucune autre fenêtre n'est en cause, le blocage vient de la machine elle-même, et sa console demande un redémarrage pour être rétablie.
- 7
La marche à suivre
Arrêtez la machine depuis l'interface, puis cliquez sur « Démarrer ». Ce démarrage-là recrée une console neuve, et le lien profond se reconnecte alors seul. Un redémarrage demandé dans l'invitée, lui, n'en recrée aucune : le service de console s'arrête avec la machine et rien ne le relance.
- 8
Comment en être sûr avant d'arrêter la machine
Ouvrez la fiche d'une autre machine en marche et sa console : si celle-là se connecte normalement, le problème est propre à la machine récalcitrante et non à votre compte ou à votre navigateur.
Aucun redémarrage automatique, jamais
La plateforme ne redémarre jamais la machine d'elle-même pour lui rendre une console : un raccordement perdu est constaté, la console est marquée indisponible, et la machine reste en marche. Le redémarrage est un geste de votre part, et lui seul, parce qu'il efface l'état de la machine.
Le remède interrompt la machine
Redémarrer la VM coupe le service qu'elle héberge le temps du démarrage. Une machine qui exécute une base de données ou un site en production ne se redémarre pas pour retrouver une console : si la machine est déjà pilotée à distance (SSH, gestionnaire de service), c'est ce canal qu'il faut utiliser en attendant son prochain redémarrage planifié.
Le réflexe à retenir
Lisez d'abord ce que le bandeau annonce. S'il parle d'une autre session, fermez l'autre onglet et cliquez « Connexion ». S'il annonce une console perdue, chercher un autre onglet ne servira à rien : seul un arrêt suivi d'un Démarrer depuis l'interface rétablit la session.
Reconnaître les trois cas de la même façon au premier coup d'œil
| Ce que vous voyez | Ce qui se passe vraiment | Ce qu'il faut faire |
|---|---|---|
| Un bandeau rouge « Console perdue, machine en marche » | Le raccordement de console de cette machine a été perdu : la connexion est refusée, pas occupée, et la machine continue de tourner | Arrêter la machine depuis l'interface, puis cliquer sur Démarrer : ce démarrage recrée la console, et il efface l'état de la machine |
| « nouvelle tentative (n/3)… », puis un bandeau qui parle d'un autre onglet, alors que la console est réellement ouverte ailleurs | La console est bien tenue par une autre fenêtre ou un autre onglet ; le refus tombe avant l'ouverture, donc sans raison du serveur | Fermer l'autre onglet, puis « Connexion » |
| Écran « VM arrêtée », « VM en erreur » ou « Transitions… » au lieu du terminal | La machine n'est pas en marche : rien à connecter | Bouton Démarrer dans l'écran, puis la console se connecte seule ~2 s après |
Le bandeau distingue les deux premiers cas, et c'est le serveur qui le lui permet : un raccordement perdu se referme après l'ouverture, en y écrivant son diagnostic, alors qu'un verrou est refusé avant l'ouverture, sans aucun texte. Un bandeau qui parle d'une autre session est donc un vrai verrou ; un bandeau qui annonce une console perdue est un raccordement mort.
En cas de doute, le test qui tranche reste celui de la ligne suivante : essayez une autre machine en marche. Si sa console s'ouvre, le problème est bien celui de la machine, et le remède est un arrêt suivi d'un Démarrer depuis l'interface.
5.Quand la machine redémarre ou que la session tombe
Un arrêt ou un redémarrage de la machine coupe la console. L'interface tente alors de reprendre la main toute seule, avec un nombre de tentatives borné, et affiche l'avancement dans le terminal (ligne [Console] …) autant que dans le bandeau.
- Une machine qui revient vite : la session se rétablit sans intervention.
- Une machine longue à démarrer : les tentatives s'épuisent et la session retombe. Cliquez Connexion quand la machine est
running: le rejeu du journal vous montrera ce qu'elle a démarré pendant ce temps. - Après un redémarrage demandé depuis l'interface (arrêt, puis Démarrer), votre console est neuve : c'est aussi ce qui la répare dans le cas du raccordement perdu décrit plus haut.
La console ne suit pas la taille de la fenêtre
La largeur du terminal est fixée au moment de l'ouverture. Agrandir la fenêtre du navigateur ne change pas la largeur vue par la machine invitée : les lignes longues continuent d'être coupées à l'ancienne largeur. Rechargez la page pour repartir d'une taille propre.
Les pièges, en résumé
Une console perdue ne revient jamais toute seule
Une console perdue ne revient jamais d'elle-même : aucune réparation automatique, et attendre ne la fera pas revenir. Un redémarrage demandé dans l'invitée n'en recrée aucune, et rien ne rattache une console à une machine qui tourne déjà. Ce qui la recrée, c'est un démarrage demandé depuis le front, « Démarrer » après un arrêt, et il efface l'état de la machine : c'est votre choix.
Le sélecteur ne liste que les machines allumées
Le sélecteur « VM : » d'une console sans session ne montre que les machines en cours d'exécution. Une machine arrêtée n'y figure pas : il faut la démarrer d'abord.
Le sélecteur est grisé pendant une session
Pour changer de machine, il faut d'abord cliquer sur « Déconnecter ».
Déconnecter désarme la reconnexion automatique
Après un Ctrl+O ou un clic sur « Déconnecter », la console ne cherche plus à se reconnecter : il faut recharger la page ou cliquer « Connexion ».
Les erreurs ne s'affichent jamais dans le terminal
L'écran du terminal est détruit à la fermeture de la session. Les explications sont dans le bandeau au-dessus, jamais dans les dernières lignes affichées.
Une seule console par personne et par machine
Un second onglet sur la même VM est refusé puis retenté automatiquement trois fois avant un message définitif.
Ce guide est-il a jour ?
Chaque affirmation de cette page a ete verifiee sur le produit avant publication, et ce qui n'etait pas verifie n'a pas ete ecrit. Une page peut cependant vieillir avant le produit : si un ecran ne correspond plus a ce que vous voyez, dites-le, la page sera reprise.
Prêt à créer vos premières VMs ?
30 secondes d'inscription. 2 secondes pour la première VM. Zéro engagement.