Vai al contenuto principale
Quando avvii ipmideck in un terminale, viene mostrata una console operatore interattiva: un header fissato con il banner e una barra di aiuto sopra un log scorrevole e dal vivo. Ogni azione è una singola pressione di tasto, niente menu, niente mouse. La console gira in-process accanto al server, così quello che vedi è lo stato dal vivo della macchina su cui sei.
La console compare solo su un vero terminale interattivo, sia stdin sia stdout devono essere TTY. Sotto Docker, systemd, o quando stdout è piped/ridiretto, ipmideck salta la console interamente e scrive solo log scorrevoli in chiaro. Vedi Dove compare la console.

​
Che aspetto ha

La console è una sola vista a schermo intero: un header fissato che vedi sempre, sopra un log dal vivo che scorre sotto di esso.
ipmideck interactive console showing the banner, help bar, status line, and the scrolling log panel
L’header non scorre mai. Le nuove righe di log compaiono nel pannello sotto di esso, e la riga più recente è sempre tenuta a schermo. Premi un singolo tasto per agire; tutto avviene in-process contro il server che hai appena avviato.

​
L’header

La cima dello schermo è un header fisso che non scorre mai. Si impila, dall’alto in basso:
  • Il banner di ipmideck.
  • La barra di aiuto: ogni tasto azione e cosa fa.
  • La riga di stato: lo stato dal vivo della sessione.
  • Una riga di crediti compatta (autore, versione, licenza).
Il corpo sotto l’header è la coda scorrevole del log. La riga più recente è sempre tenuta a schermo, così un URL o una conferma appena emersi non vengono mai tagliati in fondo.

​
Riga di stato

La riga di stato mostra tre campi dal vivo, separati da |:
  • Verbosità: il livello di log corrente (INFO, DEBUG o WARNING).
  • Client: il numero di client della dashboard connessi in questo momento.
  • last: l’ultimo tasto azione che hai premuto, come feedback visivo immediato.

​
Tasti azione

Ogni azione è una pressione di tasto. La barra di aiuto li elenca tutti:
TastoAzione
vCicla la verbosità del log
cApre la sotto-vista delle sessioni connesse
sApre la sotto-vista dei server configurati
uEmerge l’url della dashboard nel log
gControllo aggiornamenti (stampa la versione locale)
bApre l’editor di cambio bind
rRiavvia il server
qEsci, o torna alla vista log da una sotto-vista
ESCIndietro, torna alla vista log da una sotto-vista
I tasti freccia, funzione e di navigazione sono consumati e ignorati, non collidono mai con un’azione né contano come pressione di tasto.

​
v: verbosità

v cicla il livello di log a runtime attraverso un loop fisso a tre passi: 
INFO → DEBUG → WARNING → INFO
INFO è il predefinito. DEBUG mostra di più; WARNING mostra di meno. Il cambio ha effetto immediato per il resto della sessione e la riga di stato si aggiorna di conseguenza.
Il toggle della verbosità cambia solo il livello in esecuzione. Al boot successivo, il livello dalla tua config (o dalla variabile d’ambiente IPMIDECK_LOGGING_LEVEL) vince di nuovo. Vedi Configurazione.

​
c: sessioni

c apre la sotto-vista Sessioni connesse, una tabella in sola lettura dei client della dashboard attualmente collegati, con le colonne:
  • IP
  • Connesso dal
  • User-Agent
Premi q o ESC per tornare alla vista log.
Connected sessions table showing IP, Connected since, and User-Agent columns

​
s: server

s apre la sotto-vista Server configurati, una tabella in sola lettura dei BMC con cui ipmideck è configurato per parlare, con le colonne:
  • Nome
  • Host
  • Stato
Premi q o ESC per tornare alla vista log.
Configured servers table showing Name, Host, and Status columns with online and offline servers

​
u: url

u emerge l’URL della dashboard (scheme://host:port) nel corpo del log. Se il server è legato a un indirizzo wildcard (0.0.0.0, ::, o vuoto), l’URL viene riscritto a 127.0.0.1 così è effettivamente apribile in un browser, http://0.0.0.0:3000 è un indirizzo di ascolto, non uno navigabile.
The console log with the dashboard URL printed at the bottom after pressing u

​
g: aggiornamento

g stampa la versione locale e una nota che il controllo aggiornamenti online arriva con la release pip. Non fa alcuna chiamata di rete, ipmideck resta offline.

​
r: riavvio

r esegue un riavvio in-process pulito: ipmideck smonta la console, rilegge config.yaml, e riparte da capo. Usalo dopo una modifica di cambio bind per applicare il nuovo indirizzo.

​
q / ESC: esci e indietro

  • Da una sotto-vista (sessioni o server), q ed ESC ti riportano entrambi alla vista log.
  • Dalla vista log, q attiva un’uscita pulita, il server si arresta in modo pulito.

​
b: cambio bind

b apre l’editor di cambio bind, un prompt inline host:port che sostituisce la barra di aiuto mentre digiti. L’header mostra il bind corrente come etichetta in sola lettura current: host:port e un campo new: vuoto, così il valore che digiti compare immediatamente e non è mai confuso con quello esistente.
The change-bind editor showing the current bind address and an empty new field with apply, cancel, and delete key hints
Tasti dentro l’editor:
  • Enter: applica l’host:port digitato.
  • ESC: annulla senza cambiare nulla.
  • Backspace: cancella l’ultimo carattere.
  • Qualsiasi carattere stampabile, aggiunge al buffer.
L’input deve essere host:port con un host non vuoto e una porta che sia un intero nell’intervallo 1–65535. Su un inserimento valido, ipmideck conferma il nuovo bind e ti ricorda che è richiesto un riavvio (premi r). Su un inserimento non valido, segnala Invalid host/port e non cambia nulla.
Una modifica di cambio bind non è dal vivo, viene scritta nella config e ha effetto solo dopo un riavvio. Premi r per applicarla. E ricorda la precedenza: una variabile d’ambiente IPMIDECK_SERVER_HOST / IPMIDECK_SERVER_PORT o un flag esplicito --host / --port al boot successivo sovrascrive qualunque cosa la console abbia persistito. Vedi Configurazione.

​
Dove compare la console

La console interattiva è subordinata a una vera TTY: ipmideck la mostra solo quando sia stdin sia stdout sono terminali interattivi. Quando non lo sono, degrada a un banner più log scorrevoli in chiaro e non installa alcun listener di tasti, così nulla gira a vuoto su una non-TTY. Questo significa che la console compare quando esegui ipmideck direttamente in un terminale: 
ipmideck
Non compare quando:
  • Esegui sotto Docker: il container avvia uvicorn direttamente e non raggiunge mai il percorso della console; ottieni log di container in chiaro (docker logs).
  • Esegui sotto systemd o qualsiasi gestore di servizi dove stdout non è un terminale.
  • Pipi o ridirigi stdout (es. ipmideck > server.log): stdout non è più una TTY.
In ogni caso non-TTY il server gira comunque normalmente e si lega allo stesso default 0.0.0.0:3000; ottieni solo log in chiaro invece della console dal vivo.
ipmilink è un alias retrocompatibile per ipmideck, entrambi avviano la stessa console.

​
Prossimi passi