Kubernetes-apiServer源码深度分析(九)aggregation Server

785 阅读8分钟

开启掘金成长之旅!这是我参与「掘金日新计划 · 12 月更文挑战」的第11天,点击查看活动详情

记得看代码中的注释哈,理解都在里面 源码基于v1.24

aggregation Server 使得你可以通过编写和部署你自己的 API 服务器来为定制资源提供特殊的实现

aggregation Server的引入

通常,Kubernetes API 中的每个资源都需要处理 REST 请求和管理对象持久性存储的代码。 Kubernetes API 主服务器能够处理诸如 pods 和 services 这些内置资源,也可以 按通用的方式通过 CRD 来处理定制资源。

聚合服务 aggregation Server 使得你可以通过编写和部署你自己的 API 服务器来为定制资源提供特殊的实现。 主 API 服务器将针对你要处理的定制资源的请求全部委托给你自己的 API 服务器来处理,同时将这些资源 提供给其所有客户端。

APIService-Aggregator的核心API Object image.png

aggregation Server的配置

func createAggregatorConfig(
   kubeAPIServerConfig genericapiserver.Config,
   commandOptions *options.ServerRunOptions,
   externalInformers kubeexternalinformers.SharedInformerFactory,
   serviceResolver aggregatorapiserver.ServiceResolver,
   proxyTransport *http.Transport,
   pluginInitializers []admission.PluginInitializer,
) (*aggregatorapiserver.Config, error) {
   // make a shallow copy to let us twiddle a few things
   // most of the config actually remains the same.  We only need to mess with a couple items related to the particulars of the aggregator
   genericConfig := kubeAPIServerConfig
   genericConfig.PostStartHooks = map[string]genericapiserver.PostStartHookConfigEntry{}
   genericConfig.RESTOptionsGetter = nil
   // prevent generic API server from installing the OpenAPI handler. Aggregator server
   // has its own customized OpenAPI handler.
   genericConfig.SkipOpenAPIInstallation = true

   if utilfeature.DefaultFeatureGate.Enabled(genericfeatures.StorageVersionAPI) &&
      utilfeature.DefaultFeatureGate.Enabled(genericfeatures.APIServerIdentity) {

      genericConfig.BuildHandlerChainFunc = genericapiserver.BuildHandlerChainWithStorageVersionPrecondition
   }

   // override genericConfig.AdmissionControl with kube-aggregator's scheme,
   // because aggregator apiserver should use its own scheme to convert its own resources.
   err := commandOptions.Admission.ApplyTo(
      &genericConfig,
      externalInformers,
      genericConfig.LoopbackClientConfig,
      utilfeature.DefaultFeatureGate,
      pluginInitializers...)
   if err != nil {
      return nil, err
   }

   // copy the etcd options so we don't mutate originals.
   etcdOptions := *commandOptions.Etcd
   etcdOptions.StorageConfig.Paging = utilfeature.DefaultFeatureGate.Enabled(genericfeatures.APIListChunking)
   etcdOptions.StorageConfig.Codec = aggregatorscheme.Codecs.LegacyCodec(v1.SchemeGroupVersion, v1beta1.SchemeGroupVersion)
   etcdOptions.StorageConfig.EncodeVersioner = runtime.NewMultiGroupVersioner(v1.SchemeGroupVersion, schema.GroupKind{Group: v1beta1.GroupName})
   genericConfig.RESTOptionsGetter = &genericoptions.SimpleRestOptionsFactory{Options: etcdOptions}

   // override MergedResourceConfig with aggregator defaults and registry
   if err := commandOptions.APIEnablement.ApplyTo(
      &genericConfig,
      aggregatorapiserver.DefaultAPIResourceConfigSource(),
      aggregatorscheme.Scheme); err != nil {
      return nil, err
   }

   aggregatorConfig := &aggregatorapiserver.Config{
      GenericConfig: &genericapiserver.RecommendedConfig{
         Config:                genericConfig,
         SharedInformerFactory: externalInformers,
      },
      ExtraConfig: aggregatorapiserver.ExtraConfig{
         ProxyClientCertFile:       commandOptions.ProxyClientCertFile,
         ProxyClientKeyFile:        commandOptions.ProxyClientKeyFile,
         ServiceResolver:           serviceResolver,
         ProxyTransport:            proxyTransport,
         RejectForwardingRedirects: commandOptions.AggregatorRejectForwardingRedirects,
      },
   }

   // we need to clear the poststarthooks so we don't add them multiple times to all the servers (that fails)
   aggregatorConfig.GenericConfig.PostStartHooks = map[string]genericapiserver.PostStartHookConfigEntry{}

   return aggregatorConfig, nil
}

流程解析如下图

image.png

aggregation Server的创建

func createAggregatorServer(aggregatorConfig *aggregatorapiserver.Config, delegateAPIServer genericapiserver.DelegationTarget, apiExtensionInformers apiextensionsinformers.SharedInformerFactory) (*aggregatorapiserver.APIAggregator, error) {
   aggregatorServer, err := aggregatorConfig.Complete().NewWithDelegate(delegateAPIServer)
   if err != nil {
      return nil, err
   }

   // create controllers for auto-registration
   apiRegistrationClient, err := apiregistrationclient.NewForConfig(aggregatorConfig.GenericConfig.LoopbackClientConfig)
   if err != nil {
      return nil, err
   }
   autoRegistrationController := autoregister.NewAutoRegisterController(aggregatorServer.APIRegistrationInformers.Apiregistration().V1().APIServices(), apiRegistrationClient)
   apiServices := apiServicesToRegister(delegateAPIServer, autoRegistrationController)
   crdRegistrationController := crdregistration.NewCRDRegistrationController(
      apiExtensionInformers.Apiextensions().V1().CustomResourceDefinitions(),
      autoRegistrationController)

   err = aggregatorServer.GenericAPIServer.AddPostStartHook("kube-apiserver-autoregistration", func(context genericapiserver.PostStartHookContext) error {
      go crdRegistrationController.Run(5, context.StopCh)
      go func() {
         if aggregatorConfig.GenericConfig.MergedResourceConfig.ResourceEnabled(apiextensionsv1.SchemeGroupVersion.WithResource("customresourcedefinitions")) {
            crdRegistrationController.WaitForInitialSync()
         }
         autoRegistrationController.Run(5, context.StopCh)
      }()
      return nil
   })
   if err != nil {
      return nil, err
   }

   err = aggregatorServer.GenericAPIServer.AddBootSequenceHealthChecks(
      makeAPIServiceAvailableHealthCheck(
         "autoregister-completion",
         apiServices,
         aggregatorServer.APIRegistrationInformers.Apiregistration().V1().APIServices(),
      ),
   )
   if err != nil {
      return nil, err
   }

   return aggregatorServer, nil
}

流程解析如下图 image.png aggregatorServer是怎么创建的呢?

func (c completedConfig) NewWithDelegate(delegationTarget genericapiserver.DelegationTarget) (*APIAggregator, error) {
   genericServer, err := c.GenericConfig.New("kube-aggregator", delegationTarget)
   if err != nil {
      return nil, err
   }

   apiregistrationClient, err := clientset.NewForConfig(c.GenericConfig.LoopbackClientConfig)
   if err != nil {
      return nil, err
   }
   informerFactory := informers.NewSharedInformerFactory(
      apiregistrationClient,
      5*time.Minute, // this is effectively used as a refresh interval right now.  Might want to do something nicer later on.
   )

/*
当APIServiceRegistrationController完成“安装”所有已知的apisservices时,关闭apiserviceRegistrationControllerInitiated。
*/
   apiServiceRegistrationControllerInitiated := make(chan struct{})
   if err := genericServer.RegisterMuxAndDiscoveryCompleteSignal("APIServiceRegistrationControllerInitiated", apiServiceRegistrationControllerInitiated); err != nil {
      return nil, err
   }

   s := &APIAggregator{
      GenericAPIServer:           genericServer,
      delegateHandler:            delegationTarget.UnprotectedHandler(),
      proxyTransport:             c.ExtraConfig.ProxyTransport,
      proxyHandlers:              map[string]*proxyHandler{},
      handledGroups:              sets.String{},
      lister:                     informerFactory.Apiregistration().V1().APIServices().Lister(),
      APIRegistrationInformers:   informerFactory,
      serviceResolver:            c.ExtraConfig.ServiceResolver,
      openAPIConfig:              c.GenericConfig.OpenAPIConfig,
      openAPIV3Config:            c.GenericConfig.OpenAPIV3Config,
      egressSelector:             c.GenericConfig.EgressSelector,
      proxyCurrentCertKeyContent: func() (bytes []byte, bytes2 []byte) { return nil, nil },
      rejectForwardingRedirects:  c.ExtraConfig.RejectForwardingRedirects,
   }

   // used later  to filter the served resource by those that have expired.
   resourceExpirationEvaluator, err := genericapiserver.NewResourceExpirationEvaluator(*c.GenericConfig.Version)
   if err != nil {
      return nil, err
   }

   apiGroupInfo := apiservicerest.NewRESTStorage(c.GenericConfig.MergedResourceConfig, c.GenericConfig.RESTOptionsGetter, resourceExpirationEvaluator.ShouldServeForVersion(1, 22))
   if err := s.GenericAPIServer.InstallAPIGroup(&apiGroupInfo); err != nil {
      return nil, err
   }

   enabledVersions := sets.NewString()
   for v := range apiGroupInfo.VersionedResourcesStorageMap {
      enabledVersions.Insert(v)
   }
   if !enabledVersions.Has(v1.SchemeGroupVersion.Version) {
      return nil, fmt.Errorf("API group/version %s must be enabled", v1.SchemeGroupVersion.String())
   }

   apisHandler := &apisHandler{
      codecs:         aggregatorscheme.Codecs,
      lister:         s.lister,
      discoveryGroup: discoveryGroup(enabledVersions),
   }
   s.GenericAPIServer.Handler.NonGoRestfulMux.Handle("/apis", apisHandler)
   s.GenericAPIServer.Handler.NonGoRestfulMux.UnlistedHandle("/apis/", apisHandler)

   apiserviceRegistrationController := NewAPIServiceRegistrationController(informerFactory.Apiregistration().V1().APIServices(), s)
   if len(c.ExtraConfig.ProxyClientCertFile) > 0 && len(c.ExtraConfig.ProxyClientKeyFile) > 0 {
      aggregatorProxyCerts, err := dynamiccertificates.NewDynamicServingContentFromFiles("aggregator-proxy-cert", c.ExtraConfig.ProxyClientCertFile, c.ExtraConfig.ProxyClientKeyFile)
      if err != nil {
         return nil, err
      }
      // We are passing the context to ProxyCerts.RunOnce as it needs to implement RunOnce(ctx) however the
      // context is not used at all. So passing a empty context shouldn't be a problem
      ctx := context.TODO()
      if err := aggregatorProxyCerts.RunOnce(ctx); err != nil {
         return nil, err
      }
      aggregatorProxyCerts.AddListener(apiserviceRegistrationController)
      s.proxyCurrentCertKeyContent = aggregatorProxyCerts.CurrentCertKeyContent

      s.GenericAPIServer.AddPostStartHookOrDie("aggregator-reload-proxy-client-cert", func(postStartHookContext genericapiserver.PostStartHookContext) error {
         // generate a context  from stopCh. This is to avoid modifying files which are relying on apiserver
         // TODO: See if we can pass ctx to the current method
         ctx, cancel := context.WithCancel(context.Background())
         go func() {
            select {
            case <-postStartHookContext.StopCh:
               cancel() // stopCh closed, so cancel our context
            case <-ctx.Done():
            }
         }()
         go aggregatorProxyCerts.Run(ctx, 1)
         return nil
      })
   }

   availableController, err := statuscontrollers.NewAvailableConditionController(
      informerFactory.Apiregistration().V1().APIServices(),
      c.GenericConfig.SharedInformerFactory.Core().V1().Services(),
      c.GenericConfig.SharedInformerFactory.Core().V1().Endpoints(),
      apiregistrationClient.ApiregistrationV1(),
      c.ExtraConfig.ProxyTransport,
      (func() ([]byte, []byte))(s.proxyCurrentCertKeyContent),
      s.serviceResolver,
      c.GenericConfig.EgressSelector,
   )
   if err != nil {
      return nil, err
   }

   s.GenericAPIServer.AddPostStartHookOrDie("start-kube-aggregator-informers", func(context genericapiserver.PostStartHookContext) error {
      informerFactory.Start(context.StopCh)
      c.GenericConfig.SharedInformerFactory.Start(context.StopCh)
      return nil
   })
   s.GenericAPIServer.AddPostStartHookOrDie("apiservice-registration-controller", func(context genericapiserver.PostStartHookContext) error {
      go apiserviceRegistrationController.Run(context.StopCh, apiServiceRegistrationControllerInitiated)
      select {
      case <-context.StopCh:
      case <-apiServiceRegistrationControllerInitiated:
      }

      return nil
   })
   s.GenericAPIServer.AddPostStartHookOrDie("apiservice-status-available-controller", func(context genericapiserver.PostStartHookContext) error {
      // if we end up blocking for long periods of time, we may need to increase workers.
      go availableController.Run(5, context.StopCh)
      return nil
   })

   if utilfeature.DefaultFeatureGate.Enabled(genericfeatures.StorageVersionAPI) &&
      utilfeature.DefaultFeatureGate.Enabled(genericfeatures.APIServerIdentity) {
      // Spawn a goroutine in aggregator apiserver to update storage version for
      // all built-in resources
      s.GenericAPIServer.AddPostStartHookOrDie(StorageVersionPostStartHookName, func(hookContext genericapiserver.PostStartHookContext) error {
         // Wait for apiserver-identity to exist first before updating storage
         // versions, to avoid storage version GC accidentally garbage-collecting
         // storage versions.
         kubeClient, err := kubernetes.NewForConfig(hookContext.LoopbackClientConfig)
         if err != nil {
            return err
         }
         if err := wait.PollImmediateUntil(100*time.Millisecond, func() (bool, error) {
            _, err := kubeClient.CoordinationV1().Leases(metav1.NamespaceSystem).Get(
               context.TODO(), s.GenericAPIServer.APIServerID, metav1.GetOptions{})
            if apierrors.IsNotFound(err) {
               return false, nil
            }
            if err != nil {
               return false, err
            }
            return true, nil
         }, hookContext.StopCh); err != nil {
            return fmt.Errorf("failed to wait for apiserver-identity lease %s to be created: %v",
               s.GenericAPIServer.APIServerID, err)
         }
         go wait.PollImmediateUntil(10*time.Minute, func() (bool, error) {
 s.GenericAPIServer.StorageVersionManager.UpdateStorageVersions(hookContext.LoopbackClientConfig, s.GenericAPIServer.APIServerID)
            return false, nil
         }, hookContext.StopCh)
/*
所有 apiservers (aggregator-apiserver, cube-apiserver, apiextensions-apiserver)//共享相同的通用apisserver配置。当通用apisserver安装api时,使用相同的StorageVersion管理器//注册所有内置资源。
*/
         wait.PollImmediateUntil(1*time.Second, func() (bool, error) {
            return s.GenericAPIServer.StorageVersionManager.Completed(), nil
         }, hookContext.StopCh)
         return nil
      })
   }

   return s, nil
}

流程解析如下图

image.png

Run

在post start hook中去启动OpenAPl Controller,制作一个OpenAPI Controller,观测各个 Aggregated Server所支持的API的变化,然 后更新Aggregator自己的OpenAPl Spec

func (s *APIAggregator) PrepareRun() (preparedAPIAggregator, error) {
   // add post start hook before generic PrepareRun in order to be before /healthz installation
   if s.openAPIConfig != nil {
      s.GenericAPIServer.AddPostStartHookOrDie("apiservice-openapi-controller", func(context genericapiserver.PostStartHookContext) error {
         go s.openAPIAggregationController.Run(context.StopCh)
         return nil
      })
   }

   if s.openAPIV3Config != nil && utilfeature.DefaultFeatureGate.Enabled(genericfeatures.OpenAPIV3) {
      s.GenericAPIServer.AddPostStartHookOrDie("apiservice-openapiv3-controller", func(context genericapiserver.PostStartHookContext) error {
         go s.openAPIV3AggregationController.Run(context.StopCh)
         return nil
      })
   }

   prepared := s.GenericAPIServer.PrepareRun()

   // delay OpenAPI setup until the delegate had a chance to setup their OpenAPI handlers
   if s.openAPIConfig != nil {
      specDownloader := openapiaggregator.NewDownloader()
      openAPIAggregator, err := openapiaggregator.BuildAndRegisterAggregator(
         &specDownloader,
         s.GenericAPIServer.NextDelegate(),
         s.GenericAPIServer.Handler.GoRestfulContainer.RegisteredWebServices(),
         s.openAPIConfig,
         s.GenericAPIServer.Handler.NonGoRestfulMux)
      if err != nil {
         return preparedAPIAggregator{}, err
      }
      s.openAPIAggregationController = openapicontroller.NewAggregationController(&specDownloader, openAPIAggregator)
   }

   if s.openAPIV3Config != nil && utilfeature.DefaultFeatureGate.Enabled(genericfeatures.OpenAPIV3) {
      specDownloaderV3 := openapiv3aggregator.NewDownloader()
      openAPIV3Aggregator, err := openapiv3aggregator.BuildAndRegisterAggregator(
         specDownloaderV3,
         s.GenericAPIServer.NextDelegate(),
         s.GenericAPIServer.Handler.NonGoRestfulMux)
      if err != nil {
         return preparedAPIAggregator{}, err
      }
      s.openAPIV3AggregationController = openapiv3controller.NewAggregationController(openAPIV3Aggregator)
   }

   return preparedAPIAggregator{APIAggregator: s, runnable: prepared}, nil
}

每一个ApiServer被创建出来的时候会调用AddAPIServer

func (s *APIAggregator) AddAPIService(apiService *v1.APIService) error {
   // if the proxyHandler already exists, it needs to be updated. The aggregation bits do not
   // since they are wired against listers because they require multiple resources to respond
   if proxyHandler, exists := s.proxyHandlers[apiService.Name]; exists {
      proxyHandler.updateAPIService(apiService)
      if s.openAPIAggregationController != nil {
         s.openAPIAggregationController.UpdateAPIService(proxyHandler, apiService)
      }
      if s.openAPIV3AggregationController != nil {
         s.openAPIV3AggregationController.UpdateAPIService(proxyHandler, apiService)
      }
      return nil
   }

   proxyPath := "/apis/" + apiService.Spec.Group + "/" + apiService.Spec.Version
   // v1. is a special case for the legacy API.  It proxies to a wider set of endpoints.
   if apiService.Name == legacyAPIServiceName {
      proxyPath = "/api"
   }

   // register the proxy handler
   proxyHandler := &proxyHandler{
      localDelegate:              s.delegateHandler,
      proxyCurrentCertKeyContent: s.proxyCurrentCertKeyContent,
      proxyTransport:             s.proxyTransport,
      serviceResolver:            s.serviceResolver,
      egressSelector:             s.egressSelector,
      rejectForwardingRedirects:  s.rejectForwardingRedirects,
   }
   proxyHandler.updateAPIService(apiService)
   if s.openAPIAggregationController != nil {
      s.openAPIAggregationController.AddAPIService(proxyHandler, apiService)
   }
   if s.openAPIV3AggregationController != nil {
      s.openAPIV3AggregationController.AddAPIService(proxyHandler, apiService)
   }
   s.proxyHandlers[apiService.Name] = proxyHandler
   s.GenericAPIServer.Handler.NonGoRestfulMux.Handle(proxyPath, proxyHandler)
   s.GenericAPIServer.Handler.NonGoRestfulMux.UnlistedHandlePrefix(proxyPath+"/", proxyHandler)

   // if we're dealing with the legacy group, we're done here
   if apiService.Name == legacyAPIServiceName {
      return nil
   }

   // if we've already registered the path with the handler, we don't want to do it again.
   if s.handledGroups.Has(apiService.Spec.Group) {
      return nil
   }

   // it's time to register the group aggregation endpoint
   groupPath := "/apis/" + apiService.Spec.Group
   groupDiscoveryHandler := &apiGroupHandler{
      codecs:    aggregatorscheme.Codecs,
      groupName: apiService.Spec.Group,
      lister:    s.lister,
      delegate:  s.delegateHandler,
   }
   // aggregation is protected
   s.GenericAPIServer.Handler.NonGoRestfulMux.Handle(groupPath, groupDiscoveryHandler)
   s.GenericAPIServer.Handler.NonGoRestfulMux.UnlistedHandle(groupPath+"/", groupDiscoveryHandler)
   s.handledGroups.Insert(apiService.Spec.Group)
   return nil
}

func (r *proxyHandler) ServeHTTP(w http.ResponseWriter, req *http.Request) {
   value := r.handlingInfo.Load()
   if value == nil {
      r.localDelegate.ServeHTTP(w, req)
      return
   }
   handlingInfo := value.(proxyHandlingInfo)
   if handlingInfo.local {
      if r.localDelegate == nil {
         http.Error(w, "", http.StatusNotFound)
         return
      }
      r.localDelegate.ServeHTTP(w, req)
      return
   }

   if !handlingInfo.serviceAvailable {
      proxyError(w, req, "service unavailable", http.StatusServiceUnavailable)
      return
   }

   if handlingInfo.transportBuildingError != nil {
      proxyError(w, req, handlingInfo.transportBuildingError.Error(), http.StatusInternalServerError)
      return
   }

   user, ok := genericapirequest.UserFrom(req.Context())
   if !ok {
      proxyError(w, req, "missing user", http.StatusInternalServerError)
      return
   }

   // write a new location based on the existing request pointed at the target service
   location := &url.URL{}
   location.Scheme = "https"
   rloc, err := r.serviceResolver.ResolveEndpoint(handlingInfo.serviceNamespace, handlingInfo.serviceName, handlingInfo.servicePort)
   if err != nil {
      klog.Errorf("error resolving %s/%s: %v", handlingInfo.serviceNamespace, handlingInfo.serviceName, err)
      proxyError(w, req, "service unavailable", http.StatusServiceUnavailable)
      return
   }
   location.Host = rloc.Host
   location.Path = req.URL.Path
   location.RawQuery = req.URL.Query().Encode()

   newReq, cancelFn := newRequestForProxy(location, req)
   defer cancelFn()

   if handlingInfo.proxyRoundTripper == nil {
      proxyError(w, req, "", http.StatusNotFound)
      return
   }

   proxyRoundTripper := handlingInfo.proxyRoundTripper
   upgrade := httpstream.IsUpgradeRequest(req)

   proxyRoundTripper = transport.NewAuthProxyRoundTripper(user.GetName(), user.GetGroups(), user.GetExtra(), proxyRoundTripper)

   // If we are upgrading, then the upgrade path tries to use this request with the TLS config we provide, but it does
   // NOT use the proxyRoundTripper.  It's a direct dial that bypasses the proxyRoundTripper.  This means that we have to
   // attach the "correct" user headers to the request ahead of time.
   if upgrade {
      transport.SetAuthProxyHeaders(newReq, user.GetName(), user.GetGroups(), user.GetExtra())
   }

   handler := proxy.NewUpgradeAwareHandler(location, proxyRoundTripper, true, upgrade, &responder{w: w})
   if r.rejectForwardingRedirects {
      handler.RejectForwardingRedirects = true
   }
   utilflowcontrol.RequestDelegated(req.Context())
   handler.ServeHTTP(w, newReq)
}

流程解析如下图

image.png

CRD和拓展ApiServer的方案对比

CRD 比聚合 API 更容易创建。

CRD聚合 API
无需编程。用户可选择任何语言来实现 CRD 控制器。需要编程,并构建可执行文件和镜像。
无需额外运行服务;CRD 由 API 服务器处理。需要额外创建服务,且该服务可能失效。
一旦 CRD 被创建,不需要持续提供支持。Kubernetes 主控节点升级过程中自动会带入缺陷修复。可能需要周期性地从上游提取缺陷修复并更新聚合 API 服务器。
无需处理 API 的多个版本;例如,当你控制资源的客户端时,你可以更新它使之与 API 同步。你需要处理 API 的多个版本;例如,在开发打算与很多人共享的扩展时。

高级特性与灵活性

聚合 API 可提供更多的高级 API 特性,也可对其他特性实行定制;例如,对存储层进行定制。

特性描述CRD聚合 API
合法性检查帮助用户避免错误,允许你独立于客户端版本演化 API。这些特性对于由很多无法同时更新的客户端的场合。可以。大多数验证可以使用 OpenAPI v3.0 合法性检查 来设定。其他合法性检查操作可以通过添加合法性检查 Webhook来实现。可以,可执行任何合法性检查。
默认值设置同上可以。可通过 OpenAPI v3.0 合法性检查的 default 关键词(自 1.17 正式发布)或更改性(Mutating)Webhook来实现(不过从 etcd 中读取老的对象时不会执行这些 Webhook)。可以。
多版本支持允许通过两个 API 版本同时提供同一对象。可帮助简化类似字段更名这类 API 操作。如果你能控制客户端版本,这一特性将不再重要。可以。可以。
定制存储支持使用具有不同性能模式的存储(例如,要使用时间序列数据库而不是键值存储),或者因安全性原因对存储进行隔离(例如对敏感信息执行加密)。不可以。可以。
定制业务逻辑在创建、读取、更新或删除对象时,执行任意的检查或操作。可以。要使用 Webhook。可以。
支持 scale 子资源允许 HorizontalPodAutoscaler 和 PodDisruptionBudget 这类子系统与你的新资源交互。可以。可以。
支持 status 子资源允许在用户写入 spec 部分而控制器写入 status 部分时执行细粒度的访问控制。允许在对定制资源的数据进行更改时增加对象的代际(Generation);这需要资源对 spec 和 status 部分有明确划分。可以。可以。
其他子资源添加 CRUD 之外的操作,例如 "logs" 或 "exec"。不可以。可以。
strategic-merge-patch新的端点要支持标记了 Content-Type: application/strategic-merge-patch+json 的 PATCH 操作。对于更新既可在本地更改也可在服务器端更改的对象而言是有用的。要了解更多信息,可参见使用 kubectl patch 来更新 API 对象。不可以。可以。
支持协议缓冲区新的资源要支持想要使用协议缓冲区(Protocol Buffer)的客户端。不可以。可以。
OpenAPI Schema是否存在新资源类别的 OpenAPI(Swagger)Schema 可供动态从服务器上读取?是否存在机制确保只能设置被允许的字段以避免用户犯字段拼写错误?是否实施了字段类型检查(换言之,不允许在 string 字段设置 int 值)?可以,依据 OpenAPI v3.0 合法性检查 模式(1.16 中进入正式发布状态)。可以。

Summary

  1. 配置aggregation Server image.png
  2. 创建aggregation Server image.png
  3. aggregator的创建 image.png
  4. 添加APIServer image.png