如何在Docker环境中实现Django代码修改后的自动重载？

问题描述 #

我对Docker及部署相关技术不太熟悉。现有一个使用rpy2的Django应用已通过Docker容器部署，希望在Docker环境中持续开发测试，无需频繁启停容器。了解到使用Volumes可实现自动重载功能，但尝试后要么容器正常运行但代码更新不生效，要么出现找不到manage.py的错误，请问如何恢复自动重载功能？

现有Dockerfile #

FROM rocker/r-ver:4.1.1
ENV RENV_VERSION 0.14.0

# Install system dependencies
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    python3-pip \
    python3-setuptools \
    python3-dev \
    libcurl4-openssl-dev \
    libssl-dev \
    libfontconfig1-dev \
    libxml2-dev \
    libharfbuzz-dev \
    libfribidi-dev \
    libfreetype6-dev \
    libpng-dev \
    libtiff5-dev \
    libjpeg-dev \
    libbz2-dev \
    libopenblas-dev \
    unixodbc-dev \
    libcairo2-dev \
    zlib1g-dev \
    curl \
    libpq-dev

RUN apt-get update && apt-get install -y cmake
RUN apt-get install -y --no-install-recommends libxt6

WORKDIR /app
COPY requirements.txt requirements.txt
RUN pip3 install -r requirements.txt

RUN R -e "install.packages('remotes')"
RUN R -e "remotes::install_github('rstudio/renv@${RENV_VERSION}')"
COPY renv.lock renv.lock
RUN R -e "renv::restore()"

RUN R_HOME=$(R RHOME) && echo "R_HOME=$R_HOME" && export R_HOME
ENV R_HOME=${R_HOME}

COPY custom_package.tar.gz custom_package.tar.gz
RUN R -e "remotes::install_local('custom_package.tar.gz', dependencies = F, force = T, upgrade = 'never')"

RUN R -e "install.packages('glmnet')"

## Expose port to allow app to run locally
EXPOSE 8000

COPY . .

CMD ["python3","manage.py","runserver", "0.0.0.0:8000"]

现有docker-compose.yml #

version: '3.8'

services:
  django:
    image: django-docker:0.0.1
    build: .
    ports:
      - "8000:8000"
    environment:
    - DEBUG=1

解决步骤 #

1. 修改docker-compose.yml，添加本地目录挂载 #

在django服务中配置volumes，将本地项目根目录挂载到容器内的/app，同时排除容器内已安装的依赖目录，避免本地目录覆盖容器内的关键依赖：

修改后的docker-compose.yml：

version: '3.8'

services:
  django:
    image: django-docker:0.0.1
    build: .
    ports:
      - "8000:8000"
    environment:
      - DEBUG=1
    volumes:
      - ./:/app  # 挂载本地项目目录到容器内的/app目录
      - /app/renv  # 保留容器内的renv环境，防止被本地目录覆盖
      - /app/__pycache__  # 排除Python缓存目录，避免冲突

2. 确认自动重载的前置条件 #

• 确保DEBUG=1已生效：容器内的环境变量DEBUG必须设为1，这是Django自动重载的必要条件，你的docker-compose已经配置了该环境变量。
• 确认runserver命令正确：Dockerfile中的CMD ["python3","manage.py","runserver", "0.0.0.0:8000"]是正确的，Django的runserver默认在DEBUG模式下开启自动重载。

3. 避免挂载覆盖容器内关键文件 #

• 不要挂载本地的renv目录到容器：容器内的renv是构建阶段已经安装好所有R依赖的环境，本地的renv可能不完整或缺失依赖，用/app/renv这种匿名卷可以保留容器内的原始目录。
• 关于custom_package.tar.gz：该文件在构建阶段已被安装到容器中，若本地不需要修改这个包，挂载本地目录后如果本地没有该文件，容器内依然会保留构建时的版本；若需要修改，建议重新构建镜像或调整挂载策略。

4. 验证自动重载功能 #

1. 启动容器：docker-compose up --build
2. 修改本地的Django代码（比如views.py或模板文件）并保存
3. 查看容器日志，应该能看到类似Watching for file changes with StatReloader的重载提示
4. 刷新浏览器页面，即可看到代码更新后的效果

常见问题排查 #

• 代码更新不生效：
  1. 检查挂载是否正常：执行docker-compose exec django ls /app，确认容器内的文件和本地文件一致
  2. 确认DEBUG模式开启：执行docker-compose exec django echo $DEBUG，输出应为1
• 找不到manage.py：
  1. 确认本地项目根目录下存在manage.py文件
  2. 检查挂载路径是否正确：./对应本地项目根目录，容器内路径为/app，所以manage.py在容器内的路径应为/app/manage.py

内容的提问来源于stack exchange，提问作者Jaimee-lee Lincoln