cloudbees/pluggable-storage-service

CBCI 可插拔存储服务镜像

概述

CBCI 可插拔存储服务镜像是专为CBCI（持续构建与集成）环境设计的存储解决方案，提供高度灵活的可插拔架构，支持动态集成多种存储后端，旨在简化CBCI工作流中的数据存储配置与管理，满足不同场景下的存储需求。

核心功能与特性

1. 可插拔架构设计

采用模块化插件系统，支持动态加载/卸载存储后端模块，无需重启服务即可切换存储策略。

2. 多存储后端支持

兼容主流存储类型，包括：

• 本地文件系统（Local）
• 对象存储（S3、MinIO、Ceph RGW）
• 网络文件系统（NFS、SMB）
• 分布式存储（GlusterFS、Longhorn）

3. 高可用性保障

内置数据冗余机制与故障转移策略，支持主从复制与数据分片，确保存储服务持续可用。

4. 无缝CBCI集成

提供标准化API接口，可直接对接CBCI平台核心组件，支持构建产物、测试数据、配置文件等资源的全生命周期管理。

5. 轻量级部署

优化镜像体积（基础镜像<100MB），支持容器化快速部署，最小化资源占用（推荐配置：1核CPU/2GB内存）。

使用场景与适用范围

1. CBCI环境标准化存储

统一管理CBCI流水线中的各类数据资产，避免因存储后端差异导致的配置碎片化。

2. 多团队存储资源隔离

通过命名空间与权限控制，实现不同项目/团队的存储资源隔离与配额管理。

3. 存储策略动态调整

在项目迭代过程中，可根据数据量增长、访问频率变化等需求，无缝切换存储后端（如从本地存储迁移至S3对象存储）。

4. 跨环境数据同步

支持开发、测试、生产环境间的存储数据同步，确保CI/CD流程中的数据一致性。

使用方法与配置说明

快速启动

使用以下命令启动基础服务（默认使用本地存储后端）：

bash
docker run -d \
  --name cbci-storage \
  -p 8080:8080 \
  -v /host/storage/data:/data \
  cbci/pluggable-storage:latest

环境变量配置

通过环境变量自定义存储行为，关键参数说明：

多后端配置示例

S3对象存储后端

bash
docker run -d \
  --name cbci-s3-storage \
  -p 8080:8080 \
  -e STORAGE_BACKEND=s3 \
  -e S3_ENDPOINT=https://s3.example.com \
  -e S3_REGION=us-west-2 \
  -e S3_ACCESS_KEY=AKIAXXXXXXXXXXXX \
  -e S3_SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  -e S3_BUCKET=cbci-artifacts \
  cbci/pluggable-storage:latest

NFS网络存储后端

bash
docker run -d \
  --name cbci-nfs-storage \
  -p 8080:8080 \
  -e STORAGE_BACKEND=nfs \
  -e NFS_SERVER=192.168.1.100 \
  -e NFS_PATH=/exports/cbci \
  -e NFS_VERSION=4 \
  cbci/pluggable-storage:latest

持久化数据卷配置

为确保数据持久化，推荐使用Docker命名卷或宿主机目录挂载：

bash
# 创建命名卷
docker volume create cbci-storage-data

# 使用命名卷启动
docker run -d \
  --name cbci-storage \
  -p 8080:8080 \
  -v cbci-storage-data:/data \
  -e STORAGE_BACKEND=local \
  cbci/pluggable-storage:latest

健康检查与监控

服务默认暴露健康检查端点/health，可通过以下方式配置Docker健康检查：

bash
docker run -d \
  --name cbci-storage \
  -p 8080:8080 \
  --health-cmd "curl -f http://localhost:8080/health || exit 1" \
  --health-interval 30s \
  --health-timeout 10s \
  --health-retries 3 \
  cbci/pluggable-storage:latest

API接口说明

服务提供RESTful API进行存储管理，核心接口包括：

• GET /api/v1/storage：查询存储后端状态
• POST /api/v1/storage/objects：上传数据对象
• GET /api/v1/storage/objects/{id}：获取数据对象
• DELETE /api/v1/storage/objects/{id}：删除数据对象

完整API文档可通过访问服务/swagger端点查看。