当前位置：首页 > news >正文

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

news 2025/9/6 8:07:03

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

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

编写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应用程序的端口。
拓展：
```
RUN apt-get update && apt-get install -y --no-install-recommends \build-essential \&& rm -rf /var/lib/apt/lists/*
```
RUN 是 Dockerfile 的关键字，它告诉 Docker：“在镜像构建阶段，启动一个临时容器，执行后面的 shell 命令；然后把执行后的文件系统改动固化成一层新的镜像层”。

多阶段构建:

# ----------- 构建阶段 -----------
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 文件

version: "3.8"
services:api:build: .ports:- "8000:8000"volumes:- ./app:/app/app  # 代码热挂载environment:- ENV=devcommand: >sh -c "uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload"