把Python应用构建成Docker镜像
本文使用的项目条件
适用于已经在Python 3.12上跑通的Flask WSGI项目,代码放在app目录,app/__init__.py导出名为app的应用对象,依赖文件requirements.txt已包含并锁定实际验证过的Flask、Gunicorn及其他依赖版本。其他框架要调整启动入口,不能只改镜像名称就认为兼容。
服务器须已安装Docker Engine 28及以上和Compose。构建在独立项目副本中进行,不连接正式数据库、不发送真实通知;安装Docker可参考Ubuntu安装Docker Engine与Compose。本文把源码做成可记录、可验证的镜像,不把运行中的容器当成代码仓库。
一、缩小构建目录并排除敏感文件
在只包含本项目的目录创建.dockerignore:
**/.git
**/.env
**/.env.*
**/*.env
**/*.pem
**/*.key
**/.venv
**/__pycache__
**/backups
**/logs
**/uploads
逐项检查实际目录,额外排除数据库备份、私钥和业务数据。上面的**规则也覆盖子目录,*.env覆盖本例test.runtime.env;自定义名称的秘密文件仍须单独排除。忽略规则只是辅助,后面的COPY仍只复制需要的目录。requirements.txt不要包含带账号密码的下载地址。私有依赖应使用构建专用秘密挂载,不把令牌写进ARG、ENV或镜像层。
二、创建Dockerfile
FROM python:3.12-slim-bookworm
ENV PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY app/ ./app/
RUN chmod -R u=rwX,go=rX /app
USER 10001:10001
EXPOSE 8000
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "app:app"]
COPY后的代码保持root所有,上面的chmod明确授予读取及必要目录穿越权限,并去掉组和其他用户的写权限。10001是容器内的运行UID,应用若要保存上传或文件型数据库,应把数据目录独立挂载,并按该身份设置最小写入权限;不能让业务数据只留在容器可写层。不要为了解决权限问题直接使用root或--privileged。
3.12-slim-bookworm限定了Python系列和系统基础,但标签仍可能更新。先拉取并记录所用基础镜像摘要:
docker pull python:3.12-slim-bookworm
docker image inspect --format '{{index .RepoDigests 0}}' python:3.12-slim-bookworm
需要重复得到同一基础版本时,把输出的python@sha256:实际摘要写入FROM,随代码一起记录。之后有安全更新再重新验证并更换摘要,不能固定后长期不维护。
三、构建并运行隔离检查容器
docker build -t local/myapp:2026-11-15.1 .
docker image inspect --format '{{.Id}} {{.Config.User}}' local/myapp:2026-11-15.1
docker run -d --name myapp-check \
--env-file test.runtime.env \
-p 127.0.0.1:18080:8000 \
local/myapp:2026-11-15.1
docker logs --tail 50 myapp-check
curl -sS -D - -o /dev/null http://127.0.0.1:18080/
日期标签是本次构建编号,换成自己的编号,不反复覆盖同一个标签。test.runtime.env需事先准备,里面只填测试配置并设为600;如果应用无需环境变量,可去掉--env-file。检查端口18080未被占用,容器名也未被其他任务使用。
构建成功只说明镜像生成。还要验证首页或健康接口、一个只读业务请求、日志和进程身份;需要写入的应用应在专用测试卷验证重建后数据仍在。认证、付款或发信测试须使用隔离服务,不能接入生产凭据。
四、保存结果与清理测试容器
docker stop myapp-check
docker rm myapp-check
仅清理这次检查容器,不执行全局prune。保存源码版本、依赖锁定文件、Dockerfile、基础镜像摘要和最终镜像ID。正式更新时使用验证后的同一镜像,并保留旧镜像与数据备份;构建镜像本身不会完成生产发布。
如果日志提示模块找不到,先核对COPY后的目录结构和app:app入口,不要临时进入容器手改代码。依赖需要编译时,应在构建步骤安装明确所需的系统库,或使用构建阶段生成安装包;不要把开发电脑的虚拟环境直接复制进Linux镜像。