Buildah

Sezione · Informatica

Buildah

Buildah costruisce immagini OCI senza daemon e senza obbligarti a un Dockerfile: può partire da una ricetta oppure assemblare l'immagine un comando alla volta. La guida spiega a cosa serve, come si usa e dove si colloca rispetto a Podman e Docker.

Versione documentata: Buildah 1.46.0 (21 ottobre 2026), licenza Apache 2.0. Fa parte del progetto CNCF Sandbox “Podman Container Tools” insieme a Podman e Skopeo. Podman 6.1.x include Buildah 1.45.x; la 1.46 è la release standalone più recente. Per il contesto completo sui container restano disponibili le guide Podman e Docker.

Che cos'è Buildah

Buildah è uno strumento a riga di comando che costruisce immagini nel formato OCI (e, se serve, nel formato Docker). Non è un motore che tiene in vita i container: è il laboratorio in cui l'immagine viene preparata. Crea un container di lavoro, ci installa pacchetti, copia file, imposta ambiente, comando di avvio e porte, poi lo chiude dentro un'immagine con buildah commit.

La cosa che lo distingue da docker build è che non ha bisogno di un daemon: ogni comando è un processo che parte, compie il suo lavoro e termina. E non ha bisogno nemmeno di un Dockerfile. Puoi usare un Containerfile quando la ricetta è stabile, oppure concatenare i comandi from, run, copy, config e commit quando vuoi costruire l'immagine da uno script, da un linguaggio di programmazione o da una pipeline.

Buildah nasce nello stesso ecosistema di Podman e Skopeo e con loro condivide le librerie di containers/storage e containers/image. Le immagini prodotte non sono “immagini Buildah”: sono immagini OCI standard, che Podman, Docker, Kubernetes e qualsiasi registry accettano senza conversioni.

Schema del flusso di lavoro di Buildah: da un Containerfile o da una sequenza di comandi a un container di lavoro, poi a un'immagine OCI nello storage, fino al registry o a Podman.
Buildah legge una ricetta oppure esegue comandi espliciti, crea un container di lavoro, lo configura e produce un'immagine nello storage locale. Nessun daemon resta acceso. Illustrazione Adripedia, concetti dalla documentazione Buildah.

Perché esiste

Costruire un'immagine e eseguirla sono due problemi diversi. Docker li ha messi nello stesso prodotto, con un daemon che fa entrambe le cose. Buildah separa il primo problema e lo espone come una collezione di comandi elementari, nello spirito delle coreutils di Unix. Da qui derivano i suoi vantaggi concreti:

  • niente daemon: non c'è un servizio da avviare, aggiornare o proteggere; ogni build è un processo isolato;
  • rootless: un utente normale può costruire immagini usando i namespace utente, senza sudo;
  • scriptabile: le stesse operazioni di un Dockerfile sono disponibili come comandi, quindi può essere chiamato da bash, Python, Go o da un job di CI;
  • immagini minime: puoi partire da scratch e aggiungere solo ciò che serve;
  • nessun Docker-in-Docker: in CI si costruisce direttamente sull'host Linux o dentro un container dedicato.

Podman, a sua volta, usa l'API Go di Buildah per implementare podman build. Quindi quando costruisci con Podman stai già usando il motore di Buildah, anche se il comando si chiama diversamente.

Cosa fa e cosa non fa

AttivitàBuildahPodmanDocker
Costruire un'immagine da ContainerfileSì, con buildah buildSì, con podman buildSì, con docker build
Costruire senza file di ricettaSì, con i comandi esplicitiNo, serve un ContainerfileNo, serve un Dockerfile
Eseguire un servizio di lunga durataNo: run serve per il RUNSìSì
Gestire pod e manifest KubernetesSolo manifest di immaginiSì, con kube playNo, non è il suo scopo
Pubblicare su un registrySì, con push e manifest pushSìSì
Montare il rootfs per modificarloSì, con mountSì, ma non è il flusso tipicoNo, non è esposto così

L'architettura in breve

Buildah è un binario Go che parla direttamente con containers/storage per i file system e con containers/image per i formati e i registry. Per le istruzioni che devono eseguire un processo, come RUN, chiama un runtime OCI, di solito runc o crun. Il modello è fork-exec: il comando che digiti è il processo che coordina il lavoro, e quando ha finito esce.

Un container di lavoro non è un container che resta in esecuzione. È un rootfs salvato nello storage, con una configurazione associata: lo vedi con buildah containers, puoi montarlo con buildah mount e lo trasformi in immagine con buildah commit. I container di lavoro di Buildah non compaiono in podman ps, e i container di Podman non compaiono in buildah containers. Le immagini, invece, sono condivise: ciò che Buildah scrive nello storage lo vede anche Podman.

Buildah e Podman: chi fa cosa

La divisione è semplice: Buildah costruisce, Podman esegue e gestisce. Podman incorpora il codice di Buildah per podman build, quindi le due strade producono lo stesso tipo di immagine. La differenza pratica è l'interfaccia: Buildah espone i singoli passaggi della build, Podman espone il ciclo di vita dei container.

AspettoBuildahPodman
Scopo principaleCostruire e manipolare immaginiEseguire e gestire container, pod e immagini
DaemonNessunoNessuno
Container di lavoroSì, temporanei, visibili con buildah containersNo: i container sono servizi, visibili con podman ps
Build da Containerfilebuildah buildpodman build, che usa Buildah
Build senza ContainerfileSìNo
Storage delle immaginicontainers/storagecontainers/storage
Comando tipicobuildah commitpodman run

Quando scegliere Buildah

Buildah dà il meglio di sé quando la build è parte di un'automazione o quando serve un controllo fine su ciò che finisce nell'immagine:

  • pipeline CI che non vogliono un daemon né privilegi di root;
  • immagini minime, costruite da scratch o da una base ridotta, con pochi pacchetti e nessun residuo di build;
  • build generate da uno script, con parametri calcolati a runtime;
  • immagini multi-architettura raccolte in un manifest list;
  • ambienti Kubernetes in cui non si vuole esporre il socket di Docker;
  • debug di un Dockerfile: eseguire le istruzioni una alla volta rende visibile ciò che il file nasconde.

Non è invece lo strumento giusto per gestire i container di tutti i giorni, per Docker Compose o per chi vuole un'interfaccia grafica: in quei casi servono Podman, Podman Desktop o Docker.

Requisiti e versioni

Buildah gira solo su Linux. Non esiste un binario nativo per Windows o macOS: in quei sistemi si usa una macchina Linux, una distribuzione WSL 2 oppure un container Linux. Sul kernel servono il supporto a overlayfs (oppure fuse-overlayfs), i namespace e un runtime OCI come runc o crun. Per l'uso rootless servono /etc/subuid, /etc/subgid e i helper newuidmap e newgidmap.

VersioneDataNote
Buildah 1.46.021 ottobre 2026Release stabile documentata qui. Richiede containers/storage 1.64, containers/image 5.41 e containers/common 0.69.
Buildah 1.45.212 ottobre 2026Serie inclusa in Podman 6.1.x.
Buildah 1.44.027 maggio 2026Serie richiesta da Podman 6.0.
Buildah 1.43.x2026Serie precedente, ancora presente in alcune distribuzioni.

Le versioni nei repository delle distribuzioni spesso arrivano con mesi di ritardo rispetto a monte. Prima di seguire un esempio, controlla buildah --version: un flag può non esistere ancora, oppure comportarsi diversamente.