通过docker部署发布python项目的实战步骤

 更新时间:2025年08月17日 08:53:13   作者:慧一居士  
将Python项目通过Docker部署发布,可以实现环境一致性、快速迁移和高效运维,本文将为大家详细介绍一下具体的实现步骤,希望对大家有所帮助

将Python项目通过Docker部署发布,可以实现环境一致性、快速迁移和高效运维。以下是实战部署的完整步骤,结合最佳实践整理而成:

一、项目准备

1.确保本地项目可运行

开发完成并本地测试通过(如 Flask/FastAPI 项目能正常访问)。

项目结构示例:

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

2.生成依赖文件 requirements.txt

# 推荐使用 pipreqs(只导出项目实际依赖)
pip install pipreqs
pipreqs . --encoding=utf8 --force

# 或使用 pip freeze(可能包含多余包)
pip freeze > requirements.txt

二、编写Dockerfile

在项目根目录创建 Dockerfile,内容如下(以 Flask 为例):

# 使用轻量级Python镜像
FROM python:3.11-slim

# 设置工作目录
WORKDIR /app

# 复制依赖文件
COPY requirements.txt .

# 安装依赖(使用国内源加速)
RUN pip install --no-cache-dir -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/

# 复制项目代码
COPY . .

# 暴露应用端口(与代码中保持一致)
EXPOSE 5000

# 启动命令(推荐使用 gunicorn 生产部署)
CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]

说明

  • 使用 slim 镜像减少体积。
  • --no-cache-dir 减少镜像大小。
  • 可替换为 uvicorn(FastAPI)或其他启动器。

三、构建 Docker 镜像

# 构建镜像,指定名称和标签
docker build -t my-python-app:v1.0 .

# 查看镜像是否生成
docker images | grep my-python-app

注意命令末尾的 . 表示上下文路径。

四、运行容器

# 启动容器,后台运行,端口映射
docker run -d -p 5000:5000 --name myapp my-python-app:v1.0

# 若需挂载配置或日志目录
# docker run -d -p 5000:5000 -v ./logs:/app/logs --name myapp my-python-app:v1.0

# 查看运行中的容器
docker ps

五、测试访问

浏览器访问:http://localhost:5000 或服务器IP地址。

查看日志:

docker logs myapp

六、优化建议(进阶)

1.使用 .dockerignore 文件

__pycache__
*.pyc
.git
.env
.idea

避免不必要的文件被打包进镜像。

2.多阶段构建(减小镜像体积)

FROM python:3.11-slim as builder
COPY requirements.txt .
RUN pip install --user -r requirements.txt

FROM python:3.11-slim
COPY --from=builder /root/.local /root/.local
COPY . .
ENV PATH=/root/.local/bin:$PATH
CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]

3.使用 Docker Compose 管理多服务

创建 docker-compose.yml

version: '3'
services:
  web:
    build: .
    ports:
      - "5000:5000"
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: example

启动:

docker compose up --build

七、常用命令速查

功能命令
查看镜像docker images
查看容器docker ps / docker ps -a
删除镜像docker rmi 镜像ID
删除容器docker rm 容器ID
查看日志docker logs 容器名
进入容器docker exec -it 容器名 /bin/bash

总结

步骤关键点
1. 准备项目本地可运行 + 生成 requirements.txt
2. 编写 Dockerfile基础镜像 + 依赖安装 + 启动命令
3. 构建镜像docker build -t name:tag .
4. 运行容器docker run -d -p host:container --name
5. 测试验证访问服务 + 查看日志

通过以上步骤,即可完成一个标准 Python 项目的 Docker 容器化部署,适用于开发、测试、生产等各类环境。

到此这篇关于通过docker部署发布python项目的实战步骤的文章就介绍到这了,更多相关docker部署发布python项目内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • docker如何更改镜像

    docker如何更改镜像

    这篇文章主要介绍了docker如何更改镜像问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-08-08
  • Docker如何同时启动多个服务

    Docker如何同时启动多个服务

    这篇文章主要为大家详细介绍了Docker如何同时启动多个服务,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-10-10
  • Docker启动为Exited状态

    Docker启动为Exited状态

    这篇文章主要介绍了Docker启动为Exited状态的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-03-03
  • docker-swarm之使用Docker secret管理敏感数据

    docker-swarm之使用Docker secret管理敏感数据

    就Docker Swarm集群服务而言,secret 是块状数据,例如密码、SSH私钥、SSL证书或其他不应通过网络传输或未加密存储在Dockerfile或应用程序源代码中的数据,我们可以使用Docker secret 集中管理这些数据,所以接下来就带大家了解一下如何使用Docker secret 管理敏感数据
    2023-08-08
  • Docker根目录迁移与滚动日志设置方法

    Docker根目录迁移与滚动日志设置方法

    在使用docker的过程中,需要注意docker的根目录磁盘位置,默认情况下docker的日志是没有限制的,所有,除了要修改根目录位置到比较大的地方,还需要设置docker滚动日志方式,这篇文章主要介绍了Docker根目录迁移与滚动日志设置方法,需要的朋友可以参考下
    2025-03-03
  • docker registry私服搭建的方法

    docker registry私服搭建的方法

    这篇文章主要介绍了docker registry私服搭建的方法,docker官方的registry镜像分为两个版本,v2和v2以前的版本,本文将分别搭建基于SSL和登录认证的以上两个版本的docker私服
    2018-05-05
  • 使用docker命令不需要敲sudo的操作

    使用docker命令不需要敲sudo的操作

    这篇文章主要介绍了使用docker命令不需要敲sudo的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • docker安装ros2详细步骤介绍

    docker安装ros2详细步骤介绍

    大家好,本篇文章主要讲的是docker安装ros2详细步骤介绍,感兴趣的同学赶快来看一看吧,对你有帮助的话记得收藏一下,方便下次浏览
    2021-12-12
  • 利用docker搭建LAMP运行环境教程详解

    利用docker搭建LAMP运行环境教程详解

    LAMP相信对大家来说都不陌生, Docker是一个开源的引擎,可以轻松的为任何应用创建一个轻量级的、可移植的、自给自足的容器,所以这篇文章给大家介绍利用docker快速搭建LAMP运行环境的方法,有需要的朋友们可以参考借鉴,下面来一起看看吧。
    2016-10-10
  • 深入解析docker三种网络模式

    深入解析docker三种网络模式

    这篇文章主要介绍了docker三种网络模式,分别是bridge桥接模式,host主机模式,none无网络模式,每种模式给大家介绍的非常详细,需要的朋友可以参考下
    2022-04-04

最新评论