调试模式:Django Docker Pycharm

星宇姑娘_6931

星宇姑娘_6931

2024-09-07

1187人浏览

转载

调试模式:django docker pycharm

让您的本地设置正确调试您正在编写的代码所花费的时间比任何开发人员都愿意承认的要多。我们不要忘记,这主要是一个一次性完成的设置,所以如果我们不写下来,我们就不会记得。这篇文章就是为了解决这个确切的问题! 将此作为如何启动并运行本地开发环境的书面提醒。

先决条件:

  • pycharm professional(用于 docker 支持)
  • docker 和 docker compose
  • django rest framework (drf) 应用程序
除了调试模式所需的更新之外,本文不会介绍有关 django、docker 或 docker composer 设置的详细信息。它假设您已经掌握了如何使该部件工作的实用知识。

第 1 步:用于调试的 dockerfile 设置

将 dockerfile 设置为在开发模式下运行并允许来自 pycharm 调试器的连接。

下面是一个 dockerfile 示例:

# builder stage
from python:3.9-slim as builder

run chmod 1777 /tmp

# install system dependencies
run apt-get update && apt-get install -y \
    libpq-dev \
    build-essential

workdir /app

# copy the requirements file into the container
copy requirements.txt /app/
run pip install --no-cache-dir -r requirements.txt > pip_install.log

# copy the current directory contents into the container
copy . /app

# collect static files
run python manage.py collectstatic --noinput

# final stage
from python:3.9-slim

# set environment variables
env pythonunbuffered=1
env django_settings_module=template.settings.development

# set work directory
workdir /app

# copy files from the builder stage
copy --from=builder /app /app

# install pydevd-pycharm for remote debugging and gunicorn for serving
run pip install gunicorn pydevd-pycharm==241.17890.14 psycopg2-binary

# expose necessary ports
expose 8000 5679  # web app port and debug port

# entry point for the container
entrypoint ["sh", "-c", "python manage.py runserver 0.0.0.0:8000"]

有关此代码的注意事项

  • pydevd-pycharm 中的 241.17890.14==241.17890.14 会有所不同,具体取决于您拥有的 pycharm 版本
  • 我们公开 8000(web 服务器端口)和 5679(调试器端口)以供外部访问。

第2步:docker compose配置

让我们的 docker-compose.yml 文件来配置 web 服务(django 应用程序)以及数据库和其他服务。

这是一个示例 docker-compose.yml:

version: '3'

services:
  web:
    environment:
      - django_environment=development
      - db_host=host.docker.internal
    build:
      context: .
    command: >
      sh -c "python manage.py migrate &&
             python manage.py collectstatic --noinput &&
             python manage.py runserver 0.0.0.0:8000"
    volumes:
      - .:/app
    ports:
      - "8000:8000"   # expose web port
      - "5679:5679"   # expose debugger port
    extra_hosts:
      - "host.docker.internal:host-gateway"
  db:
    image: postgres:13
    environment:
      - postgres_db=${db_name}
      - postgres_user=${db_user}
      - postgres_password=${db_password}

让我们进入代码分解

  • 我们正在为 web 服务器映射端口 8000,为 pycharm 调试器映射端口 5679。
  • extra_hosts 确保您的 docker 容器可以使用 host.docker.internal 与主机通信。

步骤 3:配置 pycharm 进行调试

  1. 创建 python 调试服务器配置:
  2. 在 pycharm 中导航至“运行 ➡️ 编辑配置”。
  3. 单击 + 按钮并选择 python 调试服务器。
  4. 将主机设置为 0.0.0.0 或本地计算机的 ip 地址。
  5. 将端口设置为 5679(或您在 docker 设置中公开的端口)。
  6. 然后点击“保存”!

    Docker Compose Optimizer
    Docker Compose Optimizer

    优化 Docker Compose 配置,适用于开发和生产环境——审计服务、网络、卷、健康检查和资源管理。

    下载
  7. 启动调试器服务器:
    单击“调试”按钮(绿色错误图标)启动 pycharm 调试器。这将开始侦听我们设置的端口。

第四步:向django添加远程调试代码

在 django 项目中,您需要在 manage.py 或 wsgi.py 中添加以下代码以连接到 pycharm 调试器:

import pydevd_pycharm

# connect to the pycharm debug server
pydevd_pycharm.settrace('host.docker.internal', port=5679, stdouttoserver=true, stderrtoserver=true, suspend=false)

此代码片段告诉您的 django 应用程序连接回主机上运行的 pycharm 调试器。 host.docker.internal 解析为 docker 中的主机,port=5679 与我们之前暴露的端口匹配。

第 5 步:运行 docker 并调试

  1. 构建并运行 docker: 运行以下命令来启动容器:
docker-compose up --build

这将构建 docker 镜像并启动服务,包括在开发模式下运行的 django。

2。设置断点:
在 pycharm 中的 django 代码中设置断点。断点应该有效,因为您的容器将连接到在端口 5679 上运行的 pycharm 调试服务器。

3。触发您的代码:
现在,在 django rest framework api 中触发任何 http 请求。当代码到达断点时,pycharm 将暂停执行,允许您检查当前状态并单步执行代码。

第 6 步:故障排除

如果您在运行 docker 时遇到错误“bind: address already in use”,则说明另一个进程已使用端口 5679。在这种情况下,您可以:

  • 停止 pycharm 调试器并重新启动 docker。
  • 更改 docker-compose.yml 和 pycharm 配置中的端口以避免冲突。

结论

这是我使用 pycharm 强大的调试器在 docker 容器内以开发模式运行 django rest framework 应用程序的设置。此设置可以帮助我通过在本地逐行调试代码来调试后端代码。

通过设置 docker 容器与 pycharm 通信,您可以简化 django 应用程序的编写、测试和调试,从而更轻松地编写代码!

祝你破解代码愉快!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python docker composer pycharm

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.25

364

5

Composer 安装与快速入门指南
Composer 安装与快速入门指南

面向 PHP 开发新手,详细介绍 Composer 的下载安装方式(本地安装与全局安装)、国内镜像源(阿里云/腾讯云)加速配置、composer.json 与 composer.lock 文件的作用解析、require/install/update 等核心命令的使用方法,帮助开发者快速掌握 PHP 依赖管理的基本工作流。

2026.04.10

603

36

Composer 依赖管理与版本控制实战
Composer 依赖管理与版本控制实战

深入讲解 Composer 的依赖管理机制,涵盖语义化版本号规范、版本约束符(^、~、*、>=)的区别与最佳实践、composer.lock 在团队协作中的锁定策略、依赖冲突的排查与解决方法、require-dev 与生产依赖的分离管理、平台依赖检查(platform-check)等进阶内容,帮助开发者在项目中精准控制依赖版本、避免"依赖地狱"。

2026.04.10

367

29

Composer 自定义包开发与发布教程合集
Composer 自定义包开发与发布教程合集

以实际项目为导向,讲解如何从零创建一个符合规范的 Composer 包,涵盖 composer.json 元信息配置、PSR-4 自动加载规则设置、命名空间规划、单元测试集成、README 与 LICENSE 编写规范,以及将包提交到 Packagist 公共仓库或搭建 Satis/Private Packagist 私有仓库的完整发布流程,帮助开发者将可复用代码封装为标准化的 Composer 包。

2026.04.10

369

15

Composer 自动加载机制与性能优化
Composer 自动加载机制与性能优化

系统剖析 Composer 的自动加载体系,讲解 PSR-0 与 PSR-4 自动加载标准的区别与演进、classmap 与 files 加载方式的适用场景、autoload_real.php 源码级加载流程解析,同时介绍 composer dump-autoload -o 优化加载映射、APCu 缓存加速、authoritative-classmap 配置等生产环境性能优化手段,帮助开发者深入理解自动加载原理并提升项目启动速度。

2026.04.13

320

21

Composer 在主流 PHP 框架中的应用实践
Composer 在主流 PHP 框架中的应用实践

结合 Laravel、ThinkPHP、Symfony 等主流 PHP 框架的实际场景,讲解 Composer 在框架项目中的典型应用,包括通过 create-project 初始化框架项目、安装与管理第三方扩展包、scripts 钩子(post-install/post-update)自动执行部署任务、自定义 Installer 插件开发、多项目共享 vendor 依赖的 Monorepo 工作流管理,帮助开发者在真实框架项目中充分发

2026.04.13

523

14

Composer 镜像源配置与网络问题排查
Composer 镜像源配置与网络问题排查

针对国内开发者常遇到的 Composer 网络问题,详细讲解阿里云、腾讯云、华为云等国内镜像源的全局与项目级切换方法、多镜像源优先级配置策略、composer config 命令行快速设置技巧,同时涵盖 SSL 证书错误、连接超时、下载中断等常见网络报错的排查与修复方案,以及利用 artifact / path 仓库实现完全离线环境下的依赖安装。

2026.04.14

311

24

Composer Scripts 脚本与自动化工作流
Composer Scripts 脚本与自动化工作流

系统讲解 Composer Scripts 机制的完整用法,涵盖 pre-install、post-update、post-autoload-dump 等内置事件钩子的触发时机与应用场景、自定义脚本命令的定义与参数传递、调用外部 Shell 命令与 PHP 静态方法、多脚本串联执行与条件判断,以及结合代码检查(PHPStan/PHP-CS-Fixer)、数据库迁移、缓存清理等任务构建一键部署自动化工作流。

2026.04.14

370

18

Composer 私有仓库搭建与企业级管理
Composer 私有仓库搭建与企业级管理

面向团队与企业开发场景,讲解如何使用 Satis 搭建轻量级静态私有仓库、通过 Toran Proxy / Private Packagist 构建功能完善的企业级私有包管理平台,涵盖 Git/SVN 仓库类型接入、Token 鉴权与访问权限控制、Webhook 自动触发包更新、内网部署方案以及与 GitLab CI/CD 流水线的集成配置,帮助企业安全高效地管理内部 PHP 组件资产。

2026.04.14

420

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习