hyperledger/cello-nginx

Hyperledger Cello 镜像文档

镜像概述和主要用途

Hyperledger Cello是一款供应与操作系统，旨在帮助用户高效管理网络。通过Cello，用户可以轻松实现：

• 从零快速构建***即服务（BaaS）平台
• 即时供应定制化***（如Hyperledger Fabric v1.0网络）
• 在裸机、虚拟云（如虚拟机、vSphere云）、容器集群（如Docker、Swarm、Kubernetes）上维护运行中的***网络池
• 通过仪表板监控系统状态、调整链数量、扩展资源等

核心功能和特性

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

使用场景和适用范围

适用于需要快速部署、管理和扩展***网络的场景，典型应用包括：

• 企业构建内部***服务平台
• 云服务提供商提供BaaS解决方案
• 开发团队快速搭建测试或生产***环境
• 管理多节点、多版本***网络的运维需求

详细使用方法和配置说明

环境准备

需预先安装以下软件：

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

启动Cello服务

步骤1：构建必要镜像（可选）

当前Docker Hub自动构建尚未就绪，需手动构建镜像（未来可忽略此步骤）：

bash
make docker

步骤2：启动服务

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

bash
# 默认docker-compose部署
make start

# Kubernetes部署
DEPLOY_METHOD=k8s make start

服务启动后验证

• Docker Compose部署：执行docker ps可看到以下容器运行：

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部署：执行kubectl get deployments,pods,ingresses可看到以下资源：

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

访问仪表板

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

停止Cello服务

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

bash
# 默认docker-compose停止
make stop

# Kubernetes停止
DEPLOY_METHOD=k8s make stop

文档与资源

• 入门教程：新用户建议先阅读教程或索引
• 在线文档：访问Cello ReadTheDocs获取更多信息
• 本地文档：执行make doc启动本地文档网站（监听于localhost:8000）

项目说明

Cello是Hyperledger的孵化项目，于2017年1月7日经Hyperledger TSC批准。关于孵化阶段的更多信息，请参见Hyperledger项目生命周期文档。

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