Immagine, container e Compose
Immagine, container e Compose — Docker Compose per servizi AI. Definire l'unità riproducibile; Registrare l'identità dell'immagine; Scrivere il primo file Compose. Esercitazione pratica: Pratica: Immagine, container e Compose.
Versione demo. I materiali sono in fase di revisione editoriale.
Argomenti trattati
- Definire l'unità riproducibile
- Registrare l'identità dell'immagine
- Scrivere il primo file Compose
Definire l'unità riproducibile
Un'immagine contiene filesystem e impostazioni iniziali; un container è un'istanza avviata con stato proprio. Compose descrive le istanze necessarie e i loro collegamenti. Il sistema didattico è un server Ollama su CPU, inizialmente senza modelli scaricati. Puoi così verificare l'infrastruttura prima di occupare disco e memoria con i pesi. Serve Docker Engine con il plugin Compose già installato nel laboratorio. L'accesso al daemon concede ampi poteri: non consegnare il socket al modello o a container sconosciuti.
docker version
docker compose version
Registrare l'identità dell'immagine
Il tag mobile latest può indicare domani un'immagine diversa. Scegli un tag pubblicato e supportato di ollama/ollama, leggi le note di rilascio e registra il digest dopo il download. Gli esempi richiedono OLLAMA_IMAGE: Compose si ferma finché non inserisci un riferimento verificato, evitando versioni inventate. Registra il riferimento in un .env locale senza segreti. Versioni identiche dell'immagine non garantiscono pesi identici: identità e licenza del modello vanno documentate separatamente prima del download.
Scrivere il primo file Compose
Salva compose.yaml nella directory del laboratorio. Il server ascolta sulla porta 11434 del container, mentre la pubblicazione sull'host è limitata esplicitamente al loopback. Un volume nominato conserva la directory Ollama quando il container viene sostituito. Prima di up esegui config --quiet: config normale può mostrare valori sostituiti, quindi non usarlo per stampare segreti. La validazione conferma la sintassi, non il funzionamento del modello. Senza OLLAMA_IMAGE è previsto un errore esplicativo anziché l'avvio di una versione arbitraria.
name: ai-lab
services:
model:
image: ${OLLAMA_IMAGE:?Set a verified Ollama image reference}
ports:
- "127.0.0.1:11434:11434"
volumes:
- model_data:/root/.ollama
volumes:
model_data:
docker compose config --quiet
Esercitazione pratica
Pratica: Immagine, container e Compose
Vai alla lezione