hyperledger/cello-ansible-agent

Hyperledger Cello 镜像文档

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

https://dev.azure.com/Hyperledger/Cello/_apis/build/status/hyperledger.cello?branchName=master](https://dev.azure.com/Hyperledger/Cello/_build/latest?definitionId=27&branchName=master)

镜像概述和主要用途

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

核心功能和特性

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

使用场景和适用范围

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

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

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

使用方法和配置说明

环境准备

需预先安装以下组件：

1. Docker：https://get.docker.com
2. Docker Compose：https://docs.docker.com/compose/install/
3. Make：用于执行Cello服务管理脚本
4. Kubernetes（可选）：https://kubernetes.io/docs/setup/

启动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

文档和开发指南

入门资源

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

在线文档

访问http://cello.readthedocs.io/en/latest/%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82

本地文档

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

bash
make doc

项目命名由来

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

孵化说明

本项目是Hyperledger的孵化阶段项目。其提案文档见https://docs.google.com/document/d/1E2i5GRqWsIag7KTxjQ_jQdDiWcuikv3KqXeuw7NaceM/edit%EF%BC%8C%E5%B9%B6%E4%BA%8E2017%E5%B9%B41%E6%9C%887%E6%97%A5%E8%8E%B7%E5%BE%97Hyperledger TSC批准(https://lists.hyperledger.org/pipermail/hyperledger-tsc/2017-January/000535.html)%E3%80%82%E5%85%B3%E4%BA%8E%22%E5%AD%B5%E5%8C%96%E9%98%B6%E6%AE%B5%22%E7%9A%84%E5%85%B7%E4%BD%93%E5%90%AB%E4%B9%89%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81Hyperledger%E9%A1%B9%E7%9B%AE%E7%94%9F%E5%91%BD%E5%91%A8%E6%9C%9F%E6%96%87%E6%A1%A3%E3%80%82

http://creativecommons.org/licenses/by/4.0/
本作品采用http://creativecommons.org/licenses/by/4.0/%E8%BF%9B%E8%A1%8C%E8%AE%B8%E5%8F%AF%E3%80%82