ShareLaTeX base-image 镜像文档

镜像概述

ShareLaTeX base-image是ShareLaTeX在线协作LaTeX编辑平台的官方基础镜像，旨在为ShareLaTeX平台提供标准化的底层运行环境和核心依赖组件。该镜像作为构建ShareLaTeX完整服务栈的基础，封装了运行ShareLaTeX所需的系统环境、基础工具及核心库，简化上层服务的构建与部署流程。

核心功能与特性

基础环境封装

• 预装Linux系统核心依赖（如glibc、libssl等），确保服务稳定运行
• 集成Node.js运行环境，满足ShareLaTeX后端服务的执行需求
• 包含基础网络工具与服务管理组件，支持容器化环境下的服务通信

LaTeX基础支持

• 内置基础LaTeX工具集，提供文档编译、预览等核心功能的底层支持
• 包含TeX Live基础组件，支持常见LaTeX文档类型的处理

服务框架支持

• 封装ShareLaTeX核心服务运行框架，提供标准化的服务启动与管理机制
• 支持与ShareLaTeX其他组件（如数据库、缓存服务）的基础集成能力

使用场景与适用范围

开发场景

• 开发者构建自定义ShareLaTeX服务实例，基于基础镜像扩展功能模块
• 二次开发ShareLaTeX平台，添加自定义插件或集成第三方服务

部署场景

• 作为ShareLaTeX完整服务栈的基础组件，配合其他服务镜像（如数据库、Web服务）部署完整平台
• 私有或企业内部部署ShareLaTeX协作编辑平台时的底层环境构建

测试场景

• 开发团队在本地或CI/CD环境中搭建测试环境，验证ShareLaTeX功能或扩展模块兼容性

使用方法与配置说明

基础使用方式

作为基础镜像构建上层服务

在自定义Dockerfile中引用该镜像作为基础构建层：

FROM sharelatex/base-image:latest

# 添加自定义配置或扩展组件
RUN apt-get update && apt-get install -y <额外依赖>

# 设置服务启动命令
CMD ["node", "/path/to/service/entrypoint.js"]

直接运行基础容器（用于调试或环境验证）

docker run -d --name sharelatex-base \
  --network sharelatex-network \
  sharelatex/base-image:latest

环境变量说明

（注：基础镜像通常需配合ShareLaTeX其他组件使用，以下为常见基础环境变量示例）

依赖与兼容性

• 需配合ShareLaTeX官方指定版本的数据库（如MongoDB）、缓存服务（如Redis）使用
• 建议使用Docker Compose管理多组件协同部署，确保网络与数据卷配置正确

注意事项

• 该镜像为基础组件，不包含完整的ShareLaTeX应用功能，需基于此镜像构建或配合其他服务组件使用
• 生产环境部署时建议通过数据卷挂载持久化配置与数据，避免容器重启导致数据丢失
• 定期更新镜像版本以获取安全补丁与功能优化