JetBrains Upsource FileClustering Docker镜像文档

镜像概述和主要用途

JetBrains Upsource FileClustering 是 JetBrains Upsource 的官方 Docker 镜像，作为 分布式 Upsource 安装 的组成部分。该镜像适用于评估环境及生产环境，提供文件和修订版本相似度索引计算能力。

核心功能和特性

核心功能

• 计算文件相似度索引
• 计算修订版本相似度索引

主要特性

• 官方维护：JetBrains 官方提供的 Upsource 分布式集群组件
• 环境兼容性：基于 Debian 稳定版和 JRE 构建，确保运行环境一致性
• 集群集成：与其他 Upsource 集群服务无缝协同

使用场景和适用范围

使用场景

• 分布式 Upsource 集群部署中，需分析代码库文件及修订版本相似度的场景
• 支持代码审查、版本管理优化等基于文件相似度分析的功能

适用范围

• Upsource 分布式集群环境（评估或生产环境）
• 需要计算文件/修订相似度索引的团队协作场景

使用方法和配置说明

Upsource FileClustering 服务需与其他 Upsource 集群服务协同运行，推荐通过 docker-compose 进行部署。

部署要求

• 已配置 Docker 和 Docker Compose
• 已部署 Upsource 分布式集群的其他必要组件（如 Frontend、Analyzer 等）

部署步骤

1. 参考 Upsource 分布式安装文档 准备集群环境
2. 在 docker-compose.yml 中添加 FileClustering 服务配置，示例如下：

version: '3'
services:
  upsource-file-clustering:
    image: jetbrains/upsource-file-clustering
    depends_on:
      - upsource-opscenter  # 依赖 Opscenter 服务进行集群协调
      - upsource-frontend    # 依赖 Frontend 服务接收请求
    # 其他配置（如网络、存储卷等）需根据集群环境调整，详情参见官方文档

3. 执行 docker-compose up -d 启动服务

镜像状态

当前镜像处于实验性阶段，欢迎通过 反馈渠道 提供使用体验建议。

许可信息

该镜像基于 Upsource 许可协议分发。Upsource 可永久免费用于最多 10 名用户的团队。
许可详情

反馈与支持

• 问题报告：通过 Upsource 问题跟踪器 提交 bug 或功能建议
• 技术支持：访问 Upsource 支持中心

技术细节

基础镜像与依赖

• 底层系统：debian:stretch-slim
• 运行时环境：JRE 8u191

相关 Upsource 集群服务

Upsource 分布式集群包含以下组件，需协同部署以实现完整功能：

• Upsource Analyzer
• Upsource Frontend
• Upsource Opscenter
• Upsource PSI Broker
• Upsource PSI Agent
• Upsource Cluster Init
• Upsource Proxy
• Upsource File Clustering