配置部署区块链

配置参数说明

区块链解决方案为大部分字段均提供了默认值，以降低用户配置的复杂度。如需对区块链进行定制，可参考以下字段说明进行参数设置。

使用控制台界面部署区块链

1. 登录容器服务管理控制台。
2. 在 Kubernetes 菜单下，单击左侧导航中的市场 > 应用目录。在右侧列表区域找到 ack-hyperledger-fabric，并单击该区域。
   
3. 在 应用目录-ack-hyperledger-fabric 应用界面右侧区域，选择部署集群，并填写发布名称。
   
4. 单击 参数 标签，查看或者修改相关部署参数。
   • sharedStorage： 输入#d6e235中记录的NAS文件系统挂载地址（必填，否则将部署失败）。
   • dockerImageRegistry：根据部署所在区域（中国或海外），从注释中的可选项中选择对应的容器镜像仓库地址填入。
   • externalAddress： 输入上文 Worker 节点绑定的弹性公网 IP，用于生成connection profile。

   

5. 单击 创建。
   说明 如参数中的sharedStorage未配置，部署过程将会报 spec.nfs.server: Required value的错误。出现此错误后，需要先删除对应的发布名称，然后填写sharedStorage参数值，并重新部署。

6. 进入部署集群的控制台界面，查看区块链网络相关 pods 的状态，直到全部变为 Running。
   

使用 Helm 命令行部署区块链

如需了解容器服务 Kubernetes 集群的 Helm 部署应用的更多功能，请参考利用 Helm 简化应用部署。

1. 通过 kubectl 连接 Kubernetes 集群。
2. 用 SSH 工具登录 Kubernetes 集群的 master 节点，使用 root 账户和在创建 Kubernetes 集群时设置的密码进行登录。
3. 运行 Helm 命令部署区块链网络。
   • 如需使用默认配置参数部署区块链网络，可执行如下命令：

     helm install --name blockchain-network01 --set "sharedStorage=987a6543bc-abc12.cn-hangzhou.nas.aliyuncs.com" incubator/ack-hyperledger-fabric

     其中 --name 为区块链网络对应的 Helm release 名称，用户可自行设置。

   • 如需将区块链网络部署于指定的 namespace（例如 network01），可执行如下命令：

     helm install --namespace network01  --name blockchain-network01 --set "sharedStorage=987a6543bc-abc12.cn-hangzhou.nas.aliyuncs.com" incubator/ack-hyperledger-fabric

     其中 --namespace 为区块链网络部署的目标 namespace 名称，用户可自行选定。

   • 如需设置简单或数量较少的配置参数部署区块链网络，可用 set 参数将配置参数传入，例如：

     helm install --name blockchain-network01 --set "fabricChannel=mychannel,sharedStorage=987a6543bc-abc12.cn-hangzhou.nas.aliyuncs.com" incubator/ack-hyperledger-fabric

   • 如需设置复杂的或数量较多的配置参数部署区块链网络，可用 yaml 文件将参数值传入，例如：

     helm install --values network01.yaml --name blockchain-network01 incubator/ack-hyperledger-fabric

     其中 --values 指定的是自定义配置参数的 yaml 文件，示例如下，用户可自行定义。

     # sample values yaml
     sharedStorage: 987a6543bc-abc12.cn-hangzhou.nas.aliyuncs.com
     fabricNetwork: network01
     fabricChannel: tradechannel
     orgNum: 3
     ordererNum: 4
     ordererDomain: shop
     peerDomain: shop
     externalAddress: 11.22.33.44
     caExternalPortList: ["31054", "31064", "31074"]
     ordererExternalPortList: ["31050", "31060", "31070", "31080"]
     peerExternalGrpcPortList: ["31051", "31061", "31071", "31081", "31091", "31101"]

     检查区块链网络的 Helm release 部署成功。执行如下命令，确保区块链网络对应的 release 状态为 DEPLOYED。

4. 执行如下命令，检查区块链网络的所有节点的 pod 是否均成功运行，确保区块链网络对应的 pod 状态均为 running。

   kubectl get pod

   • 如指定了namespace，如network01

     kubectl get pod -n network01

   • 如需要以watcher模式监听pod状态变化

     kubectl get pod -w

5. 执行如下命令，查看区块链网络部署的创建状态。如果显示状态为 DEPLOYED，说明部署成功。

   helm list

至此我们便完成了一套区块链网络的配置和部署。

区块链网络各节点服务的命名规则

对于 Hyperledger Fabric 的标准节点类型，相应的服务命名规则如下：

<区块链网络名称>-<节点类型><序号>

network01-peer1
network01-peer2
network01-orderer1
network01-ca1

需要说明的是，尽管在 Kubernetes 集群内可用 namespace 来区分不同的区块链网络，但上述服务命令规则中仍使用了区块链网络名称作为前缀，主要原因是为了保持与
swarm 集群的区块链解决方案一致。

此服务名称与区块链证书、密钥中的节点名称保持一致。对于部署于同一 Kubernetes 集群内的区块链应用程序或 CLI，均可使用此类服务名称（加上服务端口）直接访问，无需使用外部访问地址。

问题诊断

针对区块链的配置、部署、访问等过程中可能发生的各类问题或错误，我们在这里将介绍一些常用的问题诊断思路、方法和工具。

首先，建议检查环境准备 文档中所要求的各项准备工作是否均已正确完成。

其次，善用 Kubernetes 相关命令进行部署事件和输出日志等信息的查看，例如：kubectl describe pod，kubectl logs，kubectl get pod -o yaml 等。

此外，为辅助故障诊断和问题排查，区块链解决方案在区块链网络中一同部署了自定义的 fabric-utils 容器，里面集成了常用的基础工具，如 telnet、ping、nslookup、curl
等。用户可在 master 节点上，通过以下 kubectl 命令进入fabric-utils 容器中使用适合的工具进行诊断分析。例如：

kubectl exec -it fabric-utils-pod bash

最后，针对 Hyperledger Fabric 相关的问题或错误，可尝试通过搜索 Hyperledger Fabric 官方文档、StackOverFlow、Bing/Baidu
等查找相关线索或解决方案。