本文将介绍如何使用go语言构建一个基于kong的api网关,包括使用kong管理apis和plugins,以及使用go语言和kong api操作kong配置。
一、kong介绍
kong是一个开源的api网关,提供了一系列完整的api管理和安全功能,可以运行在多种环境中。它主要提供了负载均衡、服务发现、路由、认证、授权、限流、监控、插件等管理工具。kong使用nginx作为代理服务器,利用插件机制为http流量加入了各种高级功能。kong的插件可以根据需要启用,这样kong就可以满足各种特定业务场景和需求,因此也很受欢迎。
二、使用kong管理apis和plugins
安装kong可以通过kong官网的安装指南,选择不同的环境进行安装。这里以ubuntu为例:
$ echo "deb https://kong.bintray.com/kong-deb `lsb_release -sc` main" | sudo tee -a /etc/apt/sources.list$ curl -o bintray.key https://bintray.com/user/downloadsubjectpublickey?username=bintray$ sudo apt-key add bintray.key$ sudo apt-get update && sudo apt-get install -y kong
安装成功后会在/etc/kong目录下生成kong的配置文件。
启动kong$ kong start
管理apis使用kong的admin api来管理api。
$ curl -i -x post --url http://localhost:8001/apis/ --data 'name=helloworld' --data 'uris=/hello' --data 'upstream_url=http://example.com/hello'
上述例子通过admin api创建了一个名为helloworld,路由uri为/hello,上游服务器地址为http://example.com/hello的api,这样,只要访问http://localhost:8000/hello,就可以访问到http://example.com/hello。
管理plugins使用kong可以方便地添加plugins,使得api的能力进一步增强。
$ curl -i -x post --url http://localhost:8001/apis/helloworld/plugins/ --data 'name=key-auth'
上述例子通过admin api为helloworld这个api添加了一个名为key-auth的插件。这个插件用于基于api key(密钥)进行认证。
三、使用go语言和kong api操作kong配置
除了使用admin api来管理api和plugins,也可以使用kong提供的restful api进行更细粒度的控制,它完全符合kong内部的数据模型,比起admin api更方便。
这里我们将使用go语言,结合kong client sdk操作kong配置。
安装kong client sdk$ go get github.com/kong/go-kong/kong
创建kong配置conf := kong.configuration{ kongadminurl: "http://localhost:8001", // kong admin接口地址 kongurl: "http://localhost:8000", // kong代理服务地址}
创建api和routeapi := &kong.api{ name: kong.string("helloworld"), requesthost: kong.string("example.com"), upstreamurl: kong.string("http://example.com/hello"),}route := &kong.route{ name: kong.string("hello-route"), paths: kong.stringslice([]string{"/hello"}), methods: kong.stringslice([]string{"get"}),}
创建好之后,可以使用以下代码将它们关联起来:
service, err := kong.createservicewithdefaults(conf, api) // 用默认配置创建serviceif err != nil { panic(err)}route, err = kong.createroutewithdefaults(conf, route, service)if err != nil { panic(err)}
这样,就创建了一个名为helloworld,路由uri为/hello,上游服务器地址为http://example.com/hello,使用get请求访问的route。
添加plugin添加plugin也很简单,这里我们添加一个基于token的authentication插件,用于用户认证。代码如下:
plugin := &kong.plugin{ name: kong.string("jwt"), config: kong.configuration{ "anonymous": "true", },}route.plugins = []*kong.plugin{plugin}_, err = kong.updateroutewithdefaults(conf, route, service)if err != nil { panic(err)}
这里我们使用plugin的名字为jwt,于是就可以添加jwt认证了。这里我们使用了匿名认证。
总结
本文介绍了使用go语言和kong client sdk来构建api网关的过程。通过使用kong,可以快速构建api网关,管理api和插件,实现认证、限流等功能。使用go语言和kong client sdk可以进一步控制和管理kong。这些工具可以提高api网关的可扩展性和管理性,使得微服务能够更好地服务于业务。
以上就是使用go语言构建api网关的详细内容。
