kuberlab/cloud-dealer

Cloud Dealer 镜像文档

镜像概述

Cloud Dealer是Kibernetika项目的后端组件，主要提供API服务，支持数据存储、会话管理及外部服务集成。该镜像适用于本地开发、测试环境部署及Kubernetes集群集成场景，具备轻量配置与灵活扩展能力。

核心功能与特性

• 数据存储：支持SQLite作为默认数据存储
• 会话管理：提供Redis或内存两种会话存储方式
• API文档：集成Swagger，提供交互式API文档
• 版本控制：当前API版本为/api/v0.2
• 外部集成：兼容Elasticsearch 2.X版本
• Kubernetes支持：提供凭证管理与Docker镜像仓库配置能力
• 开发友好：支持Go 1.16模块化开发（go mod）

使用场景

• 本地开发与调试Kibernetika项目后端服务
• 构建测试环境的API服务实例
• 在Kubernetes集群中部署后端组件并管理服务凭证
• 集成Elasticsearch 2.X进行数据检索与分析

使用方法

本地开发环境搭建

1. 获取依赖

bash
go mod vendor

2. 启动服务

使用SQLite存储数据，Redis/内存管理会话：

bash
BASE_URL=http://localhost:8082 go run cloud-dealer.go

环境变量BASE_URL指定服务基础URL，默认为http://localhost:8082

API文档访问

服务启动后，通过以下地址访问Swagger API文档：

• 交互式文档：http://localhost:8082/docs/apidocs/
• API规范文件：http://localhost:8082/docs/apidocs.json

单元测试

执行单元测试命令：

bash
TESTING=1 go test ./pkg/...

Kubernetes环境配置

1. 存储应用凭证

将应用凭证文件（如bitbucket.json、github.json等）保存为Kubernetes Secret：

bash
kubectl --namespace kuberlab create secret generic app-credentials \
  --from-file=./bitbucket.json \
  --from-file=./github.json \
  --from-file=./google.json \
  --from-file=./smtp.json \
  --from-file=./admins.json

2. 创建Docker镜像仓库凭证

配置Docker镜像仓库访问凭证：

bash
kubectl create secret docker-registry kuberlab-docker \
  --docker-server=https://index.docker.io/v1/ \
  --docker-username=kuberlabdeploy \
  --docker-password=xxxx \
  --docker-email=agunin@kuberlab.com

Elasticsearch集成

当前版本仅支持Elasticsearch 2.X，本地启动命令：

bash
docker run -p 9200:9200 \
  -e "http.host=0.0.0.0" \
  -e "transport.host=127.0.0.1" \
  docker.xuanyuan.run/elasticsearch:2.4

Go 1.16模块化支持

初始化模块

bash
go mod init
go mod vendor

测试运行

bash
go run cloud-dealer.go