Inicio·Comandos de terminal

docker build

Paquetes y entornos

Uso

docker build -t <name>:<tag> [-f <Dockerfile>] <context>

Construye una imagen desde un Dockerfile; el punto final es el contexto que se envía al demonio, así que una carpeta enorme ralentiza la construcción hasta que .dockerignore la recorta, y COPY solo ve archivos dentro de ese contexto.

Opciones habituales

OpciónSignificado
-t <name>:<tag>name the image; without it you only get an id
-f <file>use a Dockerfile that is not ./Dockerfile
--no-cacherebuild every layer
--build-arg KEY=valuepass an ARG into the build
--target <stage>stop at one stage of a multi-stage file
--platform linux/amd64build for another architecture
--progress=plainfull log output instead of the collapsed view

Ejemplos

docker build -t myapp:1.0 .

builds from ./Dockerfile with the current folder as context

docker build -f docker/Dockerfile.dev -t myapp:dev .

another Dockerfile, same context

docker build --platform linux/amd64 -t myapp:1.0 .

an x86 image built on an Apple Silicon Mac

La pregunta siempre es qué va dónde: dentro de este proyecto o en todo el sistema.

Cómo leerlo

  • Los corchetes [ ] marcan una parte que puedes omitir.
  • Los puntos suspensivos … indican que puedes poner varios.
  • Las opciones distinguen mayúsculas: en algunos comandos -r y -R no hacen lo mismo.

Preguntas

Q. ¿Qué hace docker build?

Construye una imagen desde un Dockerfile; el punto final es el contexto que se envía al demonio, así que una carpeta enorme ralentiza la construcción hasta que .dockerignore la recorta, y COPY solo ve archivos dentro de ese contexto.

Q. ¿Cómo se escribe?

docker build -t <name>:<tag> [-f <Dockerfile>] <context> — los corchetes marcan lo que puedes omitir.

Q. ¿Cuántas opciones vale la pena saber?

Aquí van 7; la lista completa está en man docker. Este comando está en Paquetes y entornos.

Comandos relacionados

página man: man docker-build