在 VS Code 中尝试

在容器内调试 Python

当向 Python 项目添加 Docker 文件时,会添加任务和启动配置以在 Docker 容器中调试应用程序。为了适应 Python 项目的各种场景,某些应用程序可能需要额外的配置。

配置 Docker 容器的入口点

你可以通过在 tasks.json 中设置属性来配置 Docker 容器的入口点。当你首次使用 Docker: Add Docker Files to Workspace... 命令时,VS Code 会自动配置容器入口点。

示例:配置 Python 模块的入口点

{
  "tasks": [
    {
      "type": "docker-run",
      "label": "docker-run: debug",
      "dependsOn": ["docker-build"],
      "python": {
        "module": "myapp"
      }
    }
  ]
}

示例:配置 Python 文件的入口点

{
  "tasks": [
    {
      "type": "docker-run",
      "label": "docker-run: debug",
      "dependsOn": ["docker-build"],
      "python": {
        "args": ["runserver", "0.0.0.0:8000", "--nothreading", "--noreload"],
        "file": "manage.py"
      }
    }
  ]
}

自动将浏览器启动到应用程序的入口页面

你可以选择 Docker: Python - DjangoDocker: Python - Flask 启动配置,以自动将浏览器启动到应用程序的主页。默认情况下启用此功能,但你可以在 launch.json 中设置 dockerServerReadyAction 对象来显式配置此行为。

此功能依赖于应用程序的几个方面

  • 应用程序必须输出到调试控制台或 Docker 日志
  • 应用程序必须记录“server ready”消息。
  • 应用程序必须提供一个可浏览的页面。

以下是使用 dockerServerReadyAction 基于特定服务器消息模式启动浏览器打开 about.html 页面的示例

{
  "configurations": [
    {
      "name": "Docker: Python - Django",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "python": {
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/app"
          }
        ],
        "projectType": "django"
      },
      "dockerServerReadyAction": {
        "action": "openExternally",
        "pattern": "Starting development server at (https?://\\S+|[0-9]+)",
        "uriFormat": "%s://localhost:%s/about.html"
      }
    }
  ]
}

注意pattern 属性中的正则表达式仅尝试捕获类似于“Starting development server at http://localhost:8000”的日志消息。它适用于 http 或 https 的 URL、任何主机名和任何端口的变体。

重要 dockerServerReadyAction 对象属性

  • action:找到模式时要执行的操作。可以是 debugWithChromeopenExternally

  • pattern:如果应用程序记录的消息与上面显示的不同,请将 dockerServerReadyAction 对象的 pattern 属性设置为与该消息匹配的 JavaScript 正则表达式。正则表达式应包含与应用程序正在侦听的端口相对应的捕获组。

  • uriFormat:默认情况下,Docker 扩展将打开浏览器的主页面(由应用程序确定)。如果你希望浏览器打开一个特定页面,如上例所示,则应将 dockerServerReadyAction 对象的 uriFormat 属性设置为包含两个字符串标记的格式字符串,以指示协议和端口替换。

如何在 Django 或 Flask 应用中启用热重载

当你为 Django 或 Flask 选择 Docker: Add Docker Files to Workspace 时,我们会为你提供一个 Dockerfile 和一个配置用于静态部署的 tasks.json。每次更改应用程序代码时,都需要重新生成并重新运行容器。热重载使你能够在容器继续运行时可视化应用程序代码的更改。按照以下步骤启用热重载

对于 Django 应用

  1. 在 Dockerfile 中,注释掉将应用程序代码添加到容器的行。

    #ADD . /app
    
  2. tasks.json 文件中的 docker-run 任务内,创建一个新的 dockerRun 属性,并带有 volumes 属性。此设置创建了从当前工作区文件夹(应用程序代码)到容器中 /app 文件夹的映射。

    {
      "type": "docker-run",
      "label": "docker-run: debug",
      "dependsOn": [
        "docker-build"
      ],
      "dockerRun": {
        "volumes": [
          {
            "containerPath": "/app", "localPath": "${workspaceFolder}"
          }
        ]
      },
      ...
    }
    
  3. 移除 --noreload--nothreading 来编辑 python 属性。

    {
      ...
      "dockerRun": {
        "volumes": [
          {
            "containerPath": "/app", "localPath": "${workspaceFolder}"
          }
        ]
      },
      "python": {
        "args": [
          "runserver",
          "0.0.0.0:8000",
        ],
        "file": "manage.py"
      }
    }
    
  4. 选择 Docker: Python – Django 启动配置,然后按 F5 来生成和运行容器。

  5. 修改并保存任意文件。

  6. 刷新浏览器并验证所做的更改。

对于 Flask 应用

  1. 在 Dockerfile 中,注释掉将应用程序代码添加到容器的行。

    #ADD . /app
    
  2. tasks.json 文件中的 docker-run 任务内,通过在 env 属性中添加 FLASK_ENVvolumes 属性来编辑现有的 dockerRun 属性。此设置创建了从当前工作区文件夹(应用程序代码)到容器中 /app 文件夹的映射。

    {
      "type": "docker-run",
      "label": "docker-run: debug",
      "dependsOn": [
        "docker-build"
      ],
      "dockerRun": {
        "env": {
          "FLASK_APP": "path_to/flask_entry_point.py",
          "FLASK_ENV": "development"
        },
        "volumes": [
          {
            "containerPath": "/app", "localPath": "${workspaceFolder}"
          }
        ]
      },
      ...
    }
    
  3. 移除 --no-reload--no-debugger 来编辑 python 属性。

    {
      ...
      "dockerRun": {
        "env": {
          "FLASK_APP": "path_to/flask_entry_point.py",
          "FLASK_ENV": "development"
        },
        "volumes": [
          {
            "containerPath": "/app", "localPath": "${workspaceFolder}"
          }
        ]
      },
      "python": {
        "args": [
          "run",
          "--host", "0.0.0.0",
          "--port", "5000"
        ],
        "module": "flask"
      }
    }
    
  4. 选择 Docker: Python – Flask 启动配置,然后按 F5 来生成和运行容器。

  5. 修改并保存任意文件。

  6. 刷新浏览器并验证所做的更改。

如何同时生成和运行容器

  1. 在前面提到的 tasks.json 文件中,存在对 docker-build 任务的依赖。该任务是 tasks.json 文件中 tasks 数组的一部分。例如
"tasks":
[
  {
    ...
  },
  {
    "label": "docker-build",
    "type": "docker-build",
    "dockerBuild": {
        "context": "${workspaceFolder}",
        "dockerfile": "${workspaceFolder}/Dockerfile",
        "tag": "YOUR_IMAGE_NAME:YOUR_IMAGE_TAG"
    }
  }
]

提示:由于依赖项明确声明 docker-build 是其依赖项,因此名称必须与此任务匹配。如果需要,可以更改名称。

  1. JSON 中的 dockerBuild 对象允许使用以下参数

    • context:Docker 生成上下文,Dockerfile 从此处调用
    • dockerfile:要执行的 Dockerfile 的路径
    • tag:要生成的映像的名称及其版本标记
  2. 总而言之,用于生成和调试 Flask 应用程序的 VS Code 设置可以是

    • launch.json

      {
        "version": "0.2.0",
        "configurations": [
          {
            "name": "Debug Flask App",
            "type": "docker",
            "request": "launch",
      
            "preLaunchTask": "docker-run: debug",
            "python": {
              "pathMappings": [
                {
                  "localRoot": "${workspaceFolder}",
                  "remoteRoot": "/app"
                }
              ],
              "projectType": "flask"
            },
            "dockerServerReadyAction": {
              "action": "openExternally",
              "pattern": "Running on (http?://\\S+|[0-9]+)",
              "uriFormat": "%s://localhost:%s/"
            }
          }
        ]
      }
      
    • tasks.json

      {
        "version": "2.0.0",
        "tasks": [
          {
            "type": "docker-run",
            "label": "docker-run: debug",
            "dependsOn": ["docker-build"],
            "dockerRun": {
              "containerName": "YOUR_IMAGE_NAME",
              "image": "YOUR_IMAGE_NAME:YOUR_IMAGE_TAG",
              "env": {
                "FLASK_APP": "path_to/flask_entry_point.py",
                "FLASK_ENV": "development"
              },
              "volumes": [
                {
                  "containerPath": "/app",
                  "localPath": "${workspaceFolder}"
                }
              ],
              "ports": [
                {
                  "containerPort": 5000,
                  "hostPort": 5000
                }
              ]
            },
            "python": {
              "args": ["run", "--host", "0.0.0.0", "--port", "5000"],
              "module": "flask"
            }
          },
          {
            "label": "docker-build",
            "type": "docker-build",
            "dockerBuild": {
              "context": "${workspaceFolder}",
              "dockerfile": "${workspaceFolder}/Dockerfile",
              "tag": "YOUR_IMAGE_NAME:YOUR_IMAGE_TAG"
            }
          }
        ]
      }
      

下一步

了解更多关于