karmada/pkg/search/proxy/store/store.go

289 lines
8.4 KiB
Go

/*
Copyright 2022 The Karmada Authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package store
import (
"context"
"fmt"
"strings"
apierrors "k8s.io/apimachinery/pkg/api/errors"
"k8s.io/apimachinery/pkg/api/meta"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
"k8s.io/apimachinery/pkg/runtime"
"k8s.io/apimachinery/pkg/runtime/schema"
"k8s.io/apimachinery/pkg/watch"
"k8s.io/apiserver/pkg/storage"
"k8s.io/client-go/dynamic"
)
// store implements storage.Interface, Providing Get/Watch/List resources from member clusters.
type store struct {
versioner storage.Versioner
prefix string
// newClientFunc returns a resource client for member cluster apiserver
newClientFunc func() (dynamic.NamespaceableResourceInterface, error)
gvr schema.GroupVersionResource
multiNS *MultiNamespace
}
var _ storage.Interface = &store{}
func newStore(gvr schema.GroupVersionResource, multiNS *MultiNamespace, newClientFunc func() (dynamic.NamespaceableResourceInterface, error), versioner storage.Versioner, prefix string) *store {
return &store{
newClientFunc: newClientFunc,
versioner: versioner,
prefix: prefix,
gvr: gvr,
multiNS: multiNS,
}
}
// Versioner implements storage.Interface.
func (s *store) Versioner() storage.Versioner {
return s.versioner
}
// Get implements storage.Interface.
func (s *store) Get(ctx context.Context, key string, opts storage.GetOptions, objPtr runtime.Object) error {
var namespace, name string
part1, part2 := s.splitKey(key)
if part2 == "" {
// for cluster scope resource, key is /prefix/name. So parts are [name, ""]
name = part1
} else {
// for namespace scope resource, key is /prefix/namespace/name. So parts are [namespace, name]
namespace, name = part1, part2
}
if namespace != metav1.NamespaceAll && !s.multiNS.Contains(namespace) {
return apierrors.NewNotFound(s.gvr.GroupResource(), name)
}
client, err := s.client(namespace)
if err != nil {
return err
}
obj, err := client.Get(ctx, name, convertToMetaV1GetOptions(opts))
if err != nil {
return err
}
unstructuredObj := objPtr.(*unstructured.Unstructured)
obj.DeepCopyInto(unstructuredObj)
return nil
}
// GetList implements storage.Interface.
func (s *store) GetList(ctx context.Context, key string, opts storage.ListOptions, listObj runtime.Object) error {
return s.List(ctx, key, opts, listObj)
}
// List implements storage.Interface.
func (s *store) List(ctx context.Context, key string, opts storage.ListOptions, listObj runtime.Object) error {
// For cluster scope resources, key is /prefix. Parts are ["", ""]
// For namespace scope resources, key is /prefix/namespace. Parts are [namespace, ""]
namespace, _ := s.splitKey(key)
reqNS, objFilter, shortCircuit := filterNS(s.multiNS, namespace)
if shortCircuit {
return nil
}
client, err := s.client(reqNS)
if err != nil {
return err
}
options := convertToMetaV1ListOptions(opts)
objects, err := client.List(ctx, options)
if apierrors.IsNotFound(err) {
return nil
}
if err != nil {
return err
}
if objFilter != nil {
filteredItems := make([]unstructured.Unstructured, 0, len(objects.Items))
for _, obj := range objects.Items {
obj := obj
if objFilter(&obj) {
filteredItems = append(filteredItems, obj)
}
}
objects.Items = filteredItems
}
objects.DeepCopyInto(listObj.(*unstructured.UnstructuredList))
return nil
}
// WatchList implements storage.Interface.
func (s *store) WatchList(ctx context.Context, key string, opts storage.ListOptions) (watch.Interface, error) {
return s.Watch(ctx, key, opts)
}
// Watch implements storage.Interface.
func (s *store) Watch(ctx context.Context, key string, opts storage.ListOptions) (watch.Interface, error) {
// For cluster scope resources, key is /prefix. Parts are ["", ""]
// For namespace scope resources, key is /prefix/namespace. Parts are [namespace, ""]
namespace, _ := s.splitKey(key)
reqNS, objFilter, shortCircuit := filterNS(s.multiNS, namespace)
if shortCircuit {
return watch.NewEmptyWatch(), nil
}
client, err := s.client(reqNS)
if err != nil {
return nil, err
}
options := convertToMetaV1ListOptions(opts)
watcher, err := client.Watch(ctx, options)
if err != nil {
return nil, err
}
if objFilter != nil {
watcher = watch.Filter(watcher, func(in watch.Event) (watch.Event, bool) {
return in, objFilter(in.Object)
})
}
return watcher, nil
}
// Create implements storage.Interface.
func (s *store) Create(context.Context, string, runtime.Object, runtime.Object, uint64) error {
return fmt.Errorf("create is not supported in proxy store")
}
// Delete implements storage.Interface.
func (s *store) Delete(context.Context, string, runtime.Object, *storage.Preconditions, storage.ValidateObjectFunc, runtime.Object) error {
return fmt.Errorf("delete is not supported in proxy store")
}
// GuaranteedUpdate implements storage.Interface.
func (s *store) GuaranteedUpdate(context.Context, string, runtime.Object, bool, *storage.Preconditions, storage.UpdateFunc, runtime.Object) error {
return fmt.Errorf("guaranteedUpdate is not supported in proxy store")
}
// Count implements storage.Interface.
func (s *store) Count(string) (int64, error) {
return 0, fmt.Errorf("count is not supported in proxy store")
}
// RequestWatchProgress implements storage.Interface.
func (s *store) RequestWatchProgress(context.Context) error {
return fmt.Errorf("not implemented")
}
// ReadinessCheck checks if the storage is ready for accepting requests.
// Since store itself does not actually hold the data but only provides
// methods for querying, and the caller will not use this method to detect
// the ready status, so it is not necessary to implement this interface.
func (s *store) ReadinessCheck() error {
return fmt.Errorf("not implemented")
}
func (s *store) client(namespace string) (dynamic.ResourceInterface, error) {
client, err := s.newClientFunc()
if err != nil {
return nil, err
}
if len(namespace) > 0 {
return client.Namespace(namespace), nil
}
return client, nil
}
func (s *store) splitKey(key string) (string, string) {
// a key is like:
// - /prefix
// - /prefix/name
// - /prefix/namespace
// - /prefix/namespace/name
k := strings.TrimPrefix(key, s.prefix)
k = strings.TrimPrefix(k, "/")
parts := strings.SplitN(k, "/", 2)
part0, part1 := parts[0], ""
if len(parts) == 2 {
part1 = parts[1]
}
return part0, part1
}
// filterNS is called before store.List and store.Watch, returns:
//
// reqNS: the namespace request to member clusters
// objFilter: if not nil, using it filter objects from member clusters.
// shortCircuit: return empty to client directly, no need to visit member clusters.
//
// There are these cases:
// 1. Cache all namespaces:
// a) Request NamespaceAll: List all ns, no filter
// b) Request foo ns : List foo ns, no filter
// 2. Cache foo namespace:
// a) Request NamespaceAll: List foo ns, no filter
// b) Request foo ns : List foo ns, no filter
// c) Request bar ns : Return empty
// 3. Cache foo,bar namespace:
// a) Request NamespaceAll: List all ns, filter with foo/bar ns
// b) Request foo ns : List foo ns, no filter
// c) Request baz ns : Return empty
func filterNS(cached *MultiNamespace, request string) (reqNS string, objFilter func(runtime.Object) bool, shortCircuit bool) {
if cached.allNamespaces {
reqNS = request
return
}
if ns, ok := cached.Single(); ok {
if request == metav1.NamespaceAll || request == ns {
reqNS = ns
} else {
shortCircuit = true
}
return
}
if request == metav1.NamespaceAll {
reqNS = metav1.NamespaceAll
objFilter = objectFilter(cached)
} else if cached.Contains(request) {
reqNS = request
} else {
shortCircuit = true
}
return
}
func objectFilter(ns *MultiNamespace) func(o runtime.Object) bool {
return func(o runtime.Object) bool {
accessor, err := meta.Accessor(o)
if err != nil {
return true
}
return ns.Contains(accessor.GetNamespace())
}
}