Skip to content

Latest commit

 

History

History
188 lines (179 loc) · 6.06 KB

README_zh.md

File metadata and controls

188 lines (179 loc) · 6.06 KB

Peitho - Hyperledger Fabric chaincode 云原生托管系统

可以将Hyperledger Fabric的chaincode 交给k8s来管理，适用于在k8s上部署Hyperledger Fabric联盟链，解决chaincode游离于k8s管控问题。

功能特性

  • k8s完全托管chaincode
  • 对fabric无任何侵入，只需将CORE_VM_ENDPOINT环境变量配置成Peitho服务即可
  • 支持fabric 1.4.x 2.0 以上
  • chaincode镜像支持两种镜像分发模式：镜像仓库中心模式、自分发模式
  • 支持自动清理chaincode（当fabric节点移除时）

实现

软件架构

架构图

处理流程

peitho有两种模式，一种是镜像中心模式、一种是自分发模式

  1. 镜像中心模式, chaincode镜像build完后会推送给镜像仓库中心 架构图
  2. 自分发模式，chaincode镜像构build完后，保存在peihto中，deployment中对的初始化容器puller会从peitho下载镜像，并加载到本地宿主机 架构图

快速开始

构建

1.获取源码

git clone https://github.com/tianrandailove/peitho

2.编译

cd peitho
make build

3.生成镜像

make image

使用指南

###前提

chaincode 镜像构建过程中需要使用到fabic-ccenv和fabric-baseos这两个镜像，一定要确保这两个镜像能被peitho服务所在宿主机docker拉取下来，这样才能完成chaincode镜像的构建 通过peer的环境变量（CORE_CHAINCODE_BUILDER、CORE_CHAINCODE_GOLANG_RUNTIME）可以自定义 fabic-ccenv和fabric-baseos的镜像tag,来告诉peitho以此拉取镜像

  1. 配置peitho-configmap.yaml
# Copyright 2021 Ke Fan <[email protected]>. All rights reserved.
# Use of this source code is governed by a MIT style
# license that can be found in the LICENSE file.

apiVersion: v1
data:
  kubeconfig: |-
    #填入你获取的k8s 访问凭证
  peitho.yml: |-
    sweeper:
      enable: true # 是否开启自动清扫
      interval: 5 #自动清扫时间周期，单位秒
    peitho:
      imageMode: delivery #选择一种模式：registry or delivery，如果选择了registry，那么请配置好docker.registry
      pullerAccessAddress: http://peitho:8080/tar #pitho 的tar包下载地址
      pullerImage: x.x.x.x:8099/platform/puller-amd64:v-2-g5cada04 #由于puller的镜像地址，initcontainer会使用到
    k8s:
      namespace: fabric #命名空间
      kubeconfig: /root/kube/kubeconfig #k8s访问配置文件
      dns: #如果chaincode 和 peer不在同一个环境的情况下，需要配置peer地址的解析
        - 127.0.0.1:peer0.org1.example.com
        - 127.0.0.1:peer1.org1.example.com
        - 127.0.0.1:peer0.org2.example.com
        - 127.0.0.1:peer1.org2.example.com
    docker:
      endpoint: unix:///host/var/run/docker.sock # docker的端点
      registry: #镜像仓库相关
        server-address: #仓库地址
          xxx.xxx.xxx.xxx:xxxx
        project: #项目名
          chaincode
        email: #邮箱
          [email protected]
        username: #用户名
          admin
        password: #密码
          harbor
    log:
      name: peitho # Logger的名字
      development: true # 是否是开发模式。如果是开发模式，会对DPanicLevel进行堆栈跟踪。
      level: debug # 日志级别，优先级从低到高依次为：debug, info, warn, error, dpanic, panic, fatal。
      format: console # 支持的日志输出格式，目前支持console和json两种。console其实就是text格式。
      enable-color: true # 是否开启颜色输出，true:是，false:否
      disable-caller: true # 是否开启 caller，如果开启会在日志中显示调用日志所在的文件、函数和行号
      disable-stacktrace: false # 是否再panic及以上级别禁止打印堆栈信息
kind: ConfigMap
metadata:
  name: peitho-configmap
  namespace: fabric
  1. 配置peitho-deployment.yaml
# Copyright 2021 Ke Fan <[email protected]>. All rights reserved.
# Use of this source code is governed by a MIT style
# license that can be found in the LICENSE file.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: peitho
spec:
  replicas: 1
  selector:
    matchLabels:
      app: peitho
  strategy:
    rollingUpdate:
      maxSurge: 1
      maxUnavailable: 0
    type: RollingUpdate
  template:
    metadata:
      labels:
        app: peitho
    spec:
      containers:
      - image: tianrandailoving/peitho:latest
        imagePullPolicy: Always
        name: peitho
        ports:
        - containerPort: 8080
          name: peitho
          protocol: TCP
        resources: {}
        securityContext:
          allowPrivilegeEscalation: false
          privileged: false
          readOnlyRootFilesystem: false
          runAsNonRoot: false
        stdin: true
        terminationMessagePath: /dev/termination-log
        terminationMessagePolicy: File
        tty: true
        volumeMounts:
        - mountPath: /host/var/run/
          name: vol2
        - mountPath: /root/peitho.yml
          name: vol1
          subPath: peitho.yml
        - mountPath: /root/kube/kubeconfig
          name: vol1
          subPath: kubeconfig
      dnsConfig: {}
      dnsPolicy: ClusterFirst
      restartPolicy: Always
      schedulerName: default-scheduler
      securityContext: {}
      terminationGracePeriodSeconds: 30
      volumes:
      - hostPath:
          path: /var/run/
          type: ""
        name: vol2
      - configMap:
          defaultMode: 256
          items:
          - key: peitho.yml
            path: peitho.yml
          - key: kubeconfig
            path: kubeconfig
          name: peitho-configmap
          optional: false
        name: vol1
  1. 创建configmap 和 deployment
kubectl apply -f peitho-configmap.yaml
kubectl apply -f peitho-deployment.yaml
  1. 更改peer的环境变量
- name: CORE_VM_ENDPOINT
  value: tcp://peitho:8080

关于作者

License

Peitho is licensed under the MIT.

其他

获取peitho镜像

docker pull tianrandailoving/peitho:latest