跳转至

前期准备

一、安装JDK

需要在部署中间件的服务器及开发的机器上都进行安装。

参考准备工作中的Java安装

二、定义接口

服务提供方需要提供接口定义标准。

具体使用方式请参考 服务定义

三、服务登记及服务调用登记

服务登记为服务提供方进行服务登记,登记服务方的服务器地址及端口号等信息。

调用方登记同服务方法登记相同,为调用方登记服务器地址及端口号等信息。

具体登记步骤请参考 服务登记

四、部署中间件

提示

  1. 此处部署中间件需要服务 提供方 及服务 调用方 都进行 部署 ,所有的接口协同数据传输及存证均由 中间件 进行完成。

  2. 部署前,服务提供方和服务调用方需要通过线下的方式,进行证书交换。

  3. 双方交换好证书后,需要将证书写入配置文件中 repchain-services 下,同时将双方的ID也写入其中。

1. 下载中间件,参考下载中间件

2. 解压缩压缩包,参考解压

3. 修改配置

注意

修改配置请按照下面配置说明进行修改,下面所述说明均为 必须 修改的选项。

配置文件中的其他的默认配置可以根据自己的需求进行修改,但是不要删除任何默认配置。

​ 此处说明需要修改的几个 必要 的配置:

  • RepChain相关配置都需要进行修改,具体如下,详细说明可参考此处
# repchain配置文件
repchain:
  # repchain 地址
  host: 192.168.2.76:8081
  # 用户唯一标识
  creditCode: CGZL7XOwwa
  # 证书名称
  certName: test
  # 证书
  cert: -----BEGIN CERTIFICATE-----
    MIIBIDCBx6ADAgECAgQDNHtwMAoGCCqGSM49BAMCMA8xDTALBgNVBAMMBFRFU1Qw
    IhgPMjAyMTEwMjYwMTE0MDVaGA85OTk5MTIzMTIzNTk1OVowDzENMAsGA1UEAwwE
    VEVTVDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABO3voNU9OV4EoDyBHQcD+az/
    E5TB1i5fRf+tTaNgjCWr6jErt/Ce21b18uwTuZXx38nvA5l26S1MEpCAuuJSFymj
    DTALMAkGA1UdIwQCMAAwCgYIKoZIzj0EAwIDSAAwRQIhANjTlEKVu0O5lgEloHrh
    ZLcNMHH9S2sVzasTK5OJuXwGAiBGi2GL4W4XlWzjl94swApuv2bb7rbo2huBIzhc
    zZXMcw==
    -----END CERTIFICATE-----
  # 加密私钥
  privateKey: -----BEGIN ENCRYPTED PRIVATE KEY-----
    MIHUMD8GCSqGSIb3DQEFDTAyMBoGCSqGSIb3DQEFDDANBAi0q5jmLN61vAIBZDAU
    BggqhkiG9w0DBwQITUCFquFjnwEEgZAbZouweJPtR6zRaDhULbyzF3uaOnMErtx3
    kIguDP/qeb3wVoTW8kFuOw1jdrY5WyHGCngfpM5br6AUaEqIlBnA7rS3KZfhsxxq
    yLQcaySsfUowUE61oStDJtDgHMJE0dbxuYXjnzSQrnp9AnnX65uwUeDE6c+i7DnW
    pWoroVTXK/dQb4vWNmxmacQ6G8jmW0s=
    -----END ENCRYPTED PRIVATE KEY-----
  # 私钥设置的密码
  password: 123456
  # 签名证书对应的请求方id和服务方id可在dashboard查看
  services:
    # 用户自定义id,不能重复,必填
    - serviceId: 1
      # 调用方ID
      e_from: bb743c821635920387678
      # 调用方证书
      from_cert: -----BEGIN CERTIFICATE-----
        MIIBIDCBx6ADAgECAgQDNHtwMAoGCCqGSM49BAMCMA8xDTALBgNVBAMMBFRFU1Qw
        IhgPMjAyMTEwMjYwMTE0MDVaGA85OTk5MTIzMTIzNTk1OVowDzENMAsGA1UEAwwE
        VEVTVDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABO3voNU9OV4EoDyBHQcD+az/
        E5TB1i5fRf+tTaNgjCWr6jErt/Ce21b18uwTuZXx38nvA5l26S1MEpCAuuJSFymj
        DTALMAkGA1UdIwQCMAAwCgYIKoZIzj0EAwIDSAAwRQIhANjTlEKVu0O5lgEloHrh
        ZLcNMHH9S2sVzasTK5OJuXwGAiBGi2GL4W4XlWzjl94swApuv2bb7rbo2huBIzhc
        zZXMcw==
        -----END CERTIFICATE-----
      # 服务提供方id
      e_to: 7b5c66df1635920342945
      # 提供方证书
      to_cert: -----BEGIN CERTIFICATE-----
        MIIBIDCBx6ADAgECAgQDNHtwMAoGCCqGSM49BAMCMA8xDTALBgNVBAMMBFRFU1Qw
        IhgPMjAyMTEwMjYwMTE0MDVaGA85OTk5MTIzMTIzNTk1OVowDzENMAsGA1UEAwwE
        VEVTVDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABO3voNU9OV4EoDyBHQcD+az/
        E5TB1i5fRf+tTaNgjCWr6jErt/Ce21b18uwTuZXx38nvA5l26S1MEpCAuuJSFymj
        DTALMAkGA1UdIwQCMAAwCgYIKoZIzj0EAwIDSAAwRQIhANjTlEKVu0O5lgEloHrh
        ZLcNMHH9S2sVzasTK5OJuXwGAiBGi2GL4W4XlWzjl94swApuv2bb7rbo2huBIzhc
        zZXMcw==
        -----END CERTIFICATE-----
  • Middleware配置,以下配置请根据服务登记或服务调用相关内容进行修改,详细说明可参考此处
## 中间件配置
middleware:
  # 用来访问宿主机的服务接口的客户端
  recClient:
    host: 127.0.0.1
    port: 80
  # 提供给宿主机调用中间件的服务接口配置
  recServer:
    # 端口
    port: 8888
  # 提供给其他中间件访问的grpc服务端口,此处需要和服务登记或服务调用中提交的接口保持一致
  comServer:
    # 端口
    port: 8080

4. 启动中间件,参考启动停止重启

五、引入客户端

发布接入中间件客户端到本地仓库并引入代码中,参考此处

同时,客户端也提供 jar 方式引入,点击 此处 下载jar包。

回到页面顶部