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

如何编写一个用于构建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=dev
		command: >
		  sh -c "uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload"