├── README.md └── lsp ├── CHANGELOG.md └── README.md /README.md: -------------------------------------------------------------------------------- 1 | # Docker-VSCode 2 | 3 | This is an experiemental feature added to the [official VSCode extension for Docker](https://github.com/microsoft/vscode-docker). 4 | Nothing here has been upstreamed but we want to stress that this is not a fork. Assume that any positive results from this would be 5 | contributed back to the original extension. 6 | 7 | ## What is this project? 8 | 9 | The updates to this extension add a new experimental LSP. We are current working on two features. 10 | 11 | 1. Integration of Scout recommendations to the Dockerfile language service. 12 | 2. Integration of the new support for Docker's new official Dockerfile linting support. 13 | 14 | ![lsp](https://github.com/docker/docker-vscode/releases/download/lsp-v1.29.6/CleanShot.2024-05-01.at.11.50.30.gif) 15 | 16 | This should be considered a usable prototype. It is mature enough to try internally but the features it supports 17 | are active works in progress. 18 | 19 | ## Getting started 20 | 21 | See the complete [installation instructions](./lsp) for adding this version of the 22 | Docker extension to VSCode. 23 | 24 | -------------------------------------------------------------------------------- /lsp/CHANGELOG.md: -------------------------------------------------------------------------------- 1 | # Changelog 2 | 3 | All notable changes to this project will be documented in this file. 4 | 5 | ## [1.29.7-alpha] 2024-4-25 6 | 7 | Bugfixes & performance optimizations 8 | 9 | ## [1.29.5-alpha] 2024-4-25 10 | 11 | ### Added 12 | * [Dockerfile Linting] Full markdown support 13 | 14 | ## [1.29.5-alpha] 2024-4-24 15 | 16 | This extension is now forked from https://github.com/microsoft/vscode-docker with enhanced language featues. 17 | 18 | ### Added 19 | * [Dockerfile Linting] Base image recommendations 20 | * [Dockerfile Linting] Automatic digest pinning 21 | * [Dockerfile Linting] Best practices from buildkit lint 22 | * [Dockerfile Linting] apk/apt-get package recommendations 23 | * [Dockerfile Linting] Deep linked image details for Docker Desktop users 24 | * [Dockerfile Linting] Autocompletes for tags, base image, and debian packages 25 | * [Dockerfile Linting] Code lens to show local build status, showing size, and showing vulnerability count by Dockerfile instruction 26 | 27 | 28 | ### Removed 29 | * Runbook generation 30 | * Runnable terminal blocks 31 | * Streaming LLM completions 32 | * Integrated terminal docker debugging 33 | * Terminal highlight explanations 34 | * Taggable hotkey commands 35 | 36 | 37 | ## [v0.0.5](https://github.com/docker/docker-ai/releases/tag/pre-release) 2024-2-9 38 | 39 | ### Added 40 | 41 | * Runbook generation 42 | * Runnable terminal blocks 43 | * Streaming LLM completions 44 | * [INSIDERS VSCODE ONLY] Integrated terminal docker debugging 45 | * Terminal highlight explanations 46 | * Taggable hotkey commands 47 | 48 | ### Removed 49 | 50 | * Notebooks 51 | * Walkthrough 52 | * Ask docker AI 53 | 54 | ### Fixed 55 | 56 | * Activation reliability improved 57 | * Activation time greatly reduced 58 | * Misc. UX tweaks, copy, loading progress, etc... 59 | 60 | ## v0.0.4 2023-12-13 61 | 62 | ### Added 63 | 64 | * do not rely on git index for docker analysis - support non-versioned projects 65 | * add pre-flight checks to warn if Docker Desktop is configured and running 66 | 67 | ### Fixed 68 | 69 | * stability and bug fixes for Windows/WSL support 70 | 71 | ## v0.0.1 - 2023-11-30 72 | 73 | ### Added 74 | 75 | * Initial Release 76 | 77 | -------------------------------------------------------------------------------- /lsp/README.md: -------------------------------------------------------------------------------- 1 | # Docker VSCode Limited Early Access 2 | As mentioned in the release notes, the `.vsix` file described here provides early access to features that 3 | we are proposing to be contributed into the official Docker vscode extension. 4 | 5 | ## Installing 6 | 7 | ### Step 1: Download Extension File 8 | 9 | - Download the latest .vsix bundle from: https://github.com/docker/docker-vscode/releases/ 10 | 11 | ### Step 2: Enable Extension in VSCode 12 | 13 | #### CLI: 14 | 15 | Must have VSCode [code](https://code.visualstudio.com/docs/editor/command-line#_code-is-not-recognized-as-an-internal-or-external-command) command in PATH: 16 | 17 | ```bash 18 | code --install-extension /my/path/to/docker-bundle.vsix --force 19 | ``` 20 | 21 | #### GUI: 22 | 23 | Extensions -> `...` menu -> `Install from VSIX` 24 | 25 | Screenshot of docker install menu 26 | 27 | #### GUI (command palette): 28 | 29 | 1. Type `>` into top search bar 30 | **Shortcut: Press ⇧⌘P (OSX) or CTRL⇧P (Win/Linux)** 31 | 2. Select `Extensions: Install from VSIX...` 32 | 3. Select `.vsix` file downloaded 33 | 4. Hit the “Reload Now” button in the notification at the bottom right corner 34 | 35 | ## Dependencies 36 | These updates require a local [Docker Desktop](https://www.docker.com/products/docker-desktop/) and a running 37 | docker engine. 38 | 39 | ## Usage 40 | Open a Dockerfile to get diagnostics 41 | 42 | --------------------------------------------------------------------------------