Docker has continually evolved to enhance the efficiency and accessibility of containerization, with the latest release of Dockerfile version 1.7.0 introducing a range of innovative features designed to optimize Docker image builds. This article will explore these new capabilities, providing examples and explanations to help users leverage these advancements effectively.

Key Features of Dockerfile v1.7.0

1. Heredoc Support for Multi-line Commands

The introduction of heredoc syntax simplifies the writing of multi-line commands within Dockerfiles, improving both readability and maintainability. This feature is particularly useful for complex scripts.

Example:

# syntax=docker/dockerfile:1.7.0
FROM alpine

RUN <<EOF
echo "Starting setup..."
apk update
apk add --no-cache python3 py3-pip
pip3 install --no-cache-dir flask
EOF

This syntax allows multiple lines of commands without needing to chain them with &&, making scripts easier to manage.

Instantly add file uploads to your app with Pinata’s API

Pinata’s File API lets developers integrate file uploads and retrieval in just minutes. No complex setup, no configuration headaches—just fast and scalable file management.

Start building!

2. Conditional Builds with Build Expressions

Conditional builds enable users to include or exclude sections of their Dockerfile based on build-time variables, adding flexibility to the build process.

Example:

# syntax=docker/dockerfile:1.7.0
FROM node:14

ARG INSTALL_TOOLS=false

RUN <<EOF
{% if $INSTALL_TOOLS == 'true' %}
apt-get update && apt-get install -y vim
{% endif %}
EOF

By defining an argument like INSTALL_TOOLS, users can control whether additional tools are installed during the build.

3. Improved RUN --mount Syntax

The RUN --mount flag has been enhanced, providing greater flexibility for build-time mounts, including caching and binding directories.

Example:

# syntax=docker/dockerfile:1.7.0
FROM ubuntu:20.04

RUN --mount=type=cache,target=/var/cache/apt \
    apt-get update && apt-get install -y build-essential

This example demonstrates how caching package downloads can speed up subsequent builds.

4. Mount Options in COPY and ADD

Users can now apply mount options directly with COPY and ADD, granting more control over file operations during the build.

Example:

# syntax=docker/dockerfile:1.7.0
FROM golang:1.17

COPY --mount=type=cache,target=/go/pkg/mod \
     . /app

WORKDIR /app

RUN go build -o myapp .

This approach reduces build times by caching dependencies.

5. Enhanced Secrets Handling

Dockerfile v1.7.0 improves the management of sensitive data during builds, ensuring that secrets do not end up in final images.

Example:

# syntax=docker/dockerfile:1.7.0
FROM alpine

RUN --mount=type=secret,id=mysecret,dst=/run/secrets/mysecret \
    cat /run/secrets/mysecret > /root/secret_info

Secrets are mounted at the specified destination without being stored in image layers.

6. Variable Expansions (Experimental)

The experimental v1.7-labs introduces variable expansions within Dockerfiles, allowing for more dynamic builds.

Example:

# syntax=docker/dockerfile:1.7-labs
FROM alpine

ARG VERSION=1.0.0
ENV APP_DIR=/opt/myapp-$VERSION

RUN mkdir -p $APP_DIR

This enables seamless integration of build-time arguments and environment variables.

7. Copy with Keeping Parent Directories (Experimental)

This feature allows users to copy files while preserving their parent directory structure, which is beneficial for maintaining organization.

Example:

# syntax=docker/dockerfile:1.7-labs
FROM alpine

COPY --keep-parent dir1/dir2/file.txt /destination/

The resulting structure replicates the original hierarchy under the destination folder.

8. Exclusion Filters (Experimental)

Exclusion filters provide fine-grained control over file copying, allowing specific files or patterns to be omitted from images.

Example:

# syntax=docker/dockerfile:1.7-labs
FROM node:14

COPY . /app/ \
    --exclude=*.test.js \
    --exclude=docs/

WORKDIR /app
RUN npm install

This reduces image size by excluding unnecessary files.

9. Contexts from Archives and URLs (Experimental)

Users can now specify build contexts from tar archives or URLs, simplifying image builds from various sources.

Example:

docker build -f Dockerfile https://example.com/myapp.tar.gz -t myapp:latest

This command fetches and uses a tar archive as the build context.

10. Platform-Specific FROM Instructions (Experimental)

The FROM instruction now supports specifying target platforms, enabling multi-platform builds within a single Dockerfile.

Example:

# syntax=docker/dockerfile:1.7.0
FROM --platform=$BUILDPLATFORM golang:1.17 AS builder

WORKDIR /app
COPY . .

RUN GOOS=$TARGETOS GOARCH=$TARGETARCH go build -o myapp .

FROM alpine

COPY --from=builder /app/myapp /usr/local/bin/myapp

Automatic variables allow building binaries for different architectures seamlessly.

11. Build-Time Arguments in FROM (Experimental)

Users can now utilize build-time arguments in the FROM instruction to dynamically select base images.

Example:

# syntax=docker/dockerfile:1.7.0
ARG BASE_IMAGE=python:3.9-slim

FROM ${BASE_IMAGE}

WORKDIR /app
COPY . .

RUN pip install -r requirements.txt

This flexibility allows changes to the base image during the build process.

12. Support for Multiple Build Contexts (Experimental)

Docker now supports specifying multiple build contexts, making it easier to include files from various locations in a single build process.

Example:

# syntax=docker/dockerfile:1.7.0
FROM ubuntu:20.04

COPY --from=assets /images /usr/share/app/images

To utilize these features, ensure you have the latest version of Docker installed and specify the appropriate Dockerfile syntax:

• For stable features:

# syntax=docker/dockerfile:1.7.0

• For experimental features:

# syntax=docker/dockerfile:1.7-labs

Enable BuildKit, Docker’s advanced build engine:

export DOCKER_BUILDKIT=1 

Alternatively, use the Docker build command with BuildKit enabled:

docker buildx build -t my-app .

Conclusion

The enhancements introduced in Dockerfile v1.7.0 and its experimental counterpart offer significant improvements to the Docker building process, from heredoc support and conditional builds to enhanced secrets handling and variable expansions. By integrating these features into your development workflow, you can create more efficient, secure, and manageable Docker images that streamline your containerized applications' development process.