如何编写一个用于构建python web项目镜像的dockerfile文件
一个用于构建python web
docker 镜像的文件需要包含以下文件:Dockerfile
、main.py
、docker-compose.yml
和 requirements.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应用程序的端口。
-
拓展:
dockerfileRUN 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"