How docker/vscode-extension works
Docker DX is a Visual Studio Code extension for Docker authoring, build diagnostics, vulnerability warnings, and Dockerfile build debugging. The main workflow starts when the extension activates: it connects a language client to a Docker language server, which provides editing intelligence and diagnostics in the editor. Separate paths support Buildx debugging and Docker Engine availability prompts; telemetry is collected and published independently. The README documents Compose and Bake features, but their implementation is not sampled, so those capabilities are represented at the language-server boundary. Arrows reflect shown calls or documented behavior; unsampled internals are not inferred.
Main entry points: extension.ts Extension activation · monitor.ts Engine availability check · languageClient.ts Docker language client · spawnDockerCommand.ts Docker command runner
Components 21
Extension runtime
- Extension activation
src/extension.ts - Editor decorations
src/utils/editor.ts
Language features
- Language client setup
src/utils/lsp/lsp.ts - Docker language client
src/utils/lsp/languageClient.ts - Docker language server
- Dockerfile editing
- Compose editing
- Bake editing
- Image vulnerability scanning
Build debugging
- Debug configuration
src/dap/config.ts - Buildx DAP
Docker availability
- Docker CLI
- Engine availability check
src/utils/monitor.ts - Docker command runner
src/utils/spawnDockerCommand.ts - Desktop detection
src/utils/os.ts - Availability prompts
src/utils/prompt.ts - Extension settings
src/utils/settings.ts
Telemetry
- Telemetry client
src/telemetry/client.ts - Telemetry redaction
src/telemetry/filter.ts - Telemetry service
Other components
- VS Code user
Connections 25
- VS Code user → Extension activation: activates
src/extension.ts - Extension activation → Language client setup: starts
src/extension.ts - Language client setup → Docker language client: constructs
src/utils/lsp/lsp.ts - Docker language client → Docker language server: connects to
src/utils/lsp/languageClient.ts - Docker language server → Dockerfile editing: provides
README.md - Docker language server → Compose editing: provides
README.md - Docker language server → Bake editing: provides
README.md - Docker language server → Image vulnerability scanning: flags images
README.md - Dockerfile editing → VS Code user: shows diagnostics
README.md - Extension activation → Editor decorations: hooks
src/extension.ts - Extension activation → Debug configuration: registers
src/extension.ts - Debug configuration → Buildx DAP: launches
src/dap/config.ts - Buildx DAP → Docker CLI: runs Buildx DAP
- Extension activation → Engine availability check: checks engine
src/extension.ts - Engine availability check → Extension settings: reads
src/utils/monitor.ts - Engine availability check → Docker command runner: runs status check
src/utils/monitor.ts - Docker command runner → Docker CLI: spawns
src/utils/spawnDockerCommand.ts - Engine availability check → Desktop detection: checks installation
src/utils/monitor.ts - Engine availability check → Availability prompts: prompts user
src/utils/monitor.ts - Docker command runner → Availability prompts: prompts on error
src/utils/spawnDockerCommand.ts - Availability prompts → Extension settings: updates preference
src/utils/prompt.ts - Extension activation → Telemetry client: publishes
src/extension.ts - Docker language client → Telemetry client: reports errors
src/utils/lsp/languageClient.ts - Extension activation → Telemetry redaction: redacts errors
src/extension.ts - Telemetry client → Telemetry service: posts events
src/telemetry/client.ts