CITA 服务部署系列【三. cURL 查询功能】

cURL查询功能

什么是cURL?

cURL是一个利用URL语法在命令行下工作的文件传输工具,支持http、https、ftp等30多种类型协议的传输,常用于对web页面进行访问;

如何获取 CITA 服务端口信息?

在文档快速部署CITA服务中,成功部署了默认参数的 CITA 服务,初始化环境中会运行4个 CITA 共识节点,默认共运行了28个进程;

netstat -nutlp | grep 'cita-jsonrpc'
#查看当前主机上运行的 CITA 节点的 RPC 服务端口号

Tips:
默认情况下,cita-jsonrpc 服务的端口号起始于1337,如果单台主机部署多个节点,该端口号将逐个递增;
通过访问该进程提供的端口号,可对 CITA 服务的运行状态进行查询;默认情况下防火墙未放行非知名端口号,所以如果需对外提供该端口的访问,请务必打开防火墙,放行相应端口;

netstat -nutlp | grep 'cita-network'
#查看当前主机上运行的 CITA 节点的 Network 服务端口号

Tips:
默认情况下,cita-network 服务的端口号起始于4000,如果单台主机部署多个节点,该端口号将逐个递增;
通过访问该进程提供的端口号,CITA 服务中的节点可通过 P2P 网络进行数据同步和共识计算,如果在多台主机上部署多节点进行共识计算,请务必放行该进程的相应端口;

访问 CITA 服务的 cURL 常用指令

推荐使用 python 的 json.tool 模块查看 json 格式的回执信息

查询节点数量(共识节点 + 普通节点)

curl -s -X POST --data '{"jsonrpc":"2.0","method":"peerCount","params":[],"id":1}' 127.0.0.1:1337 | python -m json.tool

#or

curl -s -X POST --data '{"jsonrpc":"2.0","method":"peerCount","params":[],"id":1}' 127.0.0.1:1337

查看区块高度

curl -s -X POST --data '{"jsonrpc":"2.0","method":"blockNumber","params":[],"id":1}' 127.0.0.1:1337 | python -m json.tool

#or

curl -s -X POST --data '{"jsonrpc":"2.0","method":"blockNumber","params":[],"id":1}' 127.0.0.1:1337

Tips:
区块高度值会依据区块产出时间逐个递增,当 CITA 服务中的共识节点满足大于2/3在进行共识计算,则 CITA 服务将会正常运行,区块产出时会根据经济模型的不同对节点进行经济激励;


:grinning: 很感谢您能够看到这里,如果文中的内容有描述不当,请您在本章节下方指出,我会尽快修改;

1赞

TIPS:如果是在 Docker 启动,还需要将 Docker 内的 1337, … 端口暴露给宿主机。
如果宿主机是 Linux 端口会自动暴露,如果是 MAC 则需要手工暴露。

开始有一些Mac 的开发者用户了,应该开始考虑对这方面做些友好优化了

在 v0.23.0 已经做了一些优化了,可以通过

bin/cita port 1337:1337

来暴露一个 docker 端口到宿主机。

另外,Mac 用户还可以通过

brew install cita

来安装试用 CITA. 详细说明请参考: