使用 Docker Compose
Docker Compose 提供了一种协调多个协同工作容器的方法。示例包括处理请求的服务和前端网站,或者使用 Redis 缓存等支持功能的服务。如果您正在为应用程序开发使用微服务模型,则可以使用 Docker Compose 将应用程序代码分解为多个独立运行的服务,这些服务使用 Web 请求进行通信。本文帮助您为应用程序启用 Docker Compose,无论它们是 Node.js、Python 还是 .NET,并帮助您为这些场景配置 Visual Studio Code 中的调试。
此外,对于单容器场景,使用 Docker Compose 提供了一种与工具无关的配置,这是单个 Dockerfile 无法实现的。容器的卷挂载、端口映射和环境变量等配置设置可以在 docker-compose YML 文件中声明。
要在 VS Code 中使用 Docker Compose(使用 Docker 扩展),您应该已经熟悉 Docker Compose 的基础知识。
向项目添加 Docker Compose 支持
如果您已经有一个或多个 Dockerfile,则可以通过打开命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 并使用 Docker: 将 Docker Compose 文件添加到工作区 命令来添加 Docker Compose 文件。按照提示操作。
您可以在添加 Dockerfile 的同时将 Docker Compose 文件添加到工作区,方法是打开命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 并使用 Docker: 将 Docker 文件添加到工作区 命令。系统会询问您是否要添加 Docker Compose 文件。如果您想保留现有的 Dockerfile,请在提示覆盖 Dockerfile 时选择 否。
Docker 扩展会将 docker-compose.yml
文件添加到您的工作区。此文件包含在生产环境中按预期启动容器的配置。在某些情况下,还会生成 docker-compose.debug.yml
。此文件为启动调试器提供了一种简化的模式。
VS Code Docker 扩展生成的文件可以直接使用,但您也可以自定义它们以针对您的场景进行优化。然后,您可以使用 Docker Compose Up 命令(右键单击 docker-compose.yml
文件,或在命令面板中找到该命令)一次启动所有内容。您还可以使用 VS Code 中的命令提示符或终端窗口中的 docker-compose up
命令来启动容器。有关如何配置 Docker Compose 行为以及哪些命令行选项可用的信息,请参阅 Docker Compose 文档。
使用 docker-compose 文件,您现在可以在 docker-compose 文件中指定端口映射,而不是在 .json 配置文件中指定。有关示例,请参阅 Docker Compose 文档。
提示:使用 Docker Compose 时,请勿指定主机端口。相反,让 Docker 选择一个随机的可用端口,以自动避免端口冲突问题。
向项目添加新容器
如果要添加另一个应用程序或服务,可以再次运行 将 Docker Compose 文件添加到工作区,并选择覆盖现有的 docker-compose 文件,但您将丢失这些文件中的任何自定义设置。如果要保留对 compose 文件的更改,可以手动修改 docker-compose.yml
文件以添加新服务。通常,您可以复制现有的服务部分,粘贴它以创建新条目,并根据新服务更改名称。
您可以再次运行 将 Docker 文件添加到工作区 命令,以生成新应用程序的 Dockerfile
。虽然每个应用程序或服务都有自己的 Dockerfile,但每个工作区通常只有一个 docker-compose.yml
和一个 docker-compose.debug.yml
文件。
在 Python 项目中,您在工作区的根文件夹中拥有 Dockerfile
、.dockerignore
、docker-compose*.yml
文件。当您添加另一个应用程序或服务时,请将 Dockerfile 移动到应用程序的文件夹中。
在 Node.js 项目中,Dockerfile
和 .dockerignore
文件将与该服务的 package.json
文件位于同一位置。
对于 .NET,当您创建 Docker Compose 文件时,文件夹结构已设置为处理多个项目,.dockerignore
和 docker-compose*.yml
放置在工作区根目录中(例如,如果项目在 src/project1
中,则文件在 src
中),因此当您添加另一个服务时,您可以在文件夹(例如 project2
)中创建另一个项目,并按照前面所述重新创建或修改 docker-compose 文件。
调试
首先,请参阅目标平台的调试文档,以了解使用 VS Code 在容器中进行调试的基础知识
如果要在 Docker Compose 中进行调试,请使用前面部分中描述的两个 Docker Compose 文件之一运行 Docker Compose Up 命令,然后使用相应的 附加 启动配置进行附加。直接使用普通启动配置启动不会使用 Docker Compose。
创建 附加 启动配置。这是 launch.json
中的一个部分。该过程主要是手动的,但在某些情况下,Docker 扩展可以通过添加预配置的启动配置来提供帮助,您可以将其用作模板并进行自定义。以下部分描述了每个平台(Node.js、Python 和 .NET)的过程。
Node.js
-
在 调试 选项卡上,选择 配置 下拉列表,选择 新建配置,然后选择
Docker Attach
配置模板 Node.js Docker Attach (Preview)。 -
在
docker-compose.debug.yml
中配置调试端口。这是在您创建文件时设置的,因此您可能不需要更改它。在下面的示例中,端口 9229 用于主机和容器上的调试。version: '3.4' services: node-hello: image: node-hello build: . environment: NODE_ENV: development ports: - 3000 - 9229:9229 command: node --inspect=0.0.0.0:9229 ./bin/www
-
如果您有多个应用程序,则需要更改其中一些应用程序的端口,以便每个应用程序都有一个唯一的端口。您可以在
launch.json
中指向正确的调试端口,然后保存文件。如果省略此步骤,将自动选择端口。这是一个示例,显示了 Node.js 启动配置 - 附加
"configurations": [ { "type": "node", "request": "attach", "name": "Docker: Attach to Node", "remoteRoot": "/usr/src/app", "port": 9229 // Optional; otherwise inferred from the docker-compose.debug.yml. }, // ... ]
-
完成编辑 附加 配置后,保存
launch.json
,然后选择新的启动配置作为活动配置。在 调试 选项卡中,在 配置 下拉列表中找到新的配置。 -
右键单击
docker-compose.debug.yml
文件,然后选择 Compose Up。 -
当您附加到公开返回 HTML 的 HTTP 端点的服务时,Web 浏览器不会自动打开。要在浏览器中打开应用程序,请在侧边栏中选择容器,右键单击并选择 在浏览器中打开。如果配置了多个端口,系统会要求您选择端口。
-
以通常的方式启动调试器。在 调试 选项卡中,选择绿色箭头(启动 按钮)或使用 F5。
Python
要使用 Docker Compose 调试 Python,请按照以下步骤操作
-
在 调试 选项卡上,选择 配置 下拉列表,选择 新建配置,选择 Python 调试器,然后选择
远程附加
配置模板。 -
系统会提示您选择要用于调试的主机(例如,localhost)和端口。Python 的默认调试端口为 5678。如果您有多个应用程序,则需要更改其中一个应用程序的端口,以便每个应用程序都有一个唯一的端口。您可以在
launch.json
中指向正确的调试端口,然后保存文件。如果省略此步骤,将自动选择端口。"configurations": [ { "name": "Python Debugger: Remote Attach", "type": "debugpy", "request": "attach", "port": 5678, "host": "localhost", "pathMappings": [ { "localRoot": "${workspaceFolder}", "remoteRoot": "/app" } ] }
-
完成编辑 附加 配置后,保存
launch.json
。导航到 调试 选项卡,然后选择 Python 调试器: 远程附加 作为活动配置。 -
如果您已经有一个有效的 Dockerfile,我们建议运行命令 Docker: 将 Docker Compose 文件添加到工作区。这将创建一个
docker-compose.yml
文件和一个docker-compose.debug.yml
文件,它们将卷映射并在容器中启动 Python 调试器。如果您尚未拥有 Dockerfile,我们建议运行 Docker: 将 Docker 文件添加到工作区 并选择 是 以包含 Docker Compose 文件。注意:默认情况下,使用 Docker: 将 Docker 文件添加到工作区 时,选择 Django 和 Flask 选项将搭建一个为 Gunicorn 配置的 Dockerfile。请按照 容器中 Python 快速入门 中的说明进行操作,以确保在继续之前正确配置它。
-
右键单击
docker-compose.debug.yml
文件(如下所示),然后选择 Compose Up。version: '3.4' services: pythonsamplevscodedjangotutorial: image: pythonsamplevscodedjangotutorial build: context: . dockerfile: ./Dockerfile command: ["sh", "-c", "pip install debugpy -t /tmp && python /tmp/debugpy --wait-for-client --listen 0.0.0.0:5678 manage.py runserver 0.0.0.0:8000 --nothreading --noreload"] ports: - 8000:8000 - 5678:5678
-
构建并运行容器后,通过按 F5 并选择 Python 调试器: 远程附加 启动配置来附加调试器。
注意: 如果您想将 Python 调试器导入到特定文件中,可以在 debugpy README 中找到更多信息。
-
当您附加到公开 HTTP 端点并返回 HTML 的服务时,Web 浏览器可能不会自动打开。要在浏览器中打开应用程序,请右键单击 Docker 资源管理器中的容器,然后选择 在浏览器中打开。如果配置了多个端口,系统会要求您选择端口。
您现在正在容器中调试正在运行的应用程序。
.NET
-
在 调试 选项卡上,选择 配置 下拉列表,选择 新建配置,然后选择
Docker Attach
配置模板 .NET Core Docker Attach (Preview)。 -
VS Code 尝试使用默认路径将
vsdbg
从主机复制到目标容器。您还可以在 附加 配置中提供vsdbg
现有实例的路径。"netCore": { "debuggerPath": "/remote_debugger/vsdbg" }
-
完成编辑 附加 配置后,保存
launch.json
,然后选择新的启动配置作为活动配置。在 调试 选项卡中,在 配置 下拉列表中找到新的配置。 -
右键单击
docker-compose.debug.yml
文件,然后选择 Compose Up。 -
当您附加到公开返回 HTML 的 HTTP 端点的服务时,Web 浏览器不会自动打开。要在浏览器中打开应用程序,请在侧边栏中选择容器,右键单击并选择 在浏览器中打开。如果配置了多个端口,系统会要求您选择端口。
-
以通常的方式启动调试器。在 调试 选项卡中,选择绿色箭头(启动 按钮)或使用 F5。
-
如果您尝试附加到在容器中运行的 .NET 应用程序,您将看到一个提示,要求您选择应用程序的容器。
要跳过此步骤,请在 launch.json 的 附加 配置中指定容器名称
"containerName": "Your ContainerName"
接下来,系统会询问您是否要将调试器 (
vsdbg
) 复制到容器中。选择 是。
如果一切配置正确,调试器应附加到您的 .NET 应用程序。
卷挂载
默认情况下,Docker 扩展不会对调试组件进行任何卷挂载。在 .NET 或 Node.js 中不需要这样做,因为所需的组件已构建到运行时中。如果您的应用程序需要卷挂载,请使用 docker-compose*.yml
文件中的 volumes
标记指定它们。
volumes:
- /host-folder-path:/container-folder-path
具有多个 Compose 文件的 Docker Compose
工作区可以有多个 docker-compose 文件来处理不同的环境,例如开发、测试和生产。配置的内容可以拆分为多个文件。例如,一个基本 compose 文件,用于定义所有环境的通用信息,以及单独的覆盖文件,用于定义特定于环境的信息。当这些文件作为输入传递到 docker-compose
命令时,它会将这些文件合并为一个配置。默认情况下,Docker: Compose Up 命令将单个文件作为输入传递到 compose 命令,但您可以自定义 compose up
命令以使用 命令自定义 传入多个文件。或者,您可以使用 自定义任务 来调用带有所需参数的 docker-compose
命令。
注意:如果您的工作区具有
docker-compose.yml
和docker-compose.override.yml
且没有其他 compose 文件,则docker-compose
命令将在没有输入文件的情况下调用,并且它会隐式使用这些文件。在这种情况下,无需自定义。
命令自定义
命令自定义 提供了根据您的要求自定义 compose up
命令的各种方法。以下是 compose up
命令的一些示例命令自定义。
基本文件和覆盖文件
假设您的工作区有一个基本 compose 文件 (docker-compose.yml
) 和每个环境的覆盖文件 (docker-compose.dev.yml
、docker-compose.test.yml
和 docker-compose.prod.yml
),并且您始终使用基本文件和覆盖文件运行 docker compose up
。在这种情况下,可以按照以下示例自定义 compose up
命令。当调用 compose up
命令时,${configurationFile}
将替换为选定的文件。
"docker.commands.composeUp": [
{
"label": "override",
"template": "docker-compose -f docker-compose.yml ${configurationFile} up -d --build",
}
]
模板匹配
假设您为每个环境使用不同的输入文件集。您可以定义具有正则表达式匹配的多个模板,并且选定的文件名将与此 match
属性匹配,并将使用相应的模板。
"docker.commands.composeUp": [
{
"label": "dev-match",
"template": "docker-compose -f docker-compose.yml -f docker-compose.debug.yml -f docker-compose.dev.yml up -d --build",
"match": "dev"
},
{
"label": "test-match",
"template": "docker-compose -f docker-compose.yml -f docker-compose.debug.yml -f docker-compose.test.yml up -d --build",
"match": "test"
},
{
"label": "prod-match",
"template": "docker-compose -f docker-compose.yml -f docker-compose.release.yml -f docker-compose.prod.yml up -d --build",
"match": "prod"
}
]
在调用命令时选择模板
如果您从命令模板中省略 match
属性,则每次调用 compose up
命令时,系统都会询问您要使用哪个模板。例如
"docker.commands.composeUp": [
{
"label": "dev",
"template": "docker-compose -f docker-compose.yml -f docker-compose.common.dev.yml ${configurationFile} up -d --build"
},
{
"label": "test",
"template": "docker-compose -f docker-compose.yml -f docker-compose.common.test.yml ${configurationFile} up -d --build"
},
{
"label": "prod",
"template": "docker-compose -f docker-compose.yml -f docker-compose.common.prod.yml ${configurationFile} up -d --build"
},
],
自定义任务
除了使用命令自定义之外,您还可以定义如下任务来调用 docker-compose
命令。有关此选项的更多详细信息,请参阅 自定义任务。
{
"type": "shell",
"label": "compose-up-dev",
"command": "docker-compose -f docker-compose.yml -f docker-compose.Common.yml -f docker-compose.dev.yml up -d --build",
"presentation": {
"reveal": "always",
"panel": "new"
}
}