Creare Immagini Docker con Dockerfile

Un Dockerfile è un file di testo che contiene una serie di istruzioni per creare un’immagine Docker personalizzata. Le immagini Docker rappresentano l’ambiente in cui verrà eseguita la tua applicazione, contenendo tutto il necessario come il codice, le dipendenze, le configurazioni e le librerie di sistema. In questa guida, esploreremo come creare un Dockerfile, definire le istruzioni necessarie e costruire un’immagine Docker.

1. Creare un Dockerfile

Il primo passo per creare un’immagine Docker è scrivere un Dockerfile. Questo file descrive in modo sequenziale i passaggi necessari per configurare l’immagine Docker.

Creare un File Dockerfile

Inizia creando un file chiamato Dockerfile nella directory principale del tuo progetto:

touch Dockerfile

2. Struttura di Base di un Dockerfile

Un Dockerfile è costituito da una serie di istruzioni che vengono eseguite in sequenza per costruire l’immagine Docker. Ecco le istruzioni più comuni utilizzate in un Dockerfile:

• FROM: Specifica l’immagine base da cui partire.
• WORKDIR: Imposta la directory di lavoro all’interno del container.
• COPY: Copia file e directory dal sistema host al container.
• RUN: Esegue comandi durante la costruzione dell’immagine.
• EXPOSE: Specifica le porte che il container espone.
• CMD: Definisce il comando di default che verrà eseguito all’avvio del container.

Esempio di Dockerfile di Base

# Immagine base
FROM python:3.9-slim

# Imposta la directory di lavoro
WORKDIR /app

# Copia i file del progetto nella directory di lavoro
COPY . .

# Installa le dipendenze
RUN pip install --no-cache-dir -r requirements.txt

# Espone la porta dell'applicazione
EXPOSE 8080

# Comando di default per eseguire l'applicazione
CMD ["python", "app.py"]

In questo esempio, il Dockerfile parte da un’immagine base Python, copia i file del progetto, installa le dipendenze e definisce il comando di avvio per l’applicazione.

3. Costruire l’Immagine Docker

Dopo aver creato il Dockerfile, puoi costruire l’immagine Docker utilizzando il comando docker build.

Comando per Costruire l’Immagine

docker build -t myapp .

• -t myapp: Assegna un tag (myapp) all’immagine.
• .: Indica la directory corrente come contesto di build, dove si trova il Dockerfile.

Durante la costruzione, Docker eseguirà ogni istruzione nel Dockerfile e creerà un’immagine basata su queste istruzioni.

Visualizzare le Immagini Docker

Puoi visualizzare le immagini Docker create sul tuo sistema utilizzando:

docker images

Questo comando mostrerà l’elenco delle immagini Docker, inclusa l’immagine myapp appena creata.

4. Comandi e Opzioni Comuni nel Dockerfile

Utilizzo di RUN per Eseguire Comandi

L’istruzione RUN è utilizzata per eseguire comandi durante la fase di build dell’immagine. Può essere utilizzata per installare pacchetti, configurare l’ambiente o eseguire script.

RUN apt-get update && apt-get install -y libssl-dev

In questo esempio, RUN aggiorna i pacchetti e installa la libreria libssl-dev nel container.

Utilizzo di COPY e ADD per Copiare File

COPY copia file e directory dal sistema host al filesystem del container.

COPY src/ /app/src/

ADD è simile a COPY, ma supporta anche URL e file compressi che possono essere decompressi durante la copia.

Impostare Variabili d’Ambiente con ENV

ENV imposta variabili d’ambiente all’interno del container.

ENV PYTHONUNBUFFERED=1

In questo esempio, PYTHONUNBUFFERED è impostato a 1 per forzare Python a scrivere l’output immediatamente nel terminale.

Definire il Comando di Default con CMD

CMD specifica il comando di default che verrà eseguito quando il container viene avviato. Puoi definire CMD utilizzando la sintassi JSON o la shell.

CMD ["python", "app.py"]

Impostare il Punto di Entrata con ENTRYPOINT

ENTRYPOINT è simile a CMD, ma permette di definire un comando eseguibile come punto di entrata che non può essere sovrascritto facilmente.

ENTRYPOINT ["python"]
CMD ["app.py"]

In questo esempio, ENTRYPOINT esegue python e CMD fornisce l’argomento app.py. Se avvii il container con un comando diverso, python verrà comunque eseguito come punto di entrata.

5. Eseguire un Container dall’Immagine Creata

Dopo aver costruito l’immagine Docker, puoi creare e avviare un container basato su questa immagine.

Comando per Eseguire il Container

docker run -d -p 8080:8080 myapp

• -d: Esegue il container in modalità detach (in background).
• -p 8080:8080: Mappa la porta 8080 dell’host alla porta 8080 del container.
• myapp: Specifica il nome dell’immagine da cui creare il container.

6. Aggiornare un Dockerfile e Ricostruire l’Immagine

Se apporti modifiche al Dockerfile, puoi ricostruire l’immagine Docker per applicare le modifiche.

Comando per Ricostruire l’Immagine

docker build -t myapp .

Utilizzando lo stesso tag, l’immagine verrà aggiornata con le modifiche apportate nel Dockerfile.

7. Ottimizzare il Dockerfile

Ridurre il Numero di Livelli

Combina più comandi RUN in un’unica istruzione per ridurre il numero di livelli nell’immagine.

RUN apt-get update && apt-get install -y libssl-dev && rm -rf /var/lib/apt/lists/*

Utilizzare Immagini Base Leggere

Scegliere immagini base più leggere, come alpine, per ridurre la dimensione dell’immagine Docker.

FROM python:3.9-alpine

Conclusione

Creare immagini Docker personalizzate utilizzando un Dockerfile ti permette di definire e configurare l’ambiente di esecuzione della tua applicazione in modo preciso e riproducibile. Conoscere le istruzioni chiave e come utilizzarle nel Dockerfile è fondamentale per sfruttare al meglio Docker, permettendoti di costruire immagini efficienti, leggere e facili da gestire. Una volta creato il Dockerfile, puoi costruire, eseguire e aggiornare le tue immagini Docker con facilità, rendendo il processo di sviluppo e distribuzione delle applicazioni più agile e flessibile.