molgenis/ssr-catalogue-snapshot

SSR目录构建快照仓库镜像

镜像概述

本镜像为SSR（Server-Side Rendering，服务端渲染）目录构建提供专用快照仓库，主要用于存储和管理SSR目录构建过程中生成的快照版本，支持构建版本的存储、查询与回溯，助力开发团队实现构建版本的有效管控。

核心功能与特性

• 快照存储：提供结构化存储能力，保存SSR目录构建过程中的完整快照版本，包含构建产物及相关元数据。
• 版本管理：自动记录快照版本信息（如构建时间、构建编号、关联代码提交等），支持按版本号、时间等维度查询快照。
• 构建集成：支持与CI/CD流水线集成，可通过配置自动将构建产物提交至快照仓库，简化构建流程。
• 轻量高效：基于精简基础镜像构建，资源占用低，快照读写操作响应迅速。

使用场景与适用范围

• 开发环境版本控制：开发团队在SSR项目迭代中，通过快照仓库保存不同阶段的构建版本，便于对比不同版本差异或回滚至稳定版本。
• CI/CD流程集成：在持续集成/持续部署流程中，作为构建环节与部署环节的中间存储，确保部署时可准确获取指定快照版本的构建产物。
• 多环境部署支持：为开发、测试、预发布等多环境提供统一的快照版本源，确保各环境使用的构建版本可追溯、一致。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name ssr-snapshot-repo \
  -p 8080:8080 \
  -v /path/to/local/snapshots:/app/snapshots \
  -e SNAPSHOT_STORAGE_PATH=/app/snapshots \
  -e SERVER_PORT=8080 \
  docker.xuanyuan.run/ssr-catalogue-snapshot-repo:latest

环境变量说明

数据持久化

通过 -v 参数挂载本地目录至容器内 SNAPSHOT_STORAGE_PATH（默认/app/snapshots），确保快照数据在容器重启后不丢失。

集成CI/CD示例（Jenkins Pipeline）

在Jenkins Pipeline中配置自动提交快照至仓库：

groovy
stage('Build & Push Snapshot') {
  steps {
    // 执行SSR目录构建
    sh 'npm run build-ssr-catalogue'
    
    // 提交快照至仓库（假设仓库服务地址为http://ssr-snapshot-repo:8080）
    sh 'curl -X POST http://ssr-snapshot-repo:8080/api/snapshots \
         -H "Content-Type: application/json" \
         -d \'{"version": "${BUILD_NUMBER}", "path": "./dist", "commit": "${GIT_COMMIT}"}\''
  }
}

注意事项

• 生产环境建议启用 AUTH_ENABLED=true 并配置访问凭证，限制仓库访问权限。
• 若需限制快照存储占用空间，可设置 MAX_SNAPSHOT_COUNT 自动清理旧版本快照。
• 确保挂载的本地存储目录有足够磁盘空间，避免因空间不足导致快照提交失败。