Centro pacchetti e container

6 min · 10 sezioni

Il NAS esegue applicazioni — un server di film con le copertine, un cloud privato, il blocco della pubblicità di tutta la casa — ognuna chiusa nel suo container, senza toccare il sistema. Il Centro pacchetti le installa e le aggiorna con un clic; l'app Container mostra il meccanismo che c'è sotto, per quando serve guardare.

Serve un volume creato: le applicazioni e i loro dati vivono nel volume (<pool>/apps/<applicazione>/), mai nel disco di sistema — un'app che ingrassa non può lasciare il NAS senza spazio per aggiornarsi.

Installare

Scegli l'app nel catalogo —per categorie o cercando— e «Installa». Il download e l'avvio girano come attività con avanzamento; alla fine, le app con interfaccia web hanno il pulsante «Apri», che ti porta nella loro schermata. Ogni applicazione conserva le sue cose nella sua cartella dei dati dentro il volume: reinstallarla o aggiornarla non tocca ciò che è salvato.

«Aggiorna» scarica la versione nuova dell'immagine e ricrea il container con le stesse impostazioni. I dati non vengono nemmeno guardati: sono nella loro cartella, fuori dal container.

Il catalogo

Il catalogo contiene 1058 applicazioni, tutte di altri sviluppatori, curate da noi e provate una a una: ogni ricetta viene installata davvero, si apre la sua pagina web e si rimuove prima di entrare. Hanno la loro categoria, la loro icona e una versione fissa: un'applicazione non cambia versione da sola, e «Aggiorna» la porta all'ultima quando lo chiedi. Le ricette puntano i loro dati alla cartella dei dati del NAS, quindi la regola «tutto nel volume» vale per tutte.

Porte e cartelle

Ogni app installata ha il suo pulsante «Porte e cartelle»:

• Porte: quale porta del NAS porta a quale porta dentro il container. Se quella proposta dalla ricetta si scontra con qualcosa di tuo, si cambia qui e l'app si ricrea con la nuova.
• Cartelle: quali cartelle del NAS vede l'app al suo interno. È il modo di dare a un server di film la tua cartella Film, o di far vedere a un'app di backup ciò che deve copiare.

Per ciò che la schermata non copre c'è la modifica avanzata: la ricetta completa (docker compose) e le sue variabili, modificabili così come sono. Con una rete di sicurezza: quando applichi, i container si ricreano con la ricetta nuova e, se non si avviano, si ripristina da sola la configurazione precedente — un errore di sintassi non ti lascia l'app morta.

Accelerazione video

Se il NAS ha una grafica integrata (Intel o AMD), Jellyfin e Plex possono usarla per convertire video senza caricare il processore: è la differenza tra vedere un film e vedere una rotellina. Quando le installi compare l'interruttore «Accelerazione video», e per un'app già installata è in «Porte e cartelle». È l'unica cosa del dispositivo che un'applicazione può ricevere: la grafica; né dischi né altri dispositivi.

Una scheda Nvidia

Se il NAS ha una scheda Nvidia, lo stesso interruttore serve per lei appena si verificano tre cose: che il driver sia caricato (esiste /dev/nvidia0, che compare dopo averlo installato e riavviato, o eseguendo nvidia-smi una volta), che sia installato il runtime per container di Nvidia, e che quel runtime sia registrato in Docker. È roba di una volta sola, dalla console del NAS:

sudo apt install nvidia-driver nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

Il pacchetto nvidia-driver è nella sezione non-free di Debian e nvidia-container-toolkit nel repository di Nvidia. Finché non ci sono, l'opzione non compare: il pannello la offre solo quando sa che funzionerà.

Dispositivi USB

Home Assistant con uno Zigbee o uno Z-Wave via USB ha bisogno di vedere l'adattatore. Quando la installi, e in «Porte e cartelle», compaiono gli adattatori su porta seriale collegati al NAS con il loro nome; segna quello che vuoi e l'applicazione lo trova in /dev/serial/by-id/…, un nome che non cambia quando lo ricolleghi. Solo porte seriali: un disco USB o un altro dispositivo restano fuori dalla portata delle applicazioni.

Limiti di memoria e CPU

In «Porte e cartelle» di ogni applicazione installata puoi fissare quanta memoria e quanta CPU può usare al massimo. Senza limite, un'applicazione che va fuori controllo (un indicizzatore di foto, un database messo a punto male) si mangia la memoria del NAS e trascina con sé il pannello e le altre. I livelli offerti sono quelli che stanno nel tuo dispositivo; «Senza limite» li toglie. La modifica riavvia l'applicazione.

Disinstallare

«Disinstalla» ferma l'app e la toglie dall'elenco, e lo dice chiaramente: i dati restano sul disco. Reinstallarla domani la riporta con tutte le sue cose. Se quello che vuoi è recuperare lo spazio, l'opzione di eliminare anche i dati lo fa davvero —e se qualcosa non si potesse eliminare, lo racconta con nome e motivo, non finge che sia rimasto pulito—.

Container, registri e console

L'app Container mostra ciò che gira davvero: ogni container con il suo stato, la sua memoria e il suo processore.

• Registri: l'output del container, con ricerca — è il primo posto dove guardare quando un'app non si avvia o si comporta in modo strano.
• Console: un terminale dentro il container, per l'occhiata che nessun pannello può dare.
• Fermare, avviare e riavviare singoli container. Attenzione a eliminare il container di un'applicazione del Centro pacchetti: non la disinstalla —verrà ricreato aggiornandola—, la lascia solo ferma. Per toglierla davvero, «Disinstalla» nel Centro pacchetti.

Pulizia

Docker si lascia dietro immagini vecchie a ogni aggiornamento, e occupano giga che nessuno usa. Il pulsante di pulizia li recupera: elimina ciò che non è più referenziato da nessun container — immagini orfane, livelli sparsi— e dice quanto ha liberato. Le app e i loro dati non vengono toccati.

Come si integra con il resto

• I dati delle app sono normali cartelle del volume: entrano nei backup e nelle istantanee come tutto il resto.
• Se il volume viene distrutto o cambia posto, il pannello ricolloca Docker e ti dice quali app vanno reinstallate: è spiegato in Dischi, ricambi e repliche.
• Per pubblicare ricette proprie nel catalogo c'è la guida all'amministrazione.