前期准备
一、安装JDK
需要在部署中间件的服务器及开发的机器上都进行安装。
参考准备工作中的Java安装
二、定义接口
服务提供方需要提供接口定义标准。
具体使用方式请参考 服务定义
三、服务登记及服务调用登记
服务登记为服务提供方进行服务登记,登记服务方的服务器地址及端口号等信息。
调用方登记同服务方法登记相同,为调用方登记服务器地址及端口号等信息。
具体登记步骤请参考 服务登记
四、部署中间件
提示
-
此处部署中间件需要服务 提供方 及服务 调用方 都进行 部署 ,所有的接口协同数据传输及存证均由 中间件 进行完成。
-
部署前,服务提供方和服务调用方需要通过线下的方式,进行证书交换。
-
双方交换好证书后,需要将证书写入配置文件中 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
|
五、引入客户端
发布接入中间件客户端到本地仓库并引入代码中,参考此处。
同时,客户端也提供 jar 方式引入,点击 此处 下载jar包。