Ubuntu 26.04 / Eseguire un’app Docker con dati persistenti e porte limitate

Un’immagine prepara l’ambiente di esecuzione di un’app in container, mentre dati persistenti e porte pubblicate richiedono scelte separate. In questo laboratorio installerai Docker Engine e Compose su una VM Ubuntu 26.04 dedicata e verificherai che i dati di un’app Nginx restino disponibili dopo la ricreazione del container, con la porta host limitata al loopback.

Scegliere origine dei pacchetti e privilegi

Se il server usa già Docker, containerd o Kubernetes, inventaria container, volumi, repository e pacchetti prima di pianificare modifiche. Non rimuovere pacchetti alla cieca e non mescolare metodi di installazione. La procedura qui sotto riguarda una VM nuova, senza repository Docker preesistente e senza carichi di lavoro da preservare.

La guida ufficiale di installazione Docker per Ubuntu include Ubuntu 26.04 LTS tra le versioni supportate e identifica i pacchetti in conflitto. Verifica versione del sistema, architettura supportata, accesso di rete al repository e privilegi amministrativi; se trovi un’installazione precedente, fermati e prepara una migrazione separata.

L’appartenenza al gruppo docker e l’accesso al socket del daemon conferiscono poteri molto elevati sull’host. Qui i comandi amministrativi indicano sudo: non assegnare permessi 777 al socket e non aggiungere tutti gli utenti al gruppo. La documentazione Docker sui privilegi del gruppo docker ne spiega l’equivalenza ai privilegi root. Scegli immagini di origine verificata: eseguirle non equivale ad aprire un normale documento.

Installare dal repository ufficiale

Prima controlla che /etc/apt/sources.list.d/docker.sources e /etc/apt/keyrings/docker.asc non esistano e non siano collegamenti simbolici, anche interrotti. Il test -e nello script non rileva da solo un collegamento interrotto: se trovi una di queste voci, fermati e ispezionala. Evita modifiche concorrenti durante l’installazione e verifica anche eventuali altre definizioni del repository Docker.

Salva tutto il blocco in ~/install-docker-lab.sh ed esegui bash ~/install-docker-lab.sh. Lo script controlla Ubuntu 26.04 e i file esistenti prima delle scritture. Il campo Signed-By limita la chiave al repository indicato; il file viene scaricato dal percorso HTTPS ufficiale mostrato nella guida Docker.

set -eu
. /etc/os-release
if [ "$ID" != ubuntu ] || [ "$VERSION_ID" != 26.04 ]; then
    printf "This lab requires Ubuntu 26.04.\n" >&2
    exit 1
fi
if [ -e /etc/apt/sources.list.d/docker.sources ] || [ -e /etc/apt/keyrings/docker.asc ]; then
    printf "Inspect the existing Docker repository first.\n" >&2
    exit 1
fi
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker version
sudo docker compose version
sudo docker run --rm hello-world

Controlla le versioni effettive del client e del server, la versione del plugin Compose e il messaggio di successo di hello-world. Quest’ultimo container viene rimosso da --rm, ma l’immagine scaricata può restare. Se falliscono APT, verifica della firma, download o accesso al daemon, non proseguire: leggi l’errore e lo stato del servizio.

Un arresto dopo una scrittura può lasciare chiave e repository già creati. Non cancellarli e non rilanciare alla cieca per aggirare il controllo iniziale: confronta lo stato con la guida e completa o annulla soltanto le modifiche di questa prova. Registra le versioni installate; eliminare il repository non disinstalla l’engine e non elimina i dati.

Il laboratorio sui siti Nginx usa la porta host 8080; questo usa 8081, mantenendo 80 dentro il container. Se 8081 è occupata, identifica il processo con ss e i progetti Compose esistenti; scegli una porta libera e sostituiscila coerentemente nel file e in tutte le richieste curl.

Definire app, volume e pubblicazione della porta

Crea una directory nuova ~/compose-lab, per esempio con mkdir ~/compose-lab, e fermati se esiste già. Salva al suo interno compose.yaml con il contenuto seguente, usando spazi per l’indentazione. Prima controlla ss -lnt e le mappature Docker per verificare che 127.0.0.1:8081 sia disponibile.

services:
  web:
    image: nginx:stable-alpine
    ports:
      - "127.0.0.1:8081:80"
    volumes:
      - lab-html:/usr/share/nginx/html
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
volumes:
  lab-html:

web è il servizio; 127.0.0.1:8081:80 collega la porta 8081 del loopback host alla porta 80 del container. Omettere l’indirizzo può pubblicare la porta anche sulle altre interfacce. Esegui i test dalla VM Docker: il loopback del computer ospitante indica un altro sistema.

La guida Docker alla pubblicazione delle porte documenta anche un limite delle versioni precedenti alla 28.0.0, nelle quali altri host sullo stesso segmento di rete potevano raggiungere porte pubblicate su localhost. Verifica la versione e i percorsi effettivi; la mappatura non è una barriera generale fra container della stessa rete né protegge ogni possibile configurazione di routing.

lab-html è un volume con nome, separato dal livello scrivibile del container. Alla prima creazione, il volume vuoto riceve normalmente i file presenti nella directory dell’immagine; un volume già popolato mantiene invece il proprio contenuto e nasconde quello dell’immagine nel punto di montaggio. La documentazione Docker sui volumi descrive questo comportamento e la persistenza indipendente dal container.

Il tag nginx:stable-alpine può cambiare. Per un impiego riproducibile conserva un digest verificato e pianifica gli aggiornamenti: scaricare un’immagine nuova non aggiorna automaticamente i file già conservati nel volume. I limiti json-file dell’esempio controllano la rotazione dei log del container; adattali al carico e non interpretarli come limite di tutto lo spazio su disco. unless-stopped è una politica di riavvio, non una verifica di salute dell’app.

Avviare e verificare la persistenza dopo la ricreazione

(
set -eu
cd ~/compose-lab
sudo docker compose config
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail 30 web
)

La verifica config deve riuscire prima del download e dell’avvio. Controlla stato del container e log del servizio web; l’avvio in background non garantisce che Nginx sia già pronto a rispondere. Se lo stato mostra arresti o riavvii ripetuti, risolvi l’errore prima di scrivere il file di prova. L’output di config può includere valori interpolati: non pubblicare eventuali segreti.

Solo nel nuovo progetto e nel suo volume di laboratorio, il prossimo blocco sostituisce index.html con un marcatore. Non usarlo su un volume con dati reali. Prima verifica che il servizio web sia avviato e pronto.

(
set -eu
cd "$HOME/compose-lab"
sudo docker compose exec web sh -c 'printf "volume-lab\n" > /usr/share/nginx/html/index.html'
curl --fail http://127.0.0.1:8081/
sudo docker compose up -d --force-recreate
curl --fail http://127.0.0.1:8081/
sudo docker image inspect nginx:stable-alpine --format '{{json .RepoDigests}}'
)

La risposta attesa è volume-lab sia prima sia dopo --force-recreate. La ricreazione può introdurre una breve indisponibilità: se curl fallisce subito dopo il nuovo avvio, il blocco si interrompe. Controlla sudo docker compose ps e i log dalla stessa directory, attendi che il servizio sia pronto e ripeti la sola richiesta curl; non ricreare continuamente il container per mascherare l’errore.

I blocchi di avvio, ricreazione e chiusura entrano tutti in ~/compose-lab. Il cambio di directory dentro parentesi non rimane dopo il blocco: anche i controlli manuali devono usare il medesimo file Compose e lo stesso progetto. Un nome di progetto diverso può creare un altro volume. Per identificare quello effettivo confronta la sezione Mounts di sudo docker inspect sull’ID del container ottenuto con sudo docker compose ps -q web, poi leggi sudo docker volume inspect NOME_VOLUME sostituendo il nome verificato.

Due risposte uguali sono un riscontro della conservazione del file in questa prova, non la prova di un backup riuscito o della salute completa dell’app. L’ultima riga mostra i digest disponibili per il tag locale; registra quale immagine usa effettivamente il container, perché un tag può essere cambiato anche da un altro processo.

Controlla la mappatura con sudo docker compose ps e l’assetto dell’host con ss. Docker può implementare la pubblicazione tramite regole di rete, perciò il solo elenco dei socket non basta. Da un altro dispositivo autorizzato al test, prova l’indirizzo di rete reale della VM sulla porta 8081: non deve essere raggiungibile tramite questa pubblicazione loopback. Non usare 127.0.0.1 sul dispositivo remoto come prova del server.

La documentazione Docker su filtri e firewall spiega l’interazione con UFW: non presumere che le sole regole UFW proteggano una porta pubblicata da Docker. Un’eventuale apertura di rete richiede un piano separato, con controlli dall’esterno e senza modificare arbitrariamente le regole gestite dall’engine.

Distinguere chiusura del progetto e cancellazione dei dati

(
set -eu
cd "$HOME/compose-lab"
sudo docker compose down
sudo docker volume ls
)

down arresta e rimuove container e reti di questo progetto; senza -v conserva normalmente i volumi con nome. Puoi tornare nella stessa directory ed eseguire sudo docker compose up -d, attendere la disponibilità e controllare di nuovo volume-lab. L’elenco generale dei volumi include anche quelli di altri progetti: non eliminarli perché sembrano inutilizzati.

La guida al comando docker compose down distingue la rimozione predefinita dall’opzione --volumes. down -v e i comandi di pulizia dei volumi possono cancellare dati: non usarli come comandi ordinari di chiusura. Prima di un backup coordina le scritture dell’app, conserva la copia in una posizione indipendente e prova il ripristino separatamente, senza sovrascrivere il volume originale.