5.1.1 Context Scope

Context scope refers to deliberately choosing which directory to use as a build's context, and structuring a project so that this directory contains exactly what a build needs — no more, no less — rather than defaulting to an overly broad scope purely out of convenience.

Choosing a Narrow, Purposeful Context

Pointing the build context specifically at the directory containing what the image actually needs, rather than a much broader parent directory, limits both what gets transferred and what could accidentally be referenced or included.

docker build -t myapp ./backend

Scoping the context to ./backend rather than the entire project root prevents the build from having access to unrelated frontend code, documentation, or other directories that have no bearing on this particular image.

The Risk of an Overly Broad Context

Using an unnecessarily broad context — such as a monorepo's root, when only one service's subdirectory is actually relevant — increases transfer time and increases the chance of accidentally referencing or including files that don't belong in this particular image.

docker build -t backend-service .

If . here is a large monorepo root containing many unrelated services, this build needlessly transfers far more than it actually needs.

Restructuring a Project for Narrower Context Scope

Sometimes a project's overall structure can be adjusted specifically to support narrower, more purposeful build contexts for each individual image, rather than forcing every build to use the same broad root directory.

project/
  backend/
    Dockerfile
    src/
  frontend/
    Dockerfile
    src/

Each service's Dockerfile and relevant source live together, allowing each to be built with a tightly scoped context limited to just that service.

Why Context Scope Matters

A deliberately narrow build context reduces unnecessary transfer overhead, limits what could mistakenly be included in an image, and makes a Dockerfile's relationship to its surrounding project structure clearer and easier to reason about.