xiaoxia-saas/infra/docker/worker.Dockerfile

# ============================================================
# Worker Dockerfile - 极简化
# 从预构建统一基础镜像开始，仅叠加业务代码
# 基础镜像包含：系统依赖 + 全部 Python 依赖 + CJK 字体
# 构建时间目标：< 5 分钟
# ============================================================

FROM xiaoxia-registry.cn-hangzhou.cr.aliyuncs.com/xiaoxiakeji/saas-worker-base:latest

# 构建参数：版本号（CI 传入 commit hash）
ARG APP_VERSION=dev

# CJK 字体保障：确保 fonts-noto-cjk 已安装（base 镜像漂移兜底）+ 重建字体缓存
# fc-cache 非致命；fc-match 结果只打日志用于排查，不阻断构建
RUN apt-get update && (apt-get install -y --no-install-recommends fonts-noto-cjk fontconfig || true) \
    && rm -rf /var/lib/apt/lists/* \
    && (fc-cache -fv || true) \
    && echo "[font] fc-match sans:zh: $(fc-match -f '%{family}\n' sans:zh 2>/dev/null | head -1)" \
    && echo "[font] fc-match Noto Sans CJK SC: $(fc-match 'Noto Sans CJK SC' 2>/dev/null | head -1)"

# 创建非 root 用户
RUN groupadd -r celery \
    && useradd -r -g celery -d /app -s /sbin/nologin celery \
    && mkdir -p /app/generated \
    && chown celery:celery /app/generated

WORKDIR /app

# 设置 Python 环境变量
ENV PATH="/opt/venv/bin:$PATH"
ENV PYTHONPATH=/app:/app/apps/api:/app/packages
ENV PYTHONUNBUFFERED=1
ENV APP_VERSION=$APP_VERSION

# 复制文件（按变化频率从低到高排序，最大化层缓存命中）
COPY alembic.ini /app/alembic.ini
COPY migrations/ /app/migrations/
COPY packages/ /app/packages/
# PR #1844 起，worker 还需要加载 apps.api.app.tasks.lipsync_tts，
# 该 task 依赖 app.services.* 与 app.core.celery_app（PYTHONPATH=/app/apps/api 下解析）。
# 为避免后续新增 task 再次漏 COPY，直接把整个 apps/api/app/ 复制进 worker 镜像。
COPY apps/api/app/ /app/apps/api/app/

# Worker 启动脚本
COPY infra/docker/entrypoint-worker.sh /usr/local/bin/entrypoint-worker.sh
RUN chmod +x /usr/local/bin/entrypoint-worker.sh

# 业务代码（变化最频繁，放最后）
COPY apps/worker/ /app/apps/worker/

# 健康检查：扫描所有进程的 cmdline 查找 celery 进程
HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
    CMD grep -lq celery /proc/[0-9]*/cmdline 2>/dev/null || exit 1

USER celery
WORKDIR /app/apps/worker
CMD ["/usr/local/bin/entrypoint-worker.sh"]