(未完待续...)如何编写一个用于构建python web项目镜像的dockerfile文件

如何编写一个用于构建python web项目镜像的dockerfile文件

一个用于构建python webdocker 镜像的文件需要包含以下文件:Dockerfilemain.pydocker-compose.ymlrequirements.txt。其中,main.py为python代码文件(命名不一定为main.py),docker-compose.yml 为非必须的文件,但是有了会更好,它整合了构建镜像的命令和创建容器的参数。

编写dockerfile,单阶段构建:

dockerfile 复制代码
# Step 1: 选择基础镜像
FROM python:3.11-slim

# Step 2: 设置容器内的工作目录
WORKDIR /app

# Step3: 将 requirements 文件复制到容器中
COPY requiredments.txt .

# Step4: 安装依赖项
RUN pip install --no-cache-dir -r requiredments.txt

# Step5: 将应用程序代码复制到容器中
COPY ./app ./app

# Step6: 声明应用程序运行的端口,这里仅仅是声明而不是实际暴露端口
EXPOSE 8000

# Step7: 定义运行应用程序的命令
CMD ["uvicorn", "app.main:app","--host","0.0.0.0","--port","8000"]
  • python:3.11-slim 是一个轻量级python:3.11镜像。python:3.11-slim以Debian 官方 slim 变体(当前是 Debian Bookworm slim)作为基础镜像,再在上面安装 Python 3.11 及其最小依赖。

  • 8000是Uvicorn默认用于运行FastAPI应用程序的端口。

  • 拓展:

    dockerfile 复制代码
    RUN apt-get update && apt-get install -y --no-install-recommends \
        build-essential \
     && rm -rf /var/lib/apt/lists/*

    RUN 是 Dockerfile 的关键字,它告诉 Docker:"在镜像构建阶段,启动一个临时容器,执行后面的 shell 命令;然后把执行后的文件系统改动固化成一层新的镜像层"。

多阶段构建:

python 复制代码
# ----------- 构建阶段 -----------
FROM python:3.11-slim AS builder

# 1. 安装编译依赖(后续可全部丢弃)
RUN apt-get update && apt-get install -y --no-install-recommends \
        build-essential \
    && rm -rf /var/lib/apt/lists/*

# 2. 创建并激活虚拟环境
ENV VIRTUAL_ENV=/opt/venv
RUN python -m venv $VIRTUAL_ENV
ENV PATH="$VIRTUAL_ENV/bin:$PATH"

# 3. 安装 Python 依赖
WORKDIR /build
COPY requirements.txt .
RUN pip install --upgrade pip && \
    pip install --no-cache-dir -r requirements.txt

# ----------- 运行阶段 -----------
FROM python:3.11-slim

# 1. 复制虚拟环境(无编译器,体积更小)
COPY --from=builder /opt/venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"

# 2. 创建非 root 用户
RUN useradd -m -u 1001 appuser

# 3. 复制源码
WORKDIR /app
COPY ./app ./app

# 4. 权限 & 端口
RUN chown -R appuser:appuser /app
USER appuser
EXPOSE 8000

# 5. 启动命令
# 默认监听 0.0.0.0:8000,workers 可根据 CPU 核数调整
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--workers", "1"]

如何编写 docker-compose.yml 文件

bash 复制代码
version: "3.8"
services:
	api:
		build: .
		ports:
		  - "8000:8000"
		volumes:
		  - ./app:/app/app  # 代码热挂载
		environment:
		  - ENV=dev
		command: >
		  sh -c "uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload"
相关推荐
独行soc1 天前
2025年渗透测试面试题总结-90(题目+回答)
网络·python·安全·web安全·adb·渗透测试·安全狮
SYC_MORE1 天前
多线程环境下处理Flask上下文问题的文档
后端·python·flask
Craaaayon1 天前
【数据结构】二叉树-图解深度优先搜索(递归法、迭代法)
java·数据结构·后端·算法·leetcode·深度优先
hhzz1 天前
GDAL 的内置矢量工具集ogr的详解使用
python·gis·gdal
梦之翼6187201 天前
eclipse复制项目后原项目名依然伴随值所复制的项目名
java·eclipse
轩辰q1 天前
python异步编程
开发语言·python
缘的猿1 天前
Kubernetes 安全管理:认证、授权与准入控制全面解析
java·安全·kubernetes
ChinaRainbowSea1 天前
5. Prompt 提示词
java·人工智能·后端·spring·prompt·ai编程
IT_陈寒1 天前
Vue3性能优化实战:这5个技巧让我的应用加载速度提升70%
前端·人工智能·后端