cbflow-repository 镜像文档

镜像概述

cbflow-repository 是专为 cbflow 生态系统设计的轻量级仓库服务镜像，提供高效、可靠的存储与管理能力，用于存储 cbflow 相关的数据流、配置文件、模型或业务数据。该镜像简化了仓库服务的部署流程，支持快速集成到开发、测试和生产环境，满足 cbflow 应用的数据存取与分发需求。

核心功能与特性

• 轻量级设计：基于精简基础镜像构建，资源占用低，启动速度快，适配边缘设备及资源受限环境。
• 全面数据管理：支持结构化数据、配置文件、二进制流等多种数据类型的存储与检索，提供统一数据访问接口。
• 版本控制机制：内置数据版本管理功能，可追踪变更历史，支持版本回溯与差异对比，保障数据一致性。
• 生态兼容性：与 cbflow-worker、cbflow-orchestrator 等组件无缝集成，支持标准数据交换协议。
• 安全访问控制：可选启用基础认证（用户名/密码）或 API 密钥认证，限制未授权访问。

使用场景与适用范围

• 开发环境数据存储：作为本地 cbflow 应用的开发调试数据仓库，支持临时数据持久化与版本管理。
• 生产环境配置分发：部署于服务器或容器集群，为生产环境 cbflow 应用提供稳定的配置文件与模型分发服务。
• 分布式系统数据节点：在分布式 cbflow 架构中作为区域数据仓库，实现就近数据存取，降低网络延迟。
• 模型/配置版本管理：集中管理 cbflow 应用的模型文件与配置，支持多版本并行部署与回滚。

使用方法与配置说明

获取镜像

从指定仓库拉取镜像（默认使用 latest 标签）：

docker pull [镜像仓库地址]/cbflow-repository:latest

注：请将 [镜像仓库地址] 替换为实际镜像源（如 Docker Hub 或私有仓库地址）。

基本运行命令

启动容器并挂载数据卷以持久化存储：

docker run -d \
  -p 8080:8080 \
  -v /host/data/path:/app/data \
  --name cbflow-repo \
  cbflow-repository:latest

• -p 8080:8080：映射容器服务端口（主机端口:容器端口）
• -v /host/data/path:/app/data：挂载主机目录至容器数据目录，实现数据持久化
• --name cbflow-repo：指定容器名称

docker-compose 配置示例

创建 docker-compose.yml 集成至多容器环境：

version: '3'
services:
  cbflow-repo:
    image: cbflow-repository:latest
    container_name: cbflow-repo
    ports:
      - "8080:8080"
    volumes:
      - ./cbflow-data:/app/data  # 相对路径挂载数据卷
    environment:
      - PORT=8080
      - AUTH_ENABLED=true
      - AUTH_USERNAME=admin
      - AUTH_PASSWORD=SecurePass123!
    restart: unless-stopped  # 异常退出后自动重启

环境变量配置

支持通过环境变量自定义服务参数，常用配置如下：

启用认证示例：

docker run -d \
  -p 8080:8080 \
  -v /host/data:/app/data \
  -e AUTH_ENABLED=true \
  -e AUTH_USERNAME=cbflowuser \
  -e AUTH_PASSWORD=UserPass@2024 \
  cbflow-repository:latest

数据持久化

为避免容器重启导致数据丢失，需通过挂载实现数据持久化：

• 主机目录挂载：-v /host/path:/app/data（适用于单机部署）
• Docker 数据卷：

  docker volume create cbflow-repo-data  # 创建数据卷
  docker run -d -v cbflow-repo-data:/app/data cbflow-repository:latest  # 挂载数据卷
  

常见问题

• Q：如何查看服务运行状态？
  A：通过 docker logs cbflow-repo 查看日志，或访问 http://<主机IP>:8080/health 检查健康状态接口。
• Q：如何升级镜像版本？
  A：停止旧容器（docker stop cbflow-repo）→ 删除旧容器（docker rm cbflow-repo）→ 拉取新版本镜像后重启，确保数据卷挂载路径不变。
• Q：支持哪些数据访问方式？
  A：默认通过 HTTP/HTTPS 协议提供 RESTful API 接口，具体接口文档可访问服务 /docs 路径查看。