|
1 | | -## Docker for Visual Studio Code [](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) [](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) |
| 1 | +# Docker Extension Pack for Visual Studio Code |
| 2 | +The Docker Extension Pack makes it easy to build, manage, and deploy containerized applications from Visual Studio Code. |
2 | 3 |
|
3 | | -The Docker extension makes it easy to build, manage, and deploy containerized applications from Visual Studio Code. It also provides one-click debugging of Node.js, Python, and .NET inside a container. |
| 4 | +## Overview |
| 5 | +The Docker extension has become the Docker Extension Pack. It currently contains one extension. |
4 | 6 |
|
5 | | - |
6 | | - |
7 | | -**Check out the [Working with containers](https://aka.ms/AA7arez) topic on the Visual Studio Code documentation site to get started**. |
8 | | - |
9 | | -[The Docker extension wiki](https://github.com/Microsoft/vscode-docker/wiki) has troubleshooting tips and additional technical information. |
10 | | - |
11 | | -## Installation |
12 | | - |
13 | | -[Install Docker](https://docs.docker.com/install/) on your machine and add it to the system path. |
14 | | - |
15 | | -On Linux, you should [enable rootless Docker](https://docs.docker.com/engine/security/rootless/) and set the generated Docker context to "rootless" (more secure) or [enable Docker CLI for the non-root user account](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) (less secure) that will be used to run VS Code. |
16 | | - |
17 | | -To install the extension, open the Extensions view, search for `docker` to filter results and select Docker extension authored by Microsoft. |
18 | | - |
19 | | -## Overview of the extension features |
20 | | - |
21 | | -### Editing Docker files |
22 | | - |
23 | | -You can get IntelliSense when editing your `Dockerfile` and `docker-compose.yml` files, with completions and syntax help for common commands. |
24 | | - |
25 | | - |
26 | | - |
27 | | -In addition, you can use the Problems panel (<kbd>Ctrl+Shift+M</kbd> on Windows/Linux, <kbd>Shift+Command+M</kbd> on Mac) to view common errors for `Dockerfile` and `docker-compose.yml` files. |
28 | | - |
29 | | -### Generating Docker files |
30 | | - |
31 | | -You can add Docker files to your workspace by opening the Command Palette (<kbd>F1</kbd>) and using **Docker: Add Docker Files to Workspace** command. The command will generate a `Dockerfile` and `.dockerignore` file and add them to your workspace. The command will also ask you if you want to add Docker Compose files as well, but this is optional. |
32 | | - |
33 | | -The extension can scaffold Docker files for most popular development languages (C#, Node.js, Python, Ruby, Go, and Java) and customizes the generated Docker files accordingly. When these files are created, we also create the necessary artifacts to provide first-class debugging support for Node.js, Python, and .NET (C#). |
34 | | - |
35 | | -### Docker Explorer |
36 | | - |
37 | | -The Docker extension contributes a Docker Explorer view to VS Code. The Docker Explorer lets you examine and manage Docker assets: containers, images, volumes, networks, and container registries. |
38 | | - |
39 | | -The right-click menu provides access to commonly used commands for each type of asset. |
40 | | - |
41 | | - |
42 | | - |
43 | | -You can rearrange the Docker view panes by dragging them up or down with a mouse and use the context menu to hide or show them. |
44 | | - |
45 | | - |
46 | | - |
47 | | -### Docker commands |
48 | | - |
49 | | -Many of the most common Docker commands are built right into the Command Palette: |
50 | | - |
51 | | - |
52 | | - |
53 | | -You can run Docker commands to manage [images](https://docs.docker.com/engine/reference/commandline/image/), [networks](https://docs.docker.com/engine/reference/commandline/network/), [volumes](https://docs.docker.com/engine/reference/commandline/volume/), [image registries](https://docs.docker.com/engine/reference/commandline/push/), and [Docker Compose](https://docs.docker.com/compose/reference/overview/). In addition, the **Docker: Prune System** command will remove stopped containers, dangling images, and unused networks and volumes. |
54 | | - |
55 | | - |
56 | | -### Docker Compose |
57 | | - |
58 | | -[Docker Compose](https://docs.docker.com/compose/) lets you define and run multi-container applications with Docker. Our [Compose Language Service](https://github.com/microsoft/compose-language-service) in the Docker extension gives you IntelliSense and tab completions when authoring `docker-compose.yml` files. Press `Ctrl+Space` to see a list of valid Compose directives. |
59 | | - |
60 | | -  |
61 | | - |
62 | | - |
63 | | -We also provide tooltips when you hover over a Docker Compose YAML attribute. |
64 | | - |
65 | | -  |
66 | | - |
67 | | - |
68 | | -While `Compose Up` allows you to run all of your services at once, our new feature `Compose Up - Select Services` lets you select any combination of the services you want to run. |
69 | | - |
70 | | - |
71 | | - |
72 | | -Once your `Compose Up` command completes, navigate to the Docker Explorer to view your services as a Compose Group. This allows you to start, stop, and view the logs of each service as a group. |
73 | | - |
74 | | - |
75 | | - |
76 | | -### Using image registries |
77 | | - |
78 | | -You can display the content and push, pull, or delete images from [Docker Hub](https://hub.docker.com/) and [Azure Container Registry](https://docs.microsoft.com/azure/container-registry/): |
79 | | - |
80 | | - |
81 | | - |
82 | | -An image in an Azure Container Registry can be deployed to Azure App Service directly from VS Code. See [Deploy images to Azure App Service](https://aka.ms/AA7arf8) to get started. For more information about how to authenticate to and work with registries, see [Using container registries](https://aka.ms/AA7arf9). |
83 | | - |
84 | | -### Debugging services running inside a container |
85 | | - |
86 | | -You can debug services built using Node.js, Python, or .NET (C#) that are running inside a container. The extension offers custom tasks that help with launching a service under the debugger and with attaching the debugger to a running service instance. For more information, see [Debug containerized apps](https://aka.ms/AA7arfb) and [Customize the Docker extension](https://aka.ms/AA7ay8l). |
87 | | - |
88 | | -### Azure CLI integration |
89 | | - |
90 | | -You can start Azure CLI (command-line interface) in a standalone, Linux-based container with **Docker Images: Run Azure CLI** command. This gives you access to the full Azure CLI command set in an isolated environment. For more information on available commands, see [Get started with Azure CLI](https://docs.microsoft.com/cli/azure/get-started-with-azure-cli?view=azure-cli-latest#sign-in). |
| 7 | +### Container Tools |
| 8 | +The [Container Tools](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-containers) extension replaces the Docker extension for Visual Studio Code. It contains all the functionality of the Docker extension, with additional Podman support and other features. If you want, you can uninstall this extension pack, keeping only Container Tools. |
91 | 9 |
|
92 | 10 | ## Contributing |
93 | 11 |
|
|
0 commit comments