Files
learning/docker/011-dockerfie.md

3.7 KiB

Docker file

Introduzione

Il Dockerfile è un file di testo che contiene una serie di istruzioni per creare immagini Docker personalizzate. Nel caso di Podman, il file è denominato Containerfile, ma la sintassi rimane invariata.

FROM ubuntu

LABEL Description="ubuntu con curl preinstallato"
RUN apt update && apt install -y curl

ENTRYPOINT ["/usr/bin/curl"]

In questo esempio, l'istruzione FROM specifica l'immagine base, LABEL imposta una descrizione e RUN esegue i comandi apt update e apt install -y curl.

Ogni istruzione nel Dockerfile crea un nuovo layer. Se si utilizzano molte istruzioni, l'immagine risultante sarà più grande. Per ridurre le dimensioni dell'immagine, è consigliabile combinare più comandi in un'unica istruzione. Ad esempio, l'uso di apt-get update e apt-get install in un'unica riga evita la creazione di layer aggiuntivi.

Durante la creazione dell'immagine, il container viene spento e riacceso tra un'istruzione e l'altra. Questo significa che non c'è continuità tra le istruzioni: le variabili d'ambiente impostate in un'istruzione non saranno disponibili nelle istruzioni successive.

Caching

Docker utilizza un meccanismo di caching per ottimizzare la creazione delle immagini. Se un'istruzione non viene modificata, Docker utilizzerà il risultato della cache invece di eseguire nuovamente l'istruzione. Tuttavia, se un'istruzione prevede il download di una risorsa, la versione memorizzata nella cache potrebbe non essere aggiornata se la risorsa online è cambiata. Per forzare Docker a non utilizzare la cache, è possibile utilizzare l'opzione --no-cache durante la costruzione dell'immagine.

Istruzioni

Le istruzioni più comuni utilizzate in un Dockerfile includono:

  • ADD: consente di aggiungere file o directory remoti o locali al container
  • COPY: copia file e directory locali all'interno del container
  • ENTRYPOINT: definisce l'eseguibile predefinito all'avvio del container
  • CMD: specifica i parametri di avvio per l'ENTRYPOINT
  • ENV: imposta variabili d'ambiente che saranno disponibili in fase di esecuzione del container
  • EXPOSE: indica al demone Docker che il container ascolta su una certa porta
  • FROM: definisce l'immagine di base da cui derivare la nuova immagine
  • RUN: esegue comandi all'interno del container durante la costruzione dell'immagine

Buid di una immagine Docker

Per costruire un'immagine Docker, è necessario utilizzare il seguente comando:

docker build -t <username>/image_name /path/to/dockerfile

Ad esempio, se il Dockerfile si trova nella cartella corrente, il comando sarà:

docker build -t <username>/myubuntu .

L'immagine viene costruita seguendo le istruzioni specificate nel Dockerfile. Eseguendo il comando docker image ls, sarà possibile visualizzare l'immagine appena costruita, che potrà essere eseguita come qualsiasi altra immagine Docker.

Pubblicazione dell'immagine su un registry

È possibile caricare l'immagine su un registry, come Docker Hub, dove sarà pubblica per impostazione predefinita. Prima di procedere, è necessario effettuare il login:

docker login

Dopo aver effettuato il login, è possibile taggare l'immagine e caricarla utilizzando i seguenti comandi:

docker tag myubuntu <username>/myubuntu:latest
docker push <username>/myubuntu:latest

Backup e ripristino dell'immagine

Per eseguire un backup dell'immagine localmente, senza caricarla su un registry, utilizzare il comando docker save:

docker save -o myubuntu.tar.gz myubuntu

Per importare l'immagine su un altro sistema, utilizzare il comando:

docker image import myubuntu.tar.gz <username>/myubuntu:latest