Consul

功能描述

Consul服务发现为网关动态地提供了服务的接入地址,网关可以基于这些地址进行负载均衡处理。

Consul注册中心自带健康检查,从该注册中心获取节点时可以获取到稳定健康的节点。

OpenAPI配置服务发现

请求参数说明

参数名说明是否必填默认值值可能性
name实例名string
driver所使用的服务发现类别"consul"
description描述string
scheme(已废弃,apinto版本0.7.0起)请求服务发现地址时使用的协议"http"["http","https]
config服务发现配置object
config-> addressnacos地址列表array_string
config-> params参数信息,如{"token":"XXX","namespace":"default","username":"XXX","password":"xxx"}object

返回参数说明

参数名类型是否必含说明
idstring实例id
namestring实例名
driverstring驱动名
descriptionstring描述
professionstring模块名
createstring创建时间
updatestring更新时间
scheme(已废弃,apinto版本0.7.0起)string请求服务发现地址时使用的协议
configobject服务发现配置

备注:返回体内的config参考请求配置参数,在此不再赘述。

创建服务发现

若有命名空间字段或鉴权token,则在params里填入。

curl -X POST  \
  'http://127.0.0.1:9400/api/discovery' \
  -H 'Content-Type:application/json' \
  -d '{
	"name": "demo_consul",
	"driver": "consul",
	"config": {
		"address": ["http://127.0.0.1:8501", "http://127.0.0.1:8500"],
		"params": {
			"token": "a92316d8-5c99-4fa0-b4cd-30b9e66718aa",
			"namespace": "default"
		}
	}
}'

结果示例

{
	"config": {
		"address": ["http://127.0.0.1:8501", "http://127.0.0.1:8500"],
		"params": {
			"namespace": "default",
			"token": "a92316d8-5c99-4fa0-b4cd-30b9e66718aa"
		}
	},
	"create": "2022-06-15 11:30:58",
	"description": "",
	"driver": "consul",
	"id": "demo_consul@discovery",
	"name": "demo_consul",
	"profession": "discovery",
	"update": "2022-06-15 11:30:58"
}
返回的discoveryID为demo_consul@discovery

创建服务

服务发现id绑定服务:上一步生成的服务发现id绑定至服务的discovery字段

curl -X POST  \
  'http://127.0.0.1:9400/api/service' \
  -H 'Content-Type:application/json' \
  -d '{
	"name": "consul_service",
	"driver": "http",
	"description": "配置了consul服务发现的服务",
	"scheme": "http",
	"timeout": 3000,
	"retry": 3,
	"discovery": "demo_consul@discovery",
	"service": "redis",
	"balance": "round-robin"
}'