自拍偷在线精品自拍偷,亚洲欧美中文日韩v在线观看不卡

Kubebuilder 進(jìn)階之源碼分析

開發(fā) 前端
kubebuilder 幫我們做了很多事情,讓我們的開發(fā)基本上只需要關(guān)注一個(gè) Reconcile 函數(shù)就可以了,但是從另外一個(gè)方面來講,kubebuilder 目前對(duì)我們來說它還是一個(gè)黑盒,會(huì)產(chǎn)生很多的疑問.

 [[399769]]

在前面的文章當(dāng)中我們已經(jīng)完整的完成了一個(gè) Operator 的開發(fā),涉及到了 CURD、預(yù)刪除、Status、Event、OwnerReference、WebHook,也算是將一個(gè) Operator 開發(fā)中會(huì)涉及到的點(diǎn)大部分都了解了一下。kubebuilder 幫我們做了很多事情,讓我們的開發(fā)基本上只需要關(guān)注一個(gè) Reconcile 函數(shù)就可以了,但是從另外一個(gè)方面來講,kubebuilder 目前對(duì)我們來說它還是一個(gè)黑盒,會(huì)產(chǎn)生很多的疑問:

  • Reconcile 方法是怎么被觸發(fā)的?
  • 怎么識(shí)別到不同的資源?
  • 整體是如何進(jìn)行工作的?
  • ……

架構(gòu)

我們先來看一下來自官方文檔的這個(gè)架構(gòu)圖[1]

arch

  • Process 進(jìn)程通過 main.go啟動(dòng),一般來說一個(gè) Controller 只有一個(gè)進(jìn)程,如果做了高可用的話,會(huì)有多個(gè)
  • Manager 每個(gè)進(jìn)程會(huì)有一個(gè) Manager,這是核心組件,主要負(fù)責(zé)
    • metrics 的暴露
    • webhook 證書
    • 初始化共享的 cache
    • 初始化共享的 clients 用于和 APIServer 進(jìn)行通信
    • 所有的 Controller 的運(yùn)行
  • Client 一般來說,我們 創(chuàng)建、更新、刪除某個(gè)資源的時(shí)候會(huì)直接調(diào)用 Client 和 APIServer 進(jìn)行通信
  • Cache 負(fù)責(zé)同步 Controller 關(guān)心的資源,其核心是 GVK -> Informer 的映射,一般我們的 Get 和 List 操作都會(huì)從 Cache 中獲取數(shù)據(jù)
  • Controller 控制器的業(yè)務(wù)邏輯所在的地方,一個(gè) Manager 可能會(huì)有多個(gè) Controller,我們一般只需要實(shí)現(xiàn) Reconcile 方法就行。圖上的 Predicate 是事件過濾器,我們可以在 Controller 中過濾掉我們不關(guān)心的事件信息
  • WebHook 就是我們準(zhǔn)入控制實(shí)現(xiàn)的地方了,主要是有兩類接口,一個(gè)是 MutatingAdmissionWebhook 需要實(shí)現(xiàn) Defaulter 接口,一個(gè)是 ValidatingAdmissionWebhook 需要實(shí)現(xiàn) Validator 接口

源碼分析

了解了基本的架構(gòu)之后,我們就從入口 main.go 開始,看一看 kubebuilder 究竟在后面偷偷的做了哪些事情吧。

main.go

  1. // 省略了參數(shù)綁定和 error check 的代碼 
  2. func main() { 
  3.     var metricsAddr string 
  4.     var enableLeaderElection bool 
  5.     var probeAddr string 
  6.  
  7.     ctrl.SetLogger(zap.New(zap.UseFlagOptions(&opts))) 
  8.  
  9.     mgr, err := ctrl.NewManager(ctrl.GetConfigOrDie(), ctrl.Options{ 
  10.         Scheme:                 scheme, 
  11.         MetricsBindAddress:     metricsAddr, 
  12.         Port:                   9443, 
  13.         HealthProbeBindAddress: probeAddr, 
  14.         LeaderElection:         enableLeaderElection, 
  15.         LeaderElectionID:       "97acaccf.lailin.xyz"
  16.         // CertDir:                "config/cert/", // 手動(dòng)指定證書位置用于測(cè)試 
  17.     }) 
  18.      
  19.  
  20.     (&controllers.NodePoolReconciler{ 
  21.         Client:   mgr.GetClient(), 
  22.         Log:      ctrl.Log.WithName("controllers").WithName("NodePool"), 
  23.         Scheme:   mgr.GetScheme(), 
  24.         Recorder: mgr.GetEventRecorderFor("NodePool"), 
  25.     }).SetupWithManager(mgr) 
  26.  
  27.     (&nodesv1.NodePool{}).SetupWebhookWithManager(mgr) 
  28.    
  29.     //+kubebuilder:scaffold:builder 
  30.  
  31.     mgr.AddHealthzCheck("healthz", healthz.Ping) 
  32.     mgr.AddReadyzCheck("readyz", healthz.Ping) 
  33.  
  34.     setupLog.Info("starting manager"
  35.     mgr.Start(ctrl.SetupSignalHandler()) 

可以看到 main.go 主要是做了一些啟動(dòng)的工作包括:

  • 創(chuàng)建一個(gè) Manager
  • 使用剛剛創(chuàng)建的 Manager 創(chuàng)建了一個(gè) Controller
  • 啟動(dòng) WebHook
  • 添加健康檢查
  • 啟動(dòng) Manager

下面我們就順著 main 函數(shù)里面的邏輯一步步的往下看看

NewManger

  1. // New returns a new Manager for creating Controllers. 
  2. func New(config *rest.Config, options Options) (Manager, error) { 
  3.     // 省略配置初始化相關(guān)代碼 
  4.  
  5.     // 創(chuàng)建 cache 
  6.     cache, err := options.NewCache(config,  
  7.                                  cache.Options{ 
  8.                                    Scheme: options.Scheme, // main 中傳入的 scheme 
  9.                                    Mapper: mapper,         // k8s api 和 go type 的轉(zhuǎn)換器 
  10.                                    Resync: options.SyncPeriod, // 默認(rèn) 10 小時(shí),一般不要改 
  11.                                    Namespace: options.Namespace, // 需要監(jiān)聽的 namespace 
  12.                                  }) 
  13.  
  14.   // 創(chuàng)建和 APIServer 交互的 client,讀寫分離 
  15.     clientOptions := client.Options{Scheme: options.Scheme, Mapper: mapper} 
  16.     apiReader, err := client.New(config, clientOptions) 
  17.  
  18.  
  19.     writeObj, err := options.ClientBuilder. 
  20.         WithUncached(options.ClientDisableCacheFor...). 
  21.         Build(cache, config, clientOptions) 
  22.  
  23.     if options.DryRunClient { 
  24.         writeObj = client.NewDryRunClient(writeObj) 
  25.     } 
  26.  
  27.     // 創(chuàng)建事件記錄器 
  28.     recorderProvider, err := options.newRecorderProvider(config, options.Scheme, options.Logger.WithName("events"), options.makeBroadcaster) 
  29.  
  30.     // 需要需要高可用的話,創(chuàng)建選舉相關(guān)的配置 
  31.     leaderConfig := config 
  32.     if options.LeaderElectionConfig != nil { 
  33.         leaderConfig = options.LeaderElectionConfig 
  34.     } 
  35.     resourceLock, err := options.newResourceLock(leaderConfig, recorderProvider, leaderelection.Options{ 
  36.         LeaderElection:             options.LeaderElection, 
  37.         LeaderElectionResourceLock: options.LeaderElectionResourceLock, 
  38.         LeaderElectionID:           options.LeaderElectionID, 
  39.         LeaderElectionNamespace:    options.LeaderElectionNamespace, 
  40.     }) 
  41.  
  42.     // 創(chuàng)建 metric 和 健康檢查的接口 
  43.     metricsListener, err := options.newMetricsListener(options.MetricsBindAddress) 
  44.  
  45.     // By default we have no extra endpoints to expose on metrics http server. 
  46.     metricsExtraHandlers := make(map[string]http.Handler) 
  47.  
  48.     // Create health probes listener. This will throw an error if the bind 
  49.     // address is invalid or already in use. 
  50.     healthProbeListener, err := options.newHealthProbeListener(options.HealthProbeBindAddress) 
  51.     if err != nil { 
  52.         return nil, err 
  53.     } 
  54.  
  55.   // 最后將這些配置放到 manager 中 
  56.     return &controllerManager{ 
  57.         config:                  config, 
  58.         scheme:                  options.Scheme, 
  59.         cache:                   cache, 
  60.         fieldIndexes:            cache, 
  61.         client:                  writeObj, 
  62.         apiReader:               apiReader, 
  63.         recorderProvider:        recorderProvider, 
  64.         resourceLock:            resourceLock, 
  65.         mapper:                  mapper, 
  66.         metricsListener:         metricsListener, 
  67.         metricsExtraHandlers:    metricsExtraHandlers, 
  68.         logger:                  options.Logger, 
  69.         elected:                 make(chan struct{}), 
  70.         port:                    options.Port, 
  71.         host:                    options.Host, 
  72.         certDir:                 options.CertDir, 
  73.         leaseDuration:           *options.LeaseDuration, 
  74.         renewDeadline:           *options.RenewDeadline, 
  75.         retryPeriod:             *options.RetryPeriod, 
  76.         healthProbeListener:     healthProbeListener, 
  77.         readinessEndpointName:   options.ReadinessEndpointName, 
  78.         livenessEndpointName:    options.LivenessEndpointName, 
  79.         gracefulShutdownTimeout: *options.GracefulShutdownTimeout, 
  80.         internalProceduresStop:  make(chan struct{}), 
  81.     }, nil 

創(chuàng)建 Cache

  1. func New(config *rest.Config, opts Options) (Cache, error) { 
  2.     opts, err := defaultOpts(config, opts) 
  3.     if err != nil { 
  4.         return nil, err 
  5.     } 
  6.     im := internal.NewInformersMap(config, opts.Scheme, opts.Mapper, *opts.Resync, opts.Namespace) 
  7.     return &informerCache{InformersMap: im}, nil 

這里主要是調(diào)用 NewInformersMap方法創(chuàng)建 Informer 的映射

  1. func NewInformersMap(config *rest.Config, 
  2.     scheme *runtime.Scheme, 
  3.     mapper meta.RESTMapper, 
  4.     resync time.Duration, 
  5.     namespace string) *InformersMap { 
  6.  
  7.     return &InformersMap{ 
  8.         structured:   newStructuredInformersMap(config, scheme, mapper, resync, namespace), 
  9.         unstructured: newUnstructuredInformersMap(config, scheme, mapper, resync, namespace), 
  10.         metadata:     newMetadataInformersMap(config, scheme, mapper, resync, namespace), 
  11.  
  12.         Scheme: scheme, 
  13.     } 

NewInformersMap會(huì)去分別創(chuàng)建,結(jié)構(gòu)化、非結(jié)構(gòu)化以及 metadata 的 InformerMap 而這些方法最后都會(huì)去調(diào)用 newSpecificInformersMap方法,區(qū)別就是不同的方法傳入的 createListWatcherFunc 參數(shù)不同

  1. func newSpecificInformersMap(config *rest.Config, 
  2.     scheme *runtime.Scheme, 
  3.     mapper meta.RESTMapper, 
  4.     resync time.Duration, 
  5.     namespace string, 
  6.     createListWatcher createListWatcherFunc) *specificInformersMap { 
  7.     ip := &specificInformersMap{ 
  8.         config:            config, 
  9.         Scheme:            scheme, 
  10.         mapper:            mapper, 
  11.         informersByGVK:    make(map[schema.GroupVersionKind]*MapEntry), 
  12.         codecs:            serializer.NewCodecFactory(scheme), 
  13.         paramCodec:        runtime.NewParameterCodec(scheme), 
  14.         resync:            resync, 
  15.         startWait:         make(chan struct{}), 
  16.         createListWatcher: createListWatcher, 
  17.         namespace:         namespace, 
  18.     } 
  19.     return ip 

newSpecificInformersMap 和常規(guī)的 InformersMap 類似,區(qū)別是沒實(shí)現(xiàn) WaitForCacheSync方法

以結(jié)構(gòu)化的傳入的 createStructuredListWatch 為例,主要是返回一個(gè)用于創(chuàng)建 SharedIndexInformer 的 ListWatch 對(duì)象

  1. func createStructuredListWatch(gvk schema.GroupVersionKind, ip *specificInformersMap) (*cache.ListWatch, error) { 
  2.  // Kubernetes APIs work against Resources, not GroupVersionKinds.  Map the 
  3.  // groupVersionKind to the Resource API we will use. 
  4.  mapping, err := ip.mapper.RESTMapping(gvk.GroupKind(), gvk.Version) 
  5.  if err != nil { 
  6.   return nil, err 
  7.  } 
  8.  
  9.  client, err := apiutil.RESTClientForGVK(gvk, false, ip.config, ip.codecs) 
  10.  if err != nil { 
  11.   return nil, err 
  12.  } 
  13.  listGVK := gvk.GroupVersion().WithKind(gvk.Kind + "List"
  14.  listObj, err := ip.Scheme.New(listGVK) 
  15.  if err != nil { 
  16.   return nil, err 
  17.  } 
  18.  
  19.  // TODO: the functions that make use of this ListWatch should be adapted to 
  20.  //  pass in their own contexts instead of relying on this fixed one here. 
  21.  ctx := context.TODO() 
  22.  // Create a new ListWatch for the obj 
  23.  return &cache.ListWatch{ 
  24.   ListFunc: func(opts metav1.ListOptions) (runtime.Object, error) { 
  25.    res := listObj.DeepCopyObject() 
  26.    isNamespaceScoped := ip.namespace != "" && mapping.Scope.Name() != meta.RESTScopeNameRoot 
  27.    err := client.Get().NamespaceIfScoped(ip.namespace, isNamespaceScoped).Resource(mapping.Resource.Resource).VersionedParams(&opts, ip.paramCodec).Do(ctx).Into(res) 
  28.    return res, err 
  29.   }, 
  30.   // Setup the watch function 
  31.   WatchFunc: func(opts metav1.ListOptions) (watch.Interface, error) { 
  32.    // Watch needs to be set to true separately 
  33.    opts.Watch = true 
  34.    isNamespaceScoped := ip.namespace != "" && mapping.Scope.Name() != meta.RESTScopeNameRoot 
  35.    return client.Get().NamespaceIfScoped(ip.namespace, isNamespaceScoped).Resource(mapping.Resource.Resource).VersionedParams(&opts, ip.paramCodec).Watch(ctx) 
  36.   }, 
  37.  }, nil 

小結(jié): cache 主要是創(chuàng)建了一些 InformerMap,完成了 GVK 到 Informer 的映射,每個(gè) Informer 會(huì)根據(jù) ListWatch 函數(shù)對(duì)對(duì)應(yīng)的 GVK 進(jìn)行 List 和 Watch。

創(chuàng)建 Client

  1. func New(config *rest.Config, options Options) (Client, error) { 
  2.  if config == nil { 
  3.   return nil, fmt.Errorf("must provide non-nil rest.Config to client.New"
  4.  } 
  5.  
  6.  // Init a scheme if none provided 
  7.  if options.Scheme == nil { 
  8.   options.Scheme = scheme.Scheme 
  9.  } 
  10.  
  11.  // Init a Mapper if none provided 
  12.  if options.Mapper == nil { 
  13.   var err error 
  14.   options.Mapper, err = apiutil.NewDynamicRESTMapper(config) 
  15.   if err != nil { 
  16.    return nil, err 
  17.   } 
  18.  } 
  19.  
  20.  clientcache := &clientCache{ 
  21.   config: config, 
  22.   scheme: options.Scheme, 
  23.   mapper: options.Mapper, 
  24.   codecs: serializer.NewCodecFactory(options.Scheme), 
  25.  
  26.   structuredResourceByType:   make(map[schema.GroupVersionKind]*resourceMeta), 
  27.   unstructuredResourceByType: make(map[schema.GroupVersionKind]*resourceMeta), 
  28.  } 
  29.  
  30.  rawMetaClient, err := metadata.NewForConfig(config) 
  31.  if err != nil { 
  32.   return nil, fmt.Errorf("unable to construct metadata-only client for use as part of client: %w", err) 
  33.  } 
  34.  
  35.  c := &client{ 
  36.   typedClient: typedClient{ 
  37.    cache:      clientcache, 
  38.    paramCodec: runtime.NewParameterCodec(options.Scheme), 
  39.   }, 
  40.   unstructuredClient: unstructuredClient{ 
  41.    cache:      clientcache, 
  42.    paramCodec: noConversionParamCodec{}, 
  43.   }, 
  44.   metadataClient: metadataClient{ 
  45.    client:     rawMetaClient, 
  46.    restMapper: options.Mapper, 
  47.   }, 
  48.   scheme: options.Scheme, 
  49.   mapper: options.Mapper, 
  50.  } 
  51.  
  52.  return c, nil 

client 創(chuàng)建了兩個(gè)一個(gè)用于讀,一個(gè)用于寫,用于讀的會(huì)直接使用上面的 cache,用于寫的才會(huì)直接和 APIServer 進(jìn)行交互

Controller

下面我們看一下核心的 Controller 是怎么初始化和工作的

  1. if err = (&controllers.NodePoolReconciler{ 
  2.   Client:   mgr.GetClient(), 
  3.   Log:      ctrl.Log.WithName("controllers").WithName("NodePool"), 
  4.   Scheme:   mgr.GetScheme(), 
  5.   Recorder: mgr.GetEventRecorderFor("NodePool"), 
  6. }).SetupWithManager(mgr); err != nil { 
  7.   setupLog.Error(err, "unable to create controller""controller""NodePool"
  8.   os.Exit(1) 

main.go 的方法里面主要是初始化了 Controller 的結(jié)構(gòu)體,然后調(diào)用了 SetupWithManager方法

  1. // SetupWithManager sets up the controller with the Manager. 
  2. func (r *NodePoolReconciler) SetupWithManager(mgr ctrl.Manager) error { 
  3.     return ctrl.NewControllerManagedBy(mgr). 
  4.         For(&nodesv1.NodePool{}). 
  5.         Watches(&source.Kind{Type: &corev1.Node{}}, handler.Funcs{UpdateFunc: r.nodeUpdateHandler}). 
  6.         Complete(r) 

SetupWithManager之前有講到過,主要是使用了建造者模式,去構(gòu)建了我們需要監(jiān)聽的對(duì)象,只有這些對(duì)象的相關(guān)事件才會(huì)觸發(fā)我們的 Reconcile 邏輯。這里面的 Complete 最后其實(shí)是調(diào)用了 Build 方法

  1. func (blder *Builder) Build(r reconcile.Reconciler) (controller.Controller, error) { 
  2.     // 省略參數(shù)校驗(yàn) 
  3.  
  4.     // Set the Config 
  5.     blder.loadRestConfig() 
  6.  
  7.     // Set the ControllerManagedBy 
  8.     if err := blder.doController(r); err != nil { 
  9.         return nil, err 
  10.     } 
  11.  
  12.     // Set the Watch 
  13.     if err := blder.doWatch(); err != nil { 
  14.         return nil, err 
  15.     } 
  16.  
  17.     return blder.ctrl, nil 

Build主要調(diào)用 doController 、doWatch兩個(gè)方法

  1. func (blder *Builder) doController(r reconcile.Reconciler) error { 
  2.     ctrlOptions := blder.ctrlOptions 
  3.     if ctrlOptions.Reconciler == nil { 
  4.         ctrlOptions.Reconciler = r 
  5.     } 
  6.  
  7.     // Retrieve the GVK from the object we're reconciling 
  8.     // to prepopulate logger information, and to optionally generate a default name
  9.     gvk, err := getGvk(blder.forInput.object, blder.mgr.GetScheme()) 
  10.     if err != nil { 
  11.         return err 
  12.     } 
  13.  
  14.     // Setup the logger. 
  15.     if ctrlOptions.Log == nil { 
  16.         ctrlOptions.Log = blder.mgr.GetLogger() 
  17.     } 
  18.     ctrlOptions.Log = ctrlOptions.Log.WithValues("reconciler group", gvk.Group"reconciler kind", gvk.Kind) 
  19.  
  20.     // Build the controller and return
  21.     blder.ctrl, err = newController(blder.getControllerName(gvk), blder.mgr, ctrlOptions) 
  22.     return err 

doController主要是初始化了一個(gè) Controller,這里面?zhèn)魅肓宋覀儗?shí)現(xiàn) 的Reconciler以及獲取到我們的 GVK 的名稱

  1. func (blder *Builder) doWatch() error { 
  2.     // Reconcile type 
  3.     typeForSrc, err := blder.project(blder.forInput.object, blder.forInput.objectProjection) 
  4.     if err != nil { 
  5.         return err 
  6.     } 
  7.     src := &source.Kind{Type: typeForSrc} 
  8.     hdler := &handler.EnqueueRequestForObject{} 
  9.     allPredicates := append(blder.globalPredicates, blder.forInput.predicates...) 
  10.     if err := blder.ctrl.Watch(src, hdler, allPredicates...); err != nil { 
  11.         return err 
  12.     } 
  13.  
  14.     // Watches the managed types 
  15.     for _, own := range blder.ownsInput { 
  16.         typeForSrc, err := blder.project(own.object, own.objectProjection) 
  17.         if err != nil { 
  18.             return err 
  19.         } 
  20.         src := &source.Kind{Type: typeForSrc} 
  21.         hdler := &handler.EnqueueRequestForOwner{ 
  22.             OwnerType:    blder.forInput.object, 
  23.             IsController: true
  24.         } 
  25.         allPredicates := append([]predicate.Predicate(nil), blder.globalPredicates...) 
  26.         allPredicates = append(allPredicates, own.predicates...) 
  27.         if err := blder.ctrl.Watch(src, hdler, allPredicates...); err != nil { 
  28.             return err 
  29.         } 
  30.     } 
  31.  
  32.     // Do the watch requests 
  33.     for _, w := range blder.watchesInput { 
  34.         allPredicates := append([]predicate.Predicate(nil), blder.globalPredicates...) 
  35.         allPredicates = append(allPredicates, w.predicates...) 
  36.  
  37.         // If the source of this watch is of type *source.Kind, project it. 
  38.         if srckind, ok := w.src.(*source.Kind); ok { 
  39.             typeForSrc, err := blder.project(srckind.Type, w.objectProjection) 
  40.             if err != nil { 
  41.                 return err 
  42.             } 
  43.             srckind.Type = typeForSrc 
  44.         } 
  45.  
  46.         if err := blder.ctrl.Watch(w.src, w.eventhandler, allPredicates...); err != nil { 
  47.             return err 
  48.         } 
  49.     } 
  50.     return nil 

Watch 主要是監(jiān)聽我們想要的資源變化,blder.ctrl.Watch(src, hdler, allPredicates...)通過過濾源事件的變化,allPredicates是過濾器,只有所有的過濾器都返回 true 時(shí),才會(huì)將事件傳遞給 EventHandler hdler,這里會(huì)將 Handler 注冊(cè)到 Informer 上

啟動(dòng)

  1. func (cm *controllerManager) Start(ctx context.Context) (err error) { 
  2.     cm.internalCtx, cm.internalCancel = context.WithCancel(ctx) 
  3.  
  4.     // 這個(gè)用來表示所有的協(xié)程都已經(jīng)退出了, 
  5.     stopComplete := make(chan struct{}) 
  6.     defer close(stopComplete) 
  7.      
  8.   // ...... 
  9.  
  10.     // 用于保存錯(cuò)誤 
  11.     cm.errChan = make(chan error) 
  12.  
  13.     // 如果需要 metric 就啟動(dòng) metric 服務(wù) 
  14.     if cm.metricsListener != nil { 
  15.         go cm.serveMetrics() 
  16.     } 
  17.  
  18.     // 啟動(dòng)健康檢查服務(wù) 
  19.     if cm.healthProbeListener != nil { 
  20.         go cm.serveHealthProbes() 
  21.     } 
  22.  
  23.    
  24.     go cm.startNonLeaderElectionRunnables() 
  25.  
  26.     go func() { 
  27.         if cm.resourceLock != nil { 
  28.             err := cm.startLeaderElection() 
  29.             if err != nil { 
  30.                 cm.errChan <- err 
  31.             } 
  32.         } else { 
  33.             // Treat not having leader election enabled the same as being elected. 
  34.             close(cm.elected) 
  35.             go cm.startLeaderElectionRunnables() 
  36.         } 
  37.     }() 
  38.  
  39.   // 判斷是否需要退出 
  40.     select { 
  41.     case <-ctx.Done(): 
  42.         // We are done 
  43.         return nil 
  44.     case err := <-cm.errChan: 
  45.         // Error starting or running a runnable 
  46.         return err 
  47.     } 

無論是不是 leader 最后都會(huì)使用 startRunnable 啟動(dòng) Controller

  1. func (cm *controllerManager) startNonLeaderElectionRunnables() { 
  2.     cm.mu.Lock() 
  3.     defer cm.mu.Unlock() 
  4.  
  5.     cm.waitForCache(cm.internalCtx) 
  6.  
  7.     // Start the non-leaderelection Runnables after the cache has synced 
  8.     for _, c := range cm.nonLeaderElectionRunnables { 
  9.         // Controllers block, but we want to return an error if any have an error starting. 
  10.         // Write any Start errors to a channel so we can return them 
  11.         cm.startRunnable(c) 
  12.     } 

實(shí)際上是調(diào)用了 Controller 的 Start方法

  1. // Start implements controller.Controller 
  2. func (c *Controller) Start(ctx context.Context) error { 
  3.  
  4.   // Controller 只能被執(zhí)行一次 
  5.     c.mu.Lock() 
  6.     if c.Started { 
  7.         return errors.New("controller was started more than once. This is likely to be caused by being added to a manager multiple times"
  8.     } 
  9.  
  10.     // Set the internal context. 
  11.     c.ctx = ctx 
  12.  
  13.   // 獲取隊(duì)列 
  14.     c.Queue = c.MakeQueue() 
  15.     defer c.Queue.ShutDown() 
  16.  
  17.     err := func() error { 
  18.         defer c.mu.Unlock() 
  19.  
  20.         defer utilruntime.HandleCrash() 
  21.  
  22.         // 嘗試等待緩存 
  23.         for _, watch := range c.startWatches { 
  24.             c.Log.Info("Starting EventSource""source", watch.src) 
  25.             if err := watch.src.Start(ctx, watch.handler, c.Queue, watch.predicates...); err != nil { 
  26.                 return err 
  27.             } 
  28.         } 
  29.  
  30.         // 啟動(dòng) Controller 
  31.         c.Log.Info("Starting Controller"
  32.  
  33.      
  34.         for _, watch := range c.startWatches { 
  35.             syncingSource, ok := watch.src.(source.SyncingSource) 
  36.             if !ok { 
  37.                 continue 
  38.             } 
  39.             if err := syncingSource.WaitForSync(ctx); err != nil { 
  40.                 // This code is unreachable in case of kube watches since WaitForCacheSync will never return an error 
  41.                 // Leaving it here because that could happen in the future 
  42.                 err := fmt.Errorf("failed to wait for %s caches to sync: %w", c.Name, err) 
  43.                 c.Log.Error(err, "Could not wait for Cache to sync"
  44.                 return err 
  45.             } 
  46.         } 
  47.  
  48.         // All the watches have been started, we can reset the local slice. 
  49.         // 
  50.         // We should never hold watches more than necessary, each watch source can hold a backing cache, 
  51.         // which won't be garbage collected if we hold a reference to it. 
  52.         c.startWatches = nil 
  53.  
  54.         if c.JitterPeriod == 0 { 
  55.             c.JitterPeriod = 1 * time.Second 
  56.         } 
  57.  
  58.         // Launch workers to process resources 
  59.         c.Log.Info("Starting workers""worker count", c.MaxConcurrentReconciles) 
  60.         ctrlmetrics.WorkerCount.WithLabelValues(c.Name). 
  61.                     Set(float64(c.MaxConcurrentReconciles)) 
  62.         for i := 0; i < c.MaxConcurrentReconciles; i++ { 
  63.             go wait.UntilWithContext(ctx, func(ctx context.Context) { 
  64.                 // 查詢隊(duì)列中有沒有關(guān)注的事件,有的話就觸發(fā)我們的 reconcile 邏輯 
  65.                 for c.processNextWorkItem(ctx) { 
  66.                 } 
  67.             }, c.JitterPeriod) 
  68.         } 
  69.  
  70.         c.Started = true 
  71.         return nil 
  72.     }() 
  73.     if err != nil { 
  74.         return err 
  75.     } 
  76.  
  77.     <-ctx.Done() 
  78.     c.Log.Info("Stopping workers"
  79.     return nil 
  80.  
  81. // attempt to process it, by calling the reconcileHandler. 
  82. func (c *Controller) processNextWorkItem(ctx context.Context) bool { 
  83.     obj, shutdown := c.Queue.Get() 
  84.     if shutdown { 
  85.         // Stop working 
  86.         return false 
  87.     } 
  88.  
  89.     // We call Done here so the workqueue knows we have finished 
  90.     // processing this item. We also must remember to call Forget if we 
  91.     // do not want this work item being re-queued. For example, we do 
  92.     // not call Forget if a transient error occurs, instead the item is 
  93.     // put back on the workqueue and attempted again after a back-off 
  94.     // period. 
  95.     defer c.Queue.Done(obj) 
  96.  
  97.     ctrlmetrics.ActiveWorkers.WithLabelValues(c.Name).Add(1) 
  98.     defer ctrlmetrics.ActiveWorkers.WithLabelValues(c.Name).Add(-1) 
  99.  
  100.     c.reconcileHandler(ctx, obj) 
  101.     return true 

總結(jié)

Reconcile 方法的觸發(fā)是通過 Cache 中的 Informer 獲取到資源的變更事件,然后再通過生產(chǎn)者消費(fèi)者的模式觸發(fā)我們自己實(shí)現(xiàn)的 Reconcile 方法的。

Kubebuilder 是一個(gè)非常好用的 Operator 開發(fā)框架,不僅極大的簡化了 Operator 的開發(fā)過程,并且充分的利用了 go interface 的特性留下了足夠的擴(kuò)展性,這個(gè)我們可以學(xué)習(xí),如果我們的業(yè)務(wù)代碼開發(fā)框架能夠做到這個(gè)地步,我覺得也就不錯(cuò)了

參考文獻(xiàn)

架構(gòu)圖 https://master.book.kubebuilder.io/architecture.html?

本文轉(zhuǎn)載自微信公眾號(hào)「mohuishou」,可以通過以下二維碼關(guān)注。轉(zhuǎn)載本文請(qǐng)聯(lián)系mohuishou公眾號(hào)。

原文鏈接:https://lailin.xyz/post/operator-09-kubebuilder-code.html

 

責(zé)任編輯:武曉燕 來源: mohuishou博客
相關(guān)推薦

2016-09-22 15:50:38

JavascriptRedux源碼解析

2021-09-26 08:35:17

Android控件寬高

2021-05-17 05:51:31

KubeBuilderOperator測(cè)試

2021-05-18 05:40:27

kubebuilderwebhook進(jìn)階

2019-12-23 09:13:11

Python數(shù)據(jù)語言

2021-09-05 07:35:58

lifecycleAndroid組件原理

2011-03-23 10:30:01

LAMPApache源碼

2022-04-06 14:55:45

Harmony同步機(jī)制鴻蒙

2021-05-12 06:18:19

KubeBuilderOperatork8s

2021-09-02 07:00:01

Glide流程Android

2021-10-20 07:18:50

開源輕量級(jí)緩存

2021-08-28 07:48:04

AndroidActivityRecActivitySta

2016-12-09 19:21:14

2014-08-26 11:11:57

AsyncHttpCl源碼分析

2021-05-16 10:52:58

kubebuilderstatus event

2011-03-15 11:33:18

iptables

2021-08-12 16:28:10

AndroidHandleLooper

2021-09-05 17:22:08

Strview.js工具js

2011-05-26 10:05:48

MongoDB

2021-09-09 06:55:43

AndroidViewDragHel原理
點(diǎn)贊
收藏

51CTO技術(shù)棧公眾號(hào)