代码变更时如何无需手动执行docker-compose build自动更新Docker容器

你当前的配置已经通过volumes将本地代码目录挂载到了容器内的/app路径，正常情况下本地代码变更会实时同步到容器中，Django自带的runserver默认开启文件变更检测自动重载服务，无需重新构建镜像。需要手动build才更新通常是以下两类原因：

1. 代码变更的同步或检测链路存在问题
2. 变更的是依赖、Dockerfile等需要重建镜像才能生效的文件

场景1：业务代码变更需要自动重载 #

按以下步骤排查配置即可实现代码变更自动重载，无需重新构建镜像：

• 确认runserver未关闭重载功能：你的启动命令python manage.py runserver 0.0.0.0:8000默认开启重载，不要额外添加--noreload参数
• 跨系统文件通知失效修复：如果你是Windows/WSL/macOS环境，容器可能无法接收到宿主机的文件变更通知，将启动命令修改为python manage.py runserver --py-autoreload 1 0.0.0.0:8000，开启强制轮询检测文件变更即可

场景2：Dockerfile/requirements.txt等配置变更需要自动更新 #

如果变更的是依赖包、Dockerfile配置，必须重建镜像才能生效，可通过以下方式实现自动处理：

• 使用Docker Compose自带的watch功能（需要Compose V2.22及以上版本）：在你的docker-compose.yml的backend服务下新增如下配置

develop:
  watch:
    # 同步普通业务代码变更，无需重建镜像
    - action: sync
      path: .
      target: /app
      ignore:
        - requirements.txt
        - Dockerfile
        - .git
    # 检测到requirements.txt变更自动重建镜像
    - action: rebuild
      path: requirements.txt
    # 检测到Dockerfile变更自动重建镜像
    - action: rebuild
      path: Dockerfile

配置完成后执行docker compose watch启动服务，即可实现配置变更自动重建镜像、重启容器。

• 也可以使用watchexec等文件监控工具，监控指定文件变更自动触发docker-compose up -d --build命令，示例命令：watchexec -w Dockerfile -w requirements.txt "docker-compose up -d --build"

• 以上自动更新方案仅适用于开发环境，生产环境禁止使用Django runserver和自动重载配置，建议使用Gunicorn/uWSGI等生产级WSGI服务器
• 数据库迁移文件、静态文件变更需要手动执行对应命令生效，无法通过上述自动更新逻辑处理

内容的提问来源于stack exchange，提问作者Ayaz Khan