From cdf2cfdac727fa446ce236aca3b657fda92d1ce9 Mon Sep 17 00:00:00 2001 From: chentao <421224811@qq.com> Date: Mon, 1 Mar 2021 22:48:15 +0800 Subject: [PATCH] add proposal about #162 --- docs/img/proposals/img-20210301001.png | Bin 0 -> 40779 bytes ...-enhancement_of_YurtHub_caching_ability.md | 259 ++++++++++++++++++ 2 files changed, 259 insertions(+) create mode 100644 docs/img/proposals/img-20210301001.png create mode 100644 docs/proposals/20210301-enhancement_of_YurtHub_caching_ability.md diff --git a/docs/img/proposals/img-20210301001.png b/docs/img/proposals/img-20210301001.png new file mode 100644 index 0000000000000000000000000000000000000000..72f7d7e8e9baacca4e7c02f214c4f4705be66cee GIT binary patch literal 40779 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 N$JWXTs<7~i`wu8068-=H literal 0 HcmV?d00001 diff --git a/docs/proposals/20210301-enhancement_of_YurtHub_caching_ability.md b/docs/proposals/20210301-enhancement_of_YurtHub_caching_ability.md new file mode 100644 index 00000000000..0433bf544f1 --- /dev/null +++ b/docs/proposals/20210301-enhancement_of_YurtHub_caching_ability.md @@ -0,0 +1,259 @@ +--- +title: Proposal to enhance the caching ability of YurtHub +authors: + - "@qclc" + - "@GsssC" +reviewers: + - "@rambohe-ch" +creation-date: 2021-03-01 +last-updated: 2021-03-01 +status: provisional +--- + +# Proposal to enhance the caching ability of YurtHub + +## Table of Contents + +- [Title](#title) + - [Table of Contents](#table-of-contents) + - [Summary](#summary) + - [Motivation](#motivation) + - [Goals](#goals) + - [Description of Yurthub's existing cache ability](#Description of Yurthub's existing cache ability) + - [serializerManager](#serializerManager) + - [Problem](#Problem) + - [cacheManager](#cacheManager) + - [Problem](#Problem) + - [Proposal](#proposal) + - [Delete resourceToKindMap and resourceToListKindMap](#Delete resourceToKindMap and resourceToListKindMap) + - [Design detail](#Design detail) + - [Decode the unregistered Custom Resources into Unstructured structure](#Decode the unregistered Custom Resources into Unstructured structure) + - [Design detail](#Design detail) + - [Add unstructuredNegotiatedSerializer](#Add unstructuredNegotiatedSerializer) + - [Determine the resource type based on request.URL and select the appropriate serializer](#Determine the resource type based on request.URL and select the appropriate serializer) + - [Implementation History](#implementation-history) + +## Summary + +YurtHub can currently only cache resources defined in [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62). This proposal mainly tries to put forward and realize a set of scheme, so that YurtHub is no longer limited by resource types, and Custom Resources can be cached. + +## Motivation + +when network between cloud and edge disconnected, if any pod(eg: calico) on the edge node that used some resources(like crd) not in the above map want to run continuously, that is to say, the pod can not restarted successfully because resources(like crd) are not cached by yurt-hub. + +### Goals + +- Delete [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62) so that we can remove the restriction that yurthub can only cache certain resources; +- Decode Custom Resources that are not registered in the scheme into `Unstructured` structures; +- The Custom Resource is distinguished from the core resource based on `request.URL`. The core resource uses the existing serializer and the Custom Resource uses the `unstructuredNegotiatedSerializer`. + +## Description of Yurthub's existing cache ability + +This section briefly describes how Yurthub receives and caches response with resources from Kube-apiserver, mainly involving the CacheManager and SerializerManager modules. Yurthub caches resources, which roughly requires two steps: + +**Step 1:** Decode the byte stream contained in `Response.Body` into `Runtime.Object` type in memory, so that YurtHub can operate the Object; + +**Step 2:** Encode the Runtime.Object type into the corresponding byte stream and save it to the hard disk. + +The limitations of the existing caching ability in YurtHub are mainly in the first step: One is the limitation of [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62); The second is the lack of a serializer to decode and encode Custom Resources. + +### serializerManager + +SerializerManager is used to manage the serializers that decode and encode K8S resources. When SerializerManager is initialized, the structure of the built-in resources in the Client-Go library is registered in the scheme, such as the Pod structure example: + +```go +type Pod struct { + metav1.TypeMeta `json:",inline"` + metav1.ObjectMeta `json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"` + Spec PodSpec `json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"` + Status PodStatus `json:"status,omitempty" protobuf:"bytes,3,opt,name=status"` +} +``` + +Currently Yurthub can only encode and decode resources under [these paths](https://github.com/kubernetes/client-go/blob/master/kubernetes/scheme/register.go): + +```go +admissionregistrationv1 "k8s.io/api/admissionregistration/v1" +admissionregistrationv1beta1 "k8s.io/api/admissionregistration/v1beta1" +appsv1 "k8s.io/api/apps/v1" +appsv1beta1 "k8s.io/api/apps/v1beta1" +appsv1beta2 "k8s.io/api/apps/v1beta2" +auditregistrationv1alpha1 "k8s.io/api/auditregistration/v1alpha1" +authenticationv1 "k8s.io/api/authentication/v1" +authenticationv1beta1 "k8s.io/api/authentication/v1beta1" +authorizationv1 "k8s.io/api/authorization/v1" +authorizationv1beta1 "k8s.io/api/authorization/v1beta1" +autoscalingv1 "k8s.io/api/autoscaling/v1" +autoscalingv2beta1 "k8s.io/api/autoscaling/v2beta1" +autoscalingv2beta2 "k8s.io/api/autoscaling/v2beta2" +batchv1 "k8s.io/api/batch/v1" +batchv1beta1 "k8s.io/api/batch/v1beta1" +batchv2alpha1 "k8s.io/api/batch/v2alpha1" +certificatesv1beta1 "k8s.io/api/certificates/v1beta1" +coordinationv1 "k8s.io/api/coordination/v1" +coordinationv1beta1 "k8s.io/api/coordination/v1beta1" +corev1 "k8s.io/api/core/v1" +discoveryv1alpha1 "k8s.io/api/discovery/v1alpha1" +eventsv1beta1 "k8s.io/api/events/v1beta1" +extensionsv1beta1 "k8s.io/api/extensions/v1beta1" +networkingv1 "k8s.io/api/networking/v1" +networkingv1beta1 "k8s.io/api/networking/v1beta1" +nodev1alpha1 "k8s.io/api/node/v1alpha1" +nodev1beta1 "k8s.io/api/node/v1beta1" +policyv1beta1 "k8s.io/api/policy/v1beta1" +rbacv1 "k8s.io/api/rbac/v1" +rbacv1alpha1 "k8s.io/api/rbac/v1alpha1" +rbacv1beta1 "k8s.io/api/rbac/v1beta1" +schedulingv1 "k8s.io/api/scheduling/v1" +schedulingv1alpha1 "k8s.io/api/scheduling/v1alpha1" +schedulingv1beta1 "k8s.io/api/scheduling/v1beta1" +settingsv1alpha1 "k8s.io/api/settings/v1alpha1" +storagev1 "k8s.io/api/storage/v1" +storagev1alpha1 "k8s.io/api/storage/v1alpha1" +storagev1beta1 "k8s.io/api/storage/v1beta1" +v1 "k8s.io/apimachinery/pkg/apis/meta/v1" +runtime "k8s.io/apimachinery/pkg/runtime" +schema "k8s.io/apimachinery/pkg/runtime/schema" +serializer "k8s.io/apimachinery/pkg/runtime/serializer" +utilruntime "k8s.io/apimachinery/pkg/util/runtime" +``` + +#### Problem + +Because scheme currently only saves the above fixed resources' structures, when YurtHub receives Custom Resources returned from Kube-apiserver, it cannot find the corresponding GO type structure to decode Custom Resources. + +### cacheManager + +CacheManager provides methods for managing resources cached on edge nodes, which are divided into three main functions: + +- Determining whether the response message needs to be cached +- The resource byte stream from Kube-apiserver is decoded into `runtime.Object` and stored in memory. When the YurtHub operation is completed, the object is converted to a byte stream and stored on the hard disk + +- When cloud-edge communication is unhealthy, edge nodes use `QueryCache(...)` to find resources cached locally. + +```go +// CacheManager is an adaptor to cache runtime object data into backend storage +type CacheManager interface { + CacheResponse(ctx context.Context, prc io.ReadCloser, stopCh <-chan struct{}) error + QueryCache(req *http.Request) (runtime.Object, error) + UpdateCacheAgents(agents []string) error + ListCacheAgents() []string + CanCacheFor(req *http.Request) bool +} +``` + +#### Problem + +Since the serializer currently used by YurtHub will lose GVK information when decoding resource objects. So we need to [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62) to obtain the corresponding kind information according to resource name. The two maps have the following three main functions: + +- `CanCacheFor(req *http.Request)` function uses a resourceToKindMap to determine if the response message needs to be cached; + +- `SaveOneObject(...)`, `SaveListObject(...)` and `SaveWatchObject(...)` use resourceToKindMap to obtain the kind information corresponding to the resource name, which is used to cache the response message; + + Because the resolved object does not contain GVK information. But when caching objects, GVK information needs to be set. The above two maps pre-store some resource-to-kind mappings, which can be used to cache resources and retrieve the corresponding kind based on the resource name in the request.URL . + +- The `queryListObject(...)` function uses the resourceToListKindMap member to query the List object + +Due to the above limitations, Yurthub can only cache resources defined in [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62). + +## Proposal + +### Delete [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62) + +Remove the restriction that only certain resources can be cached by removing [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) and [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62). Removing the above restriction requires solving the problem which is preserving the original GVK information while decoding the corresponding resources; + +#### Why the WithoutConversionCodecFactory loses GVK information + +The reason why object misses the field of apiverison and kind is YurtHub using [serializer.WithoutConversionCodecFactory](https://github.com/alibaba/openyurt/blob/7095962687e2666a27d14e436b96ef893b228beb/pkg/yurthub/kubernetes/serializer/serializer.go#L48) as NegotiatedSerializer. Because the WithoutConversionCodecFactory is a CodecFactory that will explicitly ignore requests to perform conversion, the GVK information will be ignored when this WithoutConversionCodecFactory use the decoder (which is this [Decoder](https://github.com/kubernetes/kubernetes/blob/994b5c6cc20bda188ac9bc33217f2dbc7ecf45bb/staging/src/k8s.io/apimachinery/pkg/runtime/helper.go#L256), the following is the old decoder's code). + +```go +// Decode does not do conversion. It removes the gvk during deserialization. +func (d WithoutVersionDecoder) Decode(data []byte, defaults *schema.GroupVersionKind, into Object) (Object, *schema.GroupVersionKind, error) { + obj, gvk, err := d.Decoder.Decode(data, defaults, into) + if obj != nil { + kind := obj.GetObjectKind() + // clearing the gvk is just a convention of a codec + kind.SetGroupVersionKind(schema.GroupVersionKind{}) + } + return obj, gvk, err +} +``` + +#### Design detail + +Define a new `WithVersionCodecFactory` replace the [serializer.WithoutConversionCodecFactory](https://github.com/alibaba/openyurt/blob/7095962687e2666a27d14e436b96ef893b228beb/pkg/yurthub/kubernetes/serializer/serializer.go#L48) as a negotiatedSerializer, which can retain GVK information while decoding resources. Here is part of the WithVersionCodecFactory code + +```go +// WithVersionCodecFactory is a CodecFactory that will explicitly ignore requests to perform conversion. +// It keeps the gvk during deserialization. +// This wrapper is used while code migrates away from using conversion (such as external clients) +type WithVersionCodecFactory struct { + serializer.CodecFactory +} + +// DecoderToVersion returns an decoder that does not do conversion, and keeps the gvk information +func (f WithVersionCodecFactory) DecoderToVersion(serializer runtime.Decoder, _ runtime.GroupVersioner) runtime.Decoder { + //return versioning.NewDefaultingCodecForScheme(s.scheme, nil, decoder, nil, gv) + return WithVersionDecoder{ + Decoder: serializer, + } +} + +// WithVersionDecoder keeps the group version kind of a deserialized object. +type WithVersionDecoder struct { + runtime.Decoder +} + +// Decode does not do conversion. It keeps the gvk during deserialization. +func (d WithVersionDecoder) Decode(data []byte, defaults *schema.GroupVersionKind, into runtime.Object) (runtime.Object, *schema.GroupVersionKind, error) { + obj, gvk, err := d.Decoder.Decode(data, defaults, into) + return obj, gvk, err +} +``` + +### Decode the unregistered Custom Resources into `Unstructured` structure + +Unstructured allows objects that do not have Golang structs registered to be manipulated generically. This can be used to deal with the API objects from a plug-in. + +```go +//Unstructured objects still have functioning TypeMeta features-- kind, version, etc. +type Unstructured struct { + // Object is a JSON compatible map with string, float, int, bool, []interface{}, or + // map[string]interface{} + // children. + Object map[string]interface{} +} +``` + +#### Design detail + +##### Add unstructuredNegotiatedSerializer +On the basis of the existing NegotiatedSerializer increase a new unstructuredNegotiatedSerializer, used to decode the structure of the unregistered Custom Resources. + +```go +type unstructuredNegotiatedSerializer struct { + scheme *runtime.Scheme + typer runtime.ObjectTyper + creator runtime.ObjectCreater +} + +// SerializerManager is responsible for managing *rest.Serializers +type SerializerManager struct { + // NegotiatedSerializer is used for obtaining encoders and decoders for multiple + // supported media types. + NegotiatedSerializer runtime.NegotiatedSerializer + //TO-ADD: use to decode the CR + unstructuredNegotiatedSerializer runtime.NegotiatedSerializer +} +``` +##### Determine the resource type based on request.URL and select the appropriate serializer + +When cache resources, determine resource's type according to the `request.URL`, if the resource type has been registered, use the original serializer, otherwise use the serializer returned by `unstructuredNegotiatedSerializer` . + +![unstructure](../img/proposals/img-20210301001.png) + +## Implementation History + +- [ ] 03/01/2021: Proposed idea. +- [ ] 03/01/2021: Commit the PR about delete [resourceToKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L46) 和 [resourceToListKindMap](https://github.com/openyurtio/openyurt/blob/4d7463a40801c29d09c4f7d10ba46b73cb019915/pkg/yurthub/cachemanager/cache_manager.go#L62) (https://github.com/openyurtio/openyurt/pull/225) +