Dockerfile实例笔记

# 第一阶段：构建阶段（使用完整环境编译依赖）
FROM python:3.9-slim as builder

# 设置工作目录
WORKDIR /app

# 安装构建依赖（编译某些Python包可能需要gcc等工具）
RUN apt-get update && \
    apt-get install -y --no-install-recommends gcc python3-dev

# 复制 requirements 文件（利用Docker层缓存，避免重复安装依赖）
COPY requirements.txt .

# 安装依赖到虚拟环境（减少最终镜像大小）
RUN python -m venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"
RUN pip install --no-cache-dir -r requirements.txt


# 第二阶段：运行阶段（使用最小化镜像）
FROM python:3.9-slim

# 设置容器元数据
LABEL maintainer="your.email@example.com"
LABEL version="1.0"

# 创建非root用户（安全最佳实践）
RUN useradd -m appuser && chown -R appuser /app
USER appuser
WORKDIR /app

# 从构建阶段复制已安装的依赖
COPY --from=builder --chown=appuser /opt/venv /opt/venv

# 设置环境变量
ENV PATH="/opt/venv/bin:$PATH" \
    PYTHONUNBUFFERED=1 \
    PORT=8000

# 复制应用代码（放在依赖安装后，便于代码修改时利用缓存）
COPY --chown=appuser . .

# 暴露端口
EXPOSE $PORT

# 健康检查
HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl --fail http://localhost:$PORT/health || exit 1

# 容器启动命令
CMD ["gunicorn", "--bind", "0.0.0.0:$PORT", "app:app"]