minorplanetcenter/streamlit

缓存镜像文档：Streamlit依赖缓存镜像

镜像概述与主要用途

本镜像为预构建的缓存镜像，包含Streamlit及其所有依赖组件。其核心目的是在cheby-web-api项目的Docker构建流程中，避免重复下载、安装和编译Streamlit及其依赖，从而显著缩短构建时间，提升开发和部署效率。

主要用途：作为cheby-web-api项目Docker构建过程中的依赖缓存层，加速项目镜像的构建流程。

核心功能和特性

核心功能

• 预缓存Streamlit及其完整依赖树，包含所有运行时和构建时依赖
• 提供稳定的依赖版本快照，确保构建环境一致性

特性

• 依赖预编译：所有依赖均已预先下载并配置，无需在构建阶段重复执行
• 构建加速：减少cheby-web-api构建过程中的网络请求和依赖安装步骤，缩短整体构建时间
• 环境一致：通过固定依赖版本，确保不同构建环境下的依赖一致性，降低"在我机器上能运行"问题

使用场景和适用范围

使用场景

• cheby-web-api项目的本地开发环境Docker构建
• CI/CD流水线中的cheby-web-api自动化构建流程
• 需要频繁重建cheby-web-api镜像的开发和测试场景

适用范围

• cheby-web-api开发团队
• 涉及cheby-web-api部署的DevOps流程
• 依赖Streamlit的cheby-web-api相关组件构建

使用方法和配置说明

基础使用方式

在cheby-web-api项目的Dockerfile中，可将本缓存镜像作为基础镜像或依赖阶段引用，示例如下：

Dockerfile多阶段构建示例

dockerfile
# 阶段1：使用缓存镜像获取Streamlit依赖
FROM [缓存镜像名称]:[版本标签] AS streamlit-cache

# 阶段2：构建cheby-web-api应用
FROM python:3.9-slim

# 从缓存阶段复制预安装的依赖
COPY --from=streamlit-cache /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
COPY --from=streamlit-cache /usr/local/bin/streamlit /usr/local/bin/streamlit

# 复制项目代码并执行后续构建步骤
COPY . /app
WORKDIR /app

# 执行应用构建命令（此时无需重复安装Streamlit依赖）
RUN pip install . --no-deps  # --no-deps避免重复安装已缓存依赖

CMD ["streamlit", "run", "app.py"]

版本标签说明

本镜像采用版本化管理，标签格式通常为v<streamlit版本>-<构建日期>，例如v1.24.0-20231001，使用时需指定与cheby-web-api兼容的Streamlit版本标签。

注意事项

• 确保使用与cheby-web-api项目兼容的Streamlit版本对应的缓存镜像标签
• 如依赖版本有更新，需同步更新缓存镜像版本以匹配项目需求
• 在CI/CD环境中，建议固定镜像标签而非使用latest，以确保构建稳定性