用 Dockerfile 构建 Python 应用镜像:从入门到瘦身

举报
yd_291309839 发表于 2026/11/15 14:15:51 2026/11/15
【摘要】 很多人学会 docker run 之后,下一步就是把自己的项目打成镜像。本文用一个小型 Flask 应用,演示如何写出一份清晰、体积合理的 Dockerfile。1. 准备项目目录结构:app/├── app.py├── requirements.txt└── Dockerfileapp.py:from flask import Flaskapp = Flask(__name__)@app....

很多人学会 docker run 之后,下一步就是把自己的项目打成镜像。本文用一个小型 Flask 应用,演示如何写出一份清晰、体积合理的 Dockerfile。

1. 准备项目

目录结构:

app/
├── app.py
├── requirements.txt
└── Dockerfile

app.py:

from flask import Flask
app = Flask(__name__)

@app.get("/")
def index():
    return "hello docker"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=5000)

requirements.txt 只写一行:flask==3.0.3。

2. 第一版 Dockerfile

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "app.py"]

几个要点:

  • 选 slim 基础镜像,比完整版小几百 MB。
  • 先复制 requirements.txt 再安装依赖,最后才复制源码。Docker 按层缓存,只改代码时依赖层不会重装,构建很快。
  • --no-cache-dir 避免把 pip 缓存留在镜像里。

3. 构建与运行

docker build -t flask-demo:1.0 .
docker run -d --name demo -p 5000:5000 flask-demo:1.0
curl http://127.0.0.1:5000

看到 hello docker 就成功了。docker logs demo 查看日志,docker rm -f demo 删除容器。

4. 加上 .dockerignore

在同目录建 .dockerignore:

__pycache__/
*.pyc
.git
.venv

这样 COPY . . 不会把虚拟环境和 Git 历史带进镜像,既减小体积,也避免泄露无关文件。

5. 用非 root 用户运行

默认容器内是 root,生产里不推荐。在 CMD 前加:

RUN useradd -m appuser
USER appuser

6. 多阶段构建(进阶)

依赖里需要编译的包(如部分科学计算库)会引入 gcc 等工具链。可以在第一阶段编译,第二阶段只拷贝结果:

FROM python:3.12-slim AS builder
WORKDIR /w
COPY requirements.txt .
RUN pip install --no-cache-dir --prefix=/install -r requirements.txt

FROM python:3.12-slim
COPY --from=builder /install /usr/local
WORKDIR /app
COPY . .
CMD ["python", "app.py"]

最终镜像不含编译工具,体积更小。

7. 常见问题

  • 容器里访问不到服务:程序要监听 0.0.0.0,不能是 127.0.0.1。
  • 改了代码没生效:确认重新 docker build,或开发时用 -v $(pwd):/app 挂载目录。
  • 构建很慢:检查层顺序,把变化少的步骤放前面。

小结

写好 Dockerfile 的三个习惯:依赖先于源码、加 .dockerignore、不用 root。掌握后,再接 Docker Compose 管理多个服务就顺理成章了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。