hyperledger/cello-fabric-operator

Hyperledger Fabric Operator

概述

Fabric operator是一个Kubernetes operator，允许用户通过kubectl命令部署Fabric CA、Orderer和Peer节点。

前提条件

• kubectl v1.11.3+
• 访问Kubernetes v1.11.3+集群
• 每个CA、Peer和Orderer节点需要具有ReadWriteOnce访问模式的PersistentVolume存储位置

快速开始

启动Fabric Operator

$ kubectl apply \
  -f https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_ca_crd.yaml?raw=true \
  -f https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_orderer_crd.yaml?raw=true \
  -f https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_peer_crd.yaml?raw=true

如果看到类似以下消息，则命令执行成功：

customresourcedefinition.apiextensions.k8s.io/cas.fabric.hyperledger.org created
customresourcedefinition.apiextensions.k8s.io/orderers.fabric.hyperledger.org created
customresourcedefinition.apiextensions.k8s.io/peers.fabric.hyperledger.org created

创建operator CRD后，使用以下命令启动控制器：

kubectl apply \
  -f https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/fabric-operator.yaml?raw=true \
  -f https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/operator.yaml?raw=true

上述命令会在K8s集群的默认命名空间中启动Fabric operator控制器。如果要使用其他命名空间，应下载fabric-operator.yaml文件并将命名空间从default修改为所需的命名空间。

部署Fabric CA节点

1. 下载https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_ca_cr.yaml?raw=true：

wget https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_ca_cr.yaml?raw=true -O myca.yaml

2. 根据需求修改示例CA规范文件。以下是可在示例CA规范文件中修改的内容：

   • 节点名称
   • CA管理员用户名和密码
   • CA证书
   • CA节点版本、资源分配、配置参数

3. 运行以下命令部署CA节点：

kubectl apply -f myca.yaml

几分钟后，CA节点应启动运行，可使用以下命令查看状态：

kubectl describe ca

要删除CA节点（假设CA名称为ca1st），只需执行以下命令：

kubectl delete ca ca1st

部署Fabric Peer节点

1. 下载https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_peer_cr.yaml?raw=true：

wget https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_peer_cr.yaml?raw=true -O mypeer.yaml

2. 根据需求修改示例Peer规范文件。以下是可在示例Peer规范文件中修改的内容：

   • 节点名称
   • MSP和TLS证书
   • Peer节点版本、资源分配、配置参数

3. 运行以下命令部署Peer节点：

kubectl apply -f mypeer.yaml

几分钟后，Peer节点应启动运行，可使用以下命令查看状态：

kubectl describe peer

要删除Peer节点（假设Peer名称为peer1st），只需执行以下命令：

kubectl delete peer peer1st

部署Fabric Orderer节点

1. 下载https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_orderer_cr.yaml?raw=true：

wget https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/deploy/crds/fabric_v1alpha1_orderer_cr.yaml?raw=true -O myorderer.yaml

2. 根据需求修改示例Orderer规范文件。以下是可在示例Orderer规范文件中修改的内容：

   • 节点名称
   • MSP和TLS证书
   • Orderer节点版本、资源分配、配置参数

3. 运行以下命令部署Orderer节点：

kubectl apply -f myorderer.yaml

几分钟后，Orderer节点应启动运行，可使用以下命令查看状态：

kubectl describe orderer

要删除Orderer节点（假设Orderer名称为orderer1st），只需执行以下命令：

kubectl delete orderer orderer1st

通过API/仪表板使用Fabric Operator

要通过Cello API或仪表板运行operator，请按照以下说明操作：https://github.com/hyperledger/cello/blob/master/src/agent/fabric-operator/README.md

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