cloudbaristaorg/cb-tumblebug

CB-Tumblebug（多云基础设施服务管理）

镜像概述和主要用途

CB-Tumblebug是Cloud-Barista平台的子系统，专注于多云基础设施的部署与管理。作为开源项目，它提供统一接口实现跨云平台（如AWS、GCP、Azure、阿里云等）的资源管理，支持基础设施即服务（IaaS）层的资源编排、生命周期管理及自动化运维。

注意：CB-Tumblebug目前处于开发阶段（最新版本v0.3.0），不建议在生产环境中使用。功能稳定性和安全性仍在优化中，使用过程中遇到问题可通过项目issue或Cloud-Barista Slack反馈。

核心功能和特性

1. 多云资源统一管理
   支持AWS、GCP、Azure、阿里云等主流云平台，通过统一API实现云资源（网络、安全组、SSH密钥、镜像、规格等）的创建、查询、更新和删除。

2. 多云计算服务（MCIS）编排
   提供MCIS（Multi-Cloud Infrastructure Service）管理，支持跨云虚拟机集群的创建、部署、状态监控、远程命令执行及生命周期控制（启动、暂停、重启、删除等）。

3. REST API与Swagger文档
   提供完整的REST API接口，配套Swagger API文档（访问http://localhost:1323/tumblebug/swagger/index.html查看），便于集成和二次开发。

4. 灵活的存储配置
   支持NUTSDB（本地文件存储）或ETCD（分布式存储）作为元数据存储后端，可通过配置文件自定义存储路径和类型。

5. 自动化测试脚本
   提供丰富的测试脚本，支持从云连接配置、命名空间创建到MCIS部署的全流程自动化测试，简化功能验证和集成测试。

使用场景和适用范围

• 多云环境管理：需要统一管理多个云平台资源的企业或开发者。
• 基础设施自动化：通过API或脚本实现跨云资源的自动化部署和运维。
• 云原生应用测试：在多云环境中快速构建和销毁测试环境。
• Cloud-Barista生态集成：作为Cloud-Barista平台的核心组件，与CB-Spider（云资源适配层）等子系统协同工作，构建完整的多云管理解决方案。

运行环境要求

• 操作系统：Linux（推荐Ubuntu 18.04）
• 依赖：Go 1.14+（源码运行时）、Docker（容器运行时）

使用方法和配置说明

1. 容器化部署

前提条件

• 已安装Docker引擎。

拉取镜像

从Docker Hub获取最新镜像：

shell
docker pull docker.xuanyuan.run/cloudbaristaorg/cb-tumblebug:v0.3.x-yyyymmdd

镜像标签格式为v0.3.x-yyyymmdd，需替换为实际版本日期（如v0.3.0-20231001）。

启动容器

shell
docker run -d -p 1323:1323 \
  -v /path/to/meta_db:/app/meta_db \
  --name cb-tumblebug \
  docker.xuanyuan.run/cloudbaristaorg/cb-tumblebug:v0.3.x-yyyymmdd

• -p 1323:1323：映射容器内API服务端口（默认1323）到主机。
• -v /path/to/meta_db:/app/meta_db：挂载本地目录作为元数据存储（NUTSDB模式下需持久化）。

2. 源码编译与运行

环境准备

1. 安装Git和Go 1.14+：

   shell
   # Ubuntu示例
   apt update && apt install -y git
   wget https://golang.org/dl/go1.14.15.linux-amd64.tar.gz
   tar -C /usr/local -xzf go1.14.15.linux-amd64.tar.gz
   echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bashrc
   echo 'export GOPATH=$HOME/go' >> ~/.bashrc
   source ~/.bashrc
   

2. 获取源码：

   shell
   go get -v github.com/cloud-barista/cb-tumblebug
   

配置文件设置

1. 进入项目配置目录：

   shell
   cd $GOPATH/src/github.com/cloud-barista/cb-tumblebug/conf
   

2. 配置setup.env：设置系统环境变量（如日志级别、API端口等），执行source setup.env生效。

3. 配置store_conf.yaml：指定存储类型（NUTSDB或ETCD），NUTSDB模式需设置数据存储路径（默认../meta_db/dat）。

4. 配置log_conf.yaml：调整日志输出格式、级别和存储路径。

编译与启动

shell
cd $GOPATH/src/github.com/cloud-barista/cb-tumblebug/src
export GO111MODULE=on
./make  # 编译
./make run  # 启动服务（或直接执行`go run *.go`）

常见问题：若启动时出现/debug/requests is already registered错误，执行以下命令修复依赖冲突：

shell
rm -rf $GOPATH/src/go.etcd.io/etcd/vendor/golang.org/x/net/trace
./make

3. Cloud-Barista系统集成（通过cb-operator）

通过cb-operator可一键部署Cloud-Barista全栈框架（含CB-Tumblebug、CB-Spider等）：

shell
git clone https://github.com/cloud-barista/cb-operator.git
cd cb-operator/src
make
./operator  # 启动集成服务

测试与验证

API访问

服务启动后，通过http://localhost:1323访问API，Swagger文档可通过http://localhost:1323/tumblebug/swagger/index.html查看。

自动化测试脚本

项目提供测试脚本集，位于test/official/目录，支持从云连接配置到MCIS部署的全流程测试：

1. 配置测试环境：

   • 编辑test/official/credentials.conf，填入云平台认证信息（AWS、GCP等）。
   • 调整test/official/conf.env，设置CB-Tumblebug和CB-Spider服务地址、测试区域等。

2. 执行全流程测试：

   shell
   cd test/official/sequentialFullTest
   ./testAll-mcis-mcir-ns-cloud.sh aws 1 shson  # AWS 1号区域，开发者标识shson
   

   测试完成后，可通过./cleanAll-mcis-mcir-ns-cloud.sh aws 1 shson清理资源。

参考链接

• https://github.com/cloud-barista/cb-tumblebug
• https://cloud-barista.github.io/cb-tumblebug-api-web/?url=https://raw.githubusercontent.com/cloud-barista/cb-tumblebug/master/src/docs/swagger.yaml
• https://github.com/cloud-barista