# 参考文档: https://huggingface.co/docs/hub/spaces-sdks-docker
# 更多关于编写最佳实践的Dockerfile指南见上述链接

# ============================================================
# 基础镜像配置
# ============================================================
# 使用Python 3.9作为基础镜像，包含Python运行时环境
FROM python:3.9

# ============================================================
# 用户和权限配置
# ============================================================
# 创建一个名为'user'的非root用户，UID为1000
# -m: 创建用户的主目录 (/home/user)
# -u: 指定用户ID
RUN useradd -m -u 1000 user

# 将当前活动用户切换为'user'用户（而不是root）
# 这样可以提高容器的安全性，防止以root权限运行应用
USER user

# ============================================================
# 环境变量配置
# ============================================================
# 更新PATH环境变量，将用户本地pip安装目录加入到搜索路径中
# 这样可以直接运行用pip install --user安装的命令行工具
ENV PATH="/home/user/.local/bin:$PATH"

# ============================================================
# 工作目录设置
# ============================================================
# 为容器设置工作目录为 /app
# 后续的RUN、COPY、CMD等指令都在此目录下执行
WORKDIR /app

# ============================================================
# 依赖项安装
# ============================================================
# 将宿主机的 requirements.txt 文件复制到容器内的 requirements.txt
# --chown=user: 确保文件由'user'用户拥有（而不是root）
COPY --chown=user ./requirements.txt requirements.txt

# 使用pip安装requirements.txt中列出的所有依赖包
# --no-cache-dir: 不缓存pip下载，减小镜像大小
# --upgrade: 升级所有依赖包到最新版本
RUN pip install --no-cache-dir --upgrade -r requirements.txt

# ============================================================
# 应用代码复制
# ============================================================
# 将宿主机的所有文件（除了.dockerignore中排除的文件）复制到容器的/app目录
# --chown=user: 确保所有文件由'user'用户拥有
COPY --chown=user . /app

# ============================================================
# 容器启动命令
# ============================================================
# 当容器启动时自动运行此命令
# uvicorn: Python的ASGI应用服务器
# app:app: 指定为 app.py 文件中名为 app 的应用对象
# --host 0.0.0.0: 监听所有网络接口（允许外部访问）
# --port 7860: 监听端口7860
CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]