要理解kubernetes的list-watch机制,首先应该熟悉理解kubernetes的watch包中的各种实现以及原理。这篇文章将从代码实现看看kubernetes的watch包实现。从kubernetes1.6之后,kubernetes的watch包抽取到了apimachinery这个项目下。
watch包文件说明
watch包主要包含5个文件:watch.go,mux.go,filter.go,streamwatch.go,util.go。下面是对这五个文件作简单的说明:
1. watch.go 主要是接口定义及对interface的三种实现的封装。
2. mux.go 主要是事件广播器。
3. filter.go 主要是对事件的过滤。
4. streamwatch.go 主要是对decoder接口实现的封装。
5. util.go 主要是对满足条件时间的过滤。
watch.go文件
watch.go定义了接口,k8s中说有的event事件统一都实现了interface接口,interface接口的定义如下:
1. Event结构体,主要包括:事件类型Type和事件发生的对象Object,k8s中所有的对象(比如:pod、service、rc、dp….)都是runtime.Object;
2. watch.Interface中主要有两个方法:分别是对事件的监听结果ResultChan()和停止监听Stop()方法;
3. watch.go还包括对Interface的三种实现的封装:emptyWatch、fakerWatch
、racefreeWatch,fakerWatch和racefreeWatch是线程安全的;
mux.go文件
mux.go文件中主要包括了事件广播器Broadcaster和广播器的观察者broadcasterWatcher;
1. Broadcaster包括watchers,当创建一个Broadcaster时,Broadcaster会开一个协程接收所有的事件及发送事件到所有注册的watcher。保证Broadcaster的所有的watcher一直都能不断的接收到Broadcaster发送过来的事件;
2. broadcastWatcher实现了watch.Interface,包括:resultChan方法和stop方法;
3. 在kube-scheduler中,会创建record.NewBroadcaster(),发送event到logging函数,参见之前的文章:kubernetes1.8 kube-scheduler源码阅读
filter.go文件
filter.go文件也是主要对interface的的实现,加上了事件过滤的方法,这样的话,就可以只watcher满足一定条件的事件了;
同时,filter.go中的Recorder结构体,记录watcher所接收到的所有的事件;