Console VM navigateur
La console OpenFactory inclut un affichage navigateur basé sur noVNC pour les machines virtuelles en cours. Il peut montrer la sortie de boot et les bureaux graphiques et transmettre clavier et pointeur sans exposer un port VNC brut au navigateur.
Ouvrir une console
Ouvrez une VM en cours depuis la topologie ou la liste VM, puis choisissez Console. L’UI autorise le WebSocket pour l’utilisateur et la VM courants avant de le proxy vers le point de terminaison VNC local à l’hôte.
Il n’y a pas de contrat de deep-link stable documenté pour une boîte de dialogue console. Utilisez les contrôles VM dans l’application plutôt que de construire une URL.
Contrôles disponibles
La console bureau actuelle fournit :
- entrée clavier et souris ;
- clavier à l’écran ;
- Ctrl+Alt+Del ;
- mise à l’échelle fit-to-viewport ;
- reconnexion ;
- plein écran ; et
- fermeture.
La vue mobile fournit contrôles pointeur tactiles, clic gauche/droit, joystick et clavier logiciel de l’appareil. VNC mobile est view-only à la couche noVNC ; les contrôles mobiles séparés envoient l’entrée.
La synchronisation presse-papiers, modes qualité sélectionnables, changements de résolution pilotés invité, contrôles audio, menus de touches spéciales arbitraires et UI console série ne font pas partie du composant VNC actuel. Ne comptez pas sur ces comportements.
États de connexion
La boîte de dialogue distingue connecting, connected, reconnecting/booting et disconnected/error. Un handshake WebSocket réussi peut survenir avant que l’invité ait dessiné sa première frame non noire ; la console affiche donc une superposition booting et réessaie avec un backoff borné.
Si la VM n’a pas d’affichage VNC, est arrêtée, manquante ou qu’une autre session exclusive empêche la connexion, le backend ferme le WebSocket avec une raison spécifique et la boîte de dialogue présente un état retry ou erreur.
Frontière de sécurité
- La connexion navigateur production utilise un WebSocket authentifié sur TLS.
- Le backend vérifie l’accès VM avant d’ouvrir le proxy VNC.
- Le proxy se connecte uniquement au port VNC résolu sur l’hôte de virtualisation.
- Fermer la boîte de dialogue navigateur termine cette session navigateur ; cela n’arrête pas la VM.
L’accès console équivaut à un accès physique à l’affichage et au clavier invité. Évitez d’exposer des secrets à l’écran, verrouillez l’invité à la fin et fermez les consoles inutilisées.
Dépannage
Connecté mais écran noir
L’invité peut encore démarrer. Attendez la superposition boot avant de forcer une reconnexion. Si aucune frame n’apparaît après la fenêtre de retry, confirmez que la VM est en cours et possède un périphérique graphique VNC.
L’entrée n’atteint pas l’invité
Cliquez le viewport pour le focus. Sur mobile, utilisez les contrôles pointeur et clavier explicites de la console. Si l’invité est verrouillé, envoyez Ctrl+Alt+Del là où l’OS invité le supporte.
Déconnexions répétées
Fermez une autre session console pour la même VM, vérifiez que la VM est encore en cours et réessayez. Les échecs persistants doivent être signalés avec l’ID VM, l’horodatage, l’état de connexion et l’erreur affichée ; n’incluez jamais de jetons de session.
Affichage lent
Réduisez la résolution d’affichage invité et vérifiez la charge hôte/réseau. Le composant actuel utilise toujours fit-to-viewport et n’expose pas de sélecteur de qualité.