Go 插件系统
通过使用插件在运行时扩展程序的功能, 而无需重新编译程序, 这是一个很常见的功能需求, 特别是在模块化设计的程序里面, 比如Nginx的模块系统。 在C/C++中通过使用动态库的方式可以实现动态加载, 但是Go直到1.8官方才开始支持, 下面将介绍Go如何基于动态链接库来实现动态加载。
动态加载的优劣
优点:
- 动态加载, 也称热加载, 每次升级时不用重新编译整个工程,重新部署服务, 而是添加插件时进行动态更新。这对于很多比较重型的服务来说非常重要。
缺点:
- 带来一定的安全风险, 如果一些非法模块被注入如何防范
- 给系统带来一定的不稳定的因素, 如果模块有问题, 没有经过良好的测试, 容易导致服务崩溃
- 为版本管理带来了难题, 特别是在微服务的今天, 同一个服务, 加载了不同的插件, 应该怎么管理版本, 插件版本应该如何管理
因此请慎重考虑, 是使用动态插件还是在源码里面进行插件化。
Go的插件系统:Plugin
从1.8版开始, 官方提供了这种插件化的手段: plugin. 此功能使程序员可以使用动态链接库构建松散耦合的模块化程序,可以在运行时动态加载和绑定。
Go插件是使用-buildmode = plugin
标记编译的一个包, 用于生成一个共享对象(.so)库文件。 Go包中的导出的函数和变量被公开为ELF符号,可以使用plugin
包在运行时查找并绑定ELF符号。Go编译器能够使用build flag -buildmode = c-shared创建C风格的动态共享库。
1.8版本插件功能只能在Linux上使用。 1.10也可以在Mac上运行。
下面将介绍使用Go插件系统创建模块化软件的一些开发原则, 并提供一个功能齐全的示例。
插件开发原则
使用Go插件创建模块化程序需要遵循与常规Go软件包一样严格的软件实践。然而,插件引入了新的设计问题,因为它们的解耦性质被放大了。因此我们在设计可插拔系统时, 有一些原则需要关注:
- 插件独立
应该将插件视为与其他组件分离的独立组件。这允许插件独立于他们的消费者,并拥有自己的开发和部署生命周期。注意插件的可用性很重要, 因为它有肯能为整个系统带来不稳定的因素, 因此系统必须为插件集成提供一个简单的封装层, 插件开发人员将系统视为黑盒,不作为所提供的合约以外的假设, 从而保证插件自身的可用性。
- 使用接口类型作为边界
Go插件可以导出任何类型的包函数和变量。您可以设计插件来将其功能解耦为一组松散的函数。缺点是您必须单独查找和绑定每个函数符号。
然而,更为简单的方法是使用接口类型。创建导出功能的接口提供了统一简洁的交互,并具有清晰的功能划分。解析到接口的符号将提供对该功能的整个方法集的访问,而不仅仅是一个方法。
- Unix模块化原则
插件代码应该设计成只关注一个功能点。
- 版本控制
插件是不透明而独立的实体,应该进行版本控制,以向用户提示其支持的功能。这里的一个建议是在命名共享对象文件时使用语义版本控制。例如,上面的文件编译插件可以命名为eng.so.1.0.0。
插件开发示例
我以我遇到的一个实际需求为例, 在开发物联网接入组件的时候, 需要动态支持物解析, 下面就开发一个物解析的插件系统。
下面是项目结构, parser.go是接口规约, main.go是主程序, plugins存放多个插件包
1
2
3
4
5
6
7
8
|
.
├── main.go
├── parser.go
└── plugins
├── car
│ └── car.go
└── phone
└── phone.go
|
编写插件
-
编写主程序接口规约: main.go
123456package main// Parser use to parse thingstype Parser interface {Parse([]byte) (meta map[string]string, data map[string]float64, err error)} -
根据接口规约编写插件: car.go
123456789101112package maintype car stringfunc (c *car) Parse([]byte) (meta map[string]string, data map[string]float64, err error) {meta = map[string]string{"key1": "a"}data = map[string]float64{"key1": 1}return meta, data, nil}var Car car -
根据接口规约编写插件: phone.go
123456789101112package maintype phone stringfunc (p *phone) Parse([]byte) (meta map[string]string, data map[string]float64, err error) {meta = map[string]string{"key1": "b"}data = map[string]float64{"key1": 2}return meta, data, nil}var Phone phone -
编译插件
插件写完后将在plugins目录下编译插件:123$ cd plugins$ go build -buildmode=plugin -o car.so car/car.go$ go build -buildmode=plugin -o phone.so phone/phone.go
最终在plugins目录下会生成好我们编译好的插件:
1
2
|
$ ls *.so
car.so phone.so
|
使用插件
插件的使用很简单, 大概步骤如下:
- 用plugin.Open()打开插件文件
- 用plguin.Lookup(“Export-Variable-Name”)查找导出的符号”Car”或者”Phone”。 请注意,符号名称与插件模块中定义的变量名称相匹配
- 使用该变量
-
主程序使用插件: main.go
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455package mainimport ("fmt""plugin")// Parser use to parse thingstype Parser interface {Parse([]byte) (meta map[string]string, data map[string]float64, err error)}func pa() {plug, err := plugin.Open("./plugins/car.so")if err != nil {panic(err)}car, err := plug.Lookup("Car")if err != nil {panic(err)}p, ok := car.(Parser)if ok {meta, data, err := p.Parse([]byte("a"))if err != nil {panic(err)}fmt.Printf("meta: %v, data: %v ", meta, data)}}func pb() {plug, err := plugin.Open("./plugins/phone.so")if err != nil {panic(err)}phone, err := plug.Lookup("Phone")if err != nil {panic(err)}p, ok := phone.(Parser)if ok {meta, data, _ := p.Parse([]byte("a"))fmt.Printf("meta: %v, data: %v ", meta, data)}}func main() {pa()pb()} -
测试是否正常运行:
123$ go run main.gometa: map[key1:a], data: map[key1:1]meta: map[key1:b], data: map[key1:2]