docker / docker/vscode-extension
Proposal: Add support for Build debugging
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 59
- Forks
- 23
- PR merge metrics
- No merged PRs in 30d
Description
Problem
It can be a struggle to understand what happens during a Docker build. They lack visibility into how the build context is used, what layers are created or cached, and how the filesystem changes step-by-step, making it difficult to diagnose slow or broken builds.
- How the build context is prepared.
- How layers are created, reused, or invalidated.
- How the filesystem changes between layers.
- Whether cache hits or misses occur, and why.
Proposed Solution
Enhance the Docker DX extension to surface more detailed build debugging information, ideally integrated into the VS Code UI:
- Show how the build context is assembled (files included/excluded).
- Visualize each build layer: what files were added, modified, or deleted.
- Indicate cache hits/misses clearly at each build step.
- Expose the current working directory (WORKDIR) and filesystem state before and after a step.
- Provide build step logs with additional debugging output (optionally toggled on).
This could be surfaced through:
- A side panel view summarizing build steps and cache usage.
- Inline diagnostics in Dockerfile editors (e.g., “this line caused a cache miss”).
- Enhanced logging in the VS Code Terminal output.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by examining the Docker DX extension’s current build experience in the VS Code UI, including Dockerfile editor diagnostics and VS Code Terminal output. Define a narrower first milestone around build context, layer changes, cache status, WORKDIR state, or enhanced logs; completion should specify which debugging information is surfaced and where.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, typescript, vscode
- Domain
- build-system, developer-experience, devtools
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100