hyperledger/cello-ansible-agent

Hyperledger Cello 镜像文档

!https://github.com/hyperledger/cello/blob/master/docs/images/favicon.png

![Build Status]([***]

镜像概述和主要用途

Hyperledger Cello是一个供应和操作系统，旨在帮助用户高效管理网络。通过Cello，用户可以快速构建即服务(BaaS)平台，即时部署定制化网络，并在多种基础设施环境中维护运行中的***网络池，同时通过仪表板监控系统状态和调整资源配置。

核心功能和特性

• 生命周期管理：支持网络的创建、启动、停止、删除及自动健康维护
• 定制化部署：支持按需求定制***网络（如规模、共识机制等），目前主要支持Hyperledger Fabric
• 多环境支持：兼容Docker主机、Swarm或Kubernetes作为工作节点，未来将支持更多环境
• 异构架构兼容：支持X86、POWER和Z等架构，从裸机服务器到虚拟机均可部署
• 可扩展性：可通过添加组件扩展监控、日志、健康检查和分析功能

使用场景和适用范围

Cello适用于需要高效管理多个***网络的场景，典型应用包括：

• 企业构建内部***服务平台
• 云服务提供商提供***即服务(BaaS)
• 开发团队快速部署和测试不同配置的***网络
• 研究机构管理实验性***环境

典型使用场景示意图： !Typical Scenario

使用方法和配置说明

环境准备

需预先安装以下组件：

1. Docker：安装指南
2. Docker Compose：安装指南
3. Make：用于执行Cello服务管理脚本
4. Kubernetes（可选）：安装指南

启动Cello服务

1. 构建必要镜像（可选）

当前Docker Hub自动构建尚未就绪，需手动构建镜像：

bash
make docker

2. 启动服务

默认使用docker-compose部署，若有Kubernetes环境，可通过DEPLOY_METHOD=k8s指定部署方式：

使用Docker Compose部署：

bash
make start

服务启动后，可看到类似输出：

bash
CONTAINER ID        IMAGE                          COMMAND                  CREATED             STATUS              PORTS
       NAMES
ddf938ed927e        hyperledger/cello-dashboard    "bash -c '/config-ng…"   2 days ago          Up 2 days           0.0.0.0:8081->80/tcp
       cello-dashboard
41ab47784b28        hyperledger/cello-api-engine   "/bin/sh -c 'bash /e…"   2 days ago          Up 2 days           0.0.0.0:8085->8080/tcp
       cello-api-engine
073a5f46276e        hyperledger/cello-api-engine   "bash -c 'celery -A …"   2 days ago          Up 2 days
       cello-api-engine-tasks
54d2c615d7d9        postgres:11.1                  "docker-entrypoint.s…"   2 days ago          Up 2 days           5432/tcp
       cello-postgres-server
1e0fc6386891        redis:4.0.13                   "docker-entrypoint.s…"   2 days ago          Up 2 days           6379/tcp
       cello-redis

使用Kubernetes部署：

bash
DEPLOY_METHOD=k8s make start

服务启动后，可看到类似输出：

bash
NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
deployment.extensions/api-engine         1/1     1            1           7s
deployment.extensions/api-engine-tasks   1/1     1            1           7s
deployment.extensions/postgres           1/1     1            1           8s
deployment.extensions/redis              1/1     1            1           8s

NAME                                    READY   STATUS    RESTARTS   AGE
pod/api-engine-5844d7d9d4-zqw9k         1/1     Running   0          7s
pod/api-engine-tasks-74484d6f45-jj6p9   1/1     Running   0          7s
pod/postgres-774d5cd5f-p5j5l            1/1     Running   0          8s
pod/redis-6bf574b8c5-p2dnl              1/1     Running   0          7s

NAME                                    HOSTS   ADDRESS   PORTS   AGE
ingress.extensions/ingress-api-engine   *                 80      7s

3. 访问仪表板

通过8081端口访问仪表板，默认用户名/密码为admin/pass。

停止Cello服务

停止服务时需指定与启动时相同的部署方式：

bash
# Docker Compose部署
make stop

# Kubernetes部署
DEPLOY_METHOD=k8s make stop

文档和开发指南

入门资源

新用户建议先阅读教程或文档索引。

在线文档

访问在线文档获取更多信息。

本地文档

运行以下命令启动本地文档网站（监听于localhost:8000）：

bash
make doc

项目命名由来

Can you find anyone better at playing chains? :)（谁能比大提琴手更擅长"演奏"链条呢？）

孵化说明

本项目是Hyperledger的孵化阶段项目。其提案文档见此处，并于2017年1月7日获得Hyperledger TSC批准(会议记录)。关于"孵化阶段"的具体含义，请参见Hyperledger项目生命周期文档。

本作品采用知识共享署名4.0国际许可协议进行许可。