Documentazione
Avvio rapido + descrizione di ogni funzione per ogni sezione e dispositivo (in continuo aggiornamento)
Gestione Docker
Questo documento spiega come gestire container, immagini e reti Docker sul server di destinazione tramite il pannello.
Prima di tutto: cos'è Docker
Docker è una tecnologia per «impacchettare ed eseguire software». Raggruppa l'applicazione e l'ambiente che le serve (librerie di sistema, dipendenze ecc.) in un «container», eseguibile con un clic su qualsiasi server con Docker installato, senza configurare l'ambiente a mano.
- Immagine: il «modello di pacchetto di installazione» del software (ad es.
nginx:latest) - Container: l'istanza dell'immagine «in esecuzione» (un software attivo)
- Rete: la modalità di comunicazione tra container, e tra container e host
Il pannello richiama da remoto Docker sul server di destinazione via SSH e offre un'interfaccia grafica per container/immagini/reti, risparmiandoti di ricordare i comandi docker.
Prerequisiti
Il server di destinazione deve avere Docker già installato. Se manca, in cima al pannello Docker c'è il pulsante «⚡ Installa Docker»: installazione con un clic (se il repository ufficiale non è raggiungibile ripiega automaticamente sui mirror nazionali, coprendo le distribuzioni principali come Debian/Ubuntu/CentOS/Rocky/AlmaLinux); l'avanzamento è mostrato in tempo reale nel pannello «Attività in background» in alto a destra, può essere interrotto a metà e al termine il pannello Docker si aggiorna da solo.
Scenari d'uso
- Distribuire e gestire varie applicazioni Docker
- Controllare stato e log dei container
- Avviare e arrestare container, pulire le immagini inutili
Funzionalità principali
Gestione dei container
| Operazione | Descrizione |
|---|---|
| Visualizza | elenca tutti i container (nome, immagine, stato, porte, risorse occupate) |
| Avvia / arresta / riavvia | controlla lo stato di esecuzione del container |
| Log | consulta i log del container in tempo reale |
| Elimina | elimina il container (con scelta se eliminare anche i volumi dati) |
| Apri terminale | entra nel container per eseguire comandi |
| Apri directory montata | un pulsante per ogni directory host (mount bind), che apre direttamente il gestore file per upload/download/modifica |
| Visualizza database | mostra con un clic le credenziali del database + distribuzione di phpMyAdmin con un clic per la navigazione visiva (solo siti installati con un clic) |
Accesso diretto alla directory montata
Nella colonna delle operazioni dell'elenco container, per ogni mount bind (directory host → directory container) compare un pulsante 📁 con il nome della directory (passa il mouse per il percorso completo). Facendo clic si passa automaticamente alla scheda «File» aprendo direttamente quella directory, da cui puoi caricare, scaricare, modificare ed eliminare i file del sito presenti nel container.
- Mostra solo i mount bind (directory reali dell'host); volumi anonimi / named volume non compaiono (gestiti internamente da Docker, nessuna operazione file necessaria).
- I container con più directory montate mostrano il numero corrispondente di pulsanti.
- Per esempio WordPress ha un pulsante per
/opt/sshe-wordpresse MySQL uno per/opt/sshe-mysql/data.
Consultazione del contenuto del database
Il pulsante 🗄 («Visualizza contenuto del database») nella colonna operazioni dell'elenco container legge il file delle credenziali generato all'installazione con un clic del sito, mostra host/nome/utente/password del database e supporta la distribuzione di phpMyAdmin con un clic (sceglie da solo una porta libera, entra nella stessa rete Docker, precompila i dati di accesso); con un clic navighi visivamente le tabelle, esegui query, importi ed esporti dati. Per i container non installati con un clic, al clic viene segnalata l'assenza di credenziali.
Gestione delle immagini
| Operazione | Descrizione |
|---|---|
| Visualizza | elenca le immagini locali (repository, tag, dimensione) |
| Scarica | scarica l'immagine dal repository |
| Elimina | elimina le immagini inutili |
Gestione delle reti
Visualizza e gestisci le reti Docker (bridge, host ecc.).
Rapporto con Catalogo app / Catalogo immagini
- Catalogo app: distribuzione con un clic di applicazioni pronte all'uso (scrive automaticamente docker-compose, configura porte e variabili d'ambiente)
- Catalogo immagini: sfoglia le immagini Docker più comuni, scarica/esegui con un clic
- Gestione Docker: operations quotidiano sui container/immagini già distribuiti
I tre collaborano: Catalogo app/Catalogo immagini si occupano dell'«installazione», la Gestione Docker della «gestione quotidiana».
Avvertenze
1. Le operazioni Docker vengono eseguite con l'identità dell'utente con cui ci si connette via SSH: di solito serve root o un utente nel gruppo docker.
2. Prima di eliminare un container verifica se vuoi conservare i volumi dati (dopo l'eliminazione i dati non sono più recuperabili).
3. Il pannello esegue i comandi docker da remoto via SSH, senza installare Agent aggiuntivi sul server di destinazione: zero impronta.
4. Installazione multi-distribuzione: il backend del pannello riconosce automaticamente il gestore di pacchetti del server di destinazione e traduce i comandi apt-get del Catalogo app nel corrispondente dnf/yum (famiglia RHEL) o apk (Alpine). Così anche su Rocky/CentOS/AlmaLinux applicazioni come «Installa Nginx» funzionano al primo tentativo, senza modificare i comandi a mano.