Comando Docker build
Referencia completa de comandos Docker
docker buildEl comando se utiliza para construir imágenes Docker a partir de un Dockerfile.
docker buildEl comando lee las instrucciones definidas en el Dockerfile, construye la imagen paso a paso y guarda el resultado final en el repositorio de imágenes local.
Sintaxis
docker build [OPTIONS] PATH | URL | -
PATH: ruta del directorio que contiene el Dockerfile o.(directorio actual).URL: dirección del repositorio remoto que contiene el Dockerfile (por ejemplo, un repositorio Git).-: lee el Dockerfile desde la entrada estándar.
Opciones comunes:
-t, --tag: especifica el nombre y la etiqueta de la imagen construida.-f, --file: especifica la ruta del Dockerfile (por defecto esPATHbajoDockerfile)。--build-arg: establece parámetros de construcción.--no-cache: construye la imagen sin usar capas de caché.--rm: elimina los contenedores intermedios después de una construcción exitosa (habilitado por defecto).--force-rm: elimina los contenedores intermedios independientemente de si la construcción tiene éxito o no.--pull: siempre intenta extraer la imagen base más reciente del registro.
Descripción de más opciones:
--build-arg=[]: establece variables al construir la imagen.--cpu-shares: establece el peso de uso de la CPU.--cpu-period: limita el período CFS de la CPU.--cpu-quota: limita la cuota CFS de la CPU.--cpuset-cpus: especifica los ID de CPU que se pueden usar.--cpuset-mems: especifica los ID de nodos de memoria que se pueden usar.--disable-content-trust: ignora la verificación de confianza del contenido (habilitada por defecto).-f: especifica la ruta del Dockerfile.--force-rm: fuerza la eliminación de contenedores intermedios durante el proceso de construcción.--isolation: utiliza la tecnología de aislamiento de contenedores especificada.--label=[]: establece los metadatos de la imagen.-m: establece el valor máximo de memoria.--memory-swap: establece el valor máximo de espacio de intercambio (memoria + espacio de intercambio),-1indica que el espacio de intercambio no está limitado.--no-cache: no usa caché al construir la imagen.--pull: intenta extraer la versión más reciente de la imagen base.--quiet, -q: modo silencioso; solo se muestra el ID de la imagen después de una construcción exitosa.--rm: elimina los contenedores intermedios después de una construcción exitosa (habilitado por defecto).--shm-size: establece el/dev/shmtamaño de /dev/shm; el valor predeterminado es 64M.--ulimit: establece la configuración de Ulimit.--squash: comprime todos los pasos del Dockerfile en una sola capa.--tag, -t: especifica el nombre y la etiqueta de la imagen, con el formatoname:tagoname; se pueden establecer múltiples etiquetas para una imagen en una misma construcción.--network: establece durante la construcción elRUNmodo de red de la instrucción, con un valor predeterminado dedefault。
1. Construir la imagen
docker build -t myimage:latest .
Esto lee el Dockerfile del directorio actual y construye una imagen llamada myimage:latest.
2. Especificar la ruta del Dockerfile
docker build -f /path/to/Dockerfile -t myimage:latest .
Esto lee el Dockerfile del directorio /path/to/ y construye una imagen llamada myimage:latest.
3. Establecer parámetros de construcción
docker build --build-arg HTTP_PROXY=http://proxy.example.com -t myimage:latest .
Esto utiliza la variable de entorno HTTP_PROXY durante el proceso de construcción.
4. Construir la imagen sin usar capas de caché
docker build --no-cache -t myimage:latest .
Esto ignora todas las capas de caché al construir la imagen, asegurando que cada paso se ejecute de nuevo.
Ejemplo: construir una imagen con Dockerfile
1. Crear un Dockerfile con el siguiente contenido:
# Dockerfile 示例 FROM ubuntu:20.04 LABEL maintainer="yourname@example.com" RUN apt-get update && apt-get install -y nginx COPY index.html /var/www/html/index.html CMD ["nginx", "-g", "daemon off;"]
2. Construir la imagen
docker build -t mynginx:latest .
Ejemplo de salida:
Sending build context to Docker daemon 3.072kB Step 1/5 : FROM ubuntu:20.04 20.04: Pulling from library/ubuntu ... Step 2/5 : LABEL maintainer="yourname@example.com" ... Step 3/5 : RUN apt-get update && apt-get install -y nginx ... Step 4/5 : COPY index.html /var/www/html/index.html ... Step 5/5 : CMD ["nginx", "-g", "daemon off;"] ... Successfully built 123456789abc Successfully tagged mynginx:latest
3. Verificar la imagen
docker images
Ejemplo de salida:
Notas
REPOSITORY TAG IMAGE ID CREATED SIZE mynginx latest 123456789abc 10 minutes ago 200MB
- Asegúrate de que la sintaxis del Dockerfile sea correcta y ejecuta cada paso en orden.
- Usa el
.dockerignorearchivo .dockerignore para excluir archivos y directorios innecesarios, reduciendo así el tamaño del contexto de construcción. - Evita exponer información sensible (como contraseñas y claves) en el Dockerfile.
- El comando es la herramienta principal para construir imágenes Docker. Al definir un Dockerfile claro, se puede automatizar la construcción del entorno de ejecución y las dependencias de la aplicación. Al usarlo, asegúrate de configurar razonablemente las opciones y optimizar el Dockerfile para mejorar la eficiencia de construcción y la calidad de la imagen.
docker buildReferencia completa de comandos Docker
IA pensando...