用 Dockerfile 构建 Python 应用镜像:从入门到瘦身
【摘要】 很多人学会 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 前加:
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)