1
0
Fork 0
mirror of https://github.com/kyverno/kyverno.git synced 2024-12-14 11:57:48 +00:00
kyverno/pkg/clients/dclient/discovery.go
Charles-Edouard Brétéché c96199dee1
chore: move utils/wildcard in ext (#8772)
Signed-off-by: Charles-Edouard Brétéché <charles.edouard@nirmata.com>
2023-10-29 23:59:53 +00:00

450 lines
18 KiB
Go

package dclient
import (
"context"
"fmt"
"strings"
"time"
openapiv2 "github.com/google/gnostic-models/openapiv2"
"github.com/kyverno/kyverno/ext/wildcard"
kubeutils "github.com/kyverno/kyverno/pkg/utils/kube"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime/schema"
"k8s.io/client-go/discovery"
)
// TopLevelApiDescription contains a group/version/resource/subresource reference
type TopLevelApiDescription struct {
schema.GroupVersion
Kind string
Resource string
SubResource string
}
func (gvrs TopLevelApiDescription) GroupVersionResource() schema.GroupVersionResource {
return gvrs.WithResource(gvrs.Resource)
}
func (gvrs TopLevelApiDescription) GroupVersionKind() schema.GroupVersionKind {
return gvrs.WithKind(gvrs.Kind)
}
func (gvrs TopLevelApiDescription) ResourceSubresource() string {
if gvrs.SubResource == "" {
return gvrs.Resource
}
return gvrs.Resource + "/" + gvrs.SubResource
}
func (gvrs TopLevelApiDescription) WithSubResource(subresource string) TopLevelApiDescription {
gvrs.SubResource = subresource
return gvrs
}
// IDiscovery provides interface to mange Kind and GVR mapping
type IDiscovery interface {
FindResources(group, version, kind, subresource string) (map[TopLevelApiDescription]metav1.APIResource, error)
// TODO: there's no mapping from GVK to GVR, this is very error prone
GetGVRFromGVK(schema.GroupVersionKind) (schema.GroupVersionResource, error)
GetGVKFromGVR(schema.GroupVersionResource) (schema.GroupVersionKind, error)
OpenAPISchema() (*openapiv2.Document, error)
CachedDiscoveryInterface() discovery.CachedDiscoveryInterface
}
// apiResourceWithListGV is a wrapper for metav1.APIResource with the group-version of its metav1.APIResourceList
type apiResourceWithListGV struct {
apiResource metav1.APIResource
listGV string
}
// serverResources stores the cachedClient instance for discovery client
type serverResources struct {
cachedClient discovery.CachedDiscoveryInterface
}
// CachedDiscoveryInterface gets the discovery client cache
func (c serverResources) CachedDiscoveryInterface() discovery.CachedDiscoveryInterface {
return c.cachedClient
}
// Poll will keep invalidate the local cache
func (c serverResources) Poll(ctx context.Context, resync time.Duration) {
logger := logger.WithName("Poll")
// start a ticker
ticker := time.NewTicker(resync)
defer func() { ticker.Stop() }()
logger.V(6).Info("starting registered resources sync", "period", resync)
for {
select {
case <-ctx.Done():
logger.Info("stopping registered resources sync")
return
case <-ticker.C:
// set cache as stale
logger.V(6).Info("invalidating local client cache for registered resources")
c.cachedClient.Invalidate()
}
}
}
// OpenAPISchema returns the API server OpenAPI schema document
func (c serverResources) OpenAPISchema() (*openapiv2.Document, error) {
return c.cachedClient.OpenAPISchema()
}
// GetGVRFromGVK get the Group Version Resource from APIVersion and kind
func (c serverResources) GetGVRFromGVK(gvk schema.GroupVersionKind) (schema.GroupVersionResource, error) {
_, _, gvr, err := c.FindResource(gvk.GroupVersion().String(), gvk.Kind)
if err != nil {
logger.Error(err, "schema not found", "gvk", gvk)
return schema.GroupVersionResource{}, err
}
return gvr, nil
}
// GetGVKFromGVR returns the Group Version Kind from Group Version Resource. The groupVersion has to be specified properly
// for example, for corev1.Pod, the groupVersion has to be specified as `v1`, specifying empty groupVersion won't work.
func (c serverResources) GetGVKFromGVR(gvr schema.GroupVersionResource) (schema.GroupVersionKind, error) {
gvk, err := c.findResourceFromResourceName(gvr)
if err == nil {
return gvk, nil
}
if !c.cachedClient.Fresh() {
c.cachedClient.Invalidate()
if gvk, err := c.findResourceFromResourceName(gvr); err == nil {
return gvk, nil
}
}
return schema.GroupVersionKind{}, err
}
// findResourceFromResourceName returns the GVK for the a particular resourceName and groupVersion
func (c serverResources) findResourceFromResourceName(gvr schema.GroupVersionResource) (schema.GroupVersionKind, error) {
_, serverGroupsAndResources, err := c.cachedClient.ServerGroupsAndResources()
if err != nil && !strings.Contains(err.Error(), "Got empty response for") {
if discovery.IsGroupDiscoveryFailedError(err) {
logDiscoveryErrors(err)
} else if isServerCurrentlyUnableToHandleRequest(err) {
logger.V(3).Info("failed to find preferred resource version", "error", err.Error())
} else {
logger.Error(err, "failed to find preferred resource version")
return schema.GroupVersionKind{}, err
}
}
apiResource, err := findResourceFromResourceName(gvr, serverGroupsAndResources)
if err != nil {
return schema.GroupVersionKind{}, err
}
return schema.GroupVersionKind{Group: apiResource.Group, Version: apiResource.Version, Kind: apiResource.Kind}, err
}
// FindResource finds an API resource that matches 'kind'. For finding subresources that have the same kind as the parent
// resource, kind has to be specified as 'ParentKind/SubresourceName'. For matching status subresource of Pod, kind has
// to be specified as `Pod/status`. If the resource is not found and the Cache is not fresh, the cache is invalidated
// and a retry is attempted
func (c serverResources) FindResource(groupVersion string, kind string) (apiResource, parentAPIResource *metav1.APIResource, gvr schema.GroupVersionResource, err error) {
r, pr, gvr, err := c.findResource(groupVersion, kind)
if err == nil {
return r, pr, gvr, nil
}
if !c.cachedClient.Fresh() {
c.cachedClient.Invalidate()
if r, pr, gvr, err = c.findResource(groupVersion, kind); err == nil {
return r, pr, gvr, nil
}
}
return nil, nil, schema.GroupVersionResource{}, err
}
func (c serverResources) FindResources(group, version, kind, subresource string) (map[TopLevelApiDescription]metav1.APIResource, error) {
resources, err := c.findResources(group, version, kind, subresource)
// if no resource was found, we have to force cache invalidation
if err != nil || len(resources) == 0 {
if !c.cachedClient.Fresh() || len(resources) == 0 {
c.cachedClient.Invalidate()
resources, err := c.findResources(group, version, kind, subresource)
if err != nil {
return nil, err
} else if len(resources) == 0 {
return nil, fmt.Errorf("failed to find resource (%s/%s/%s/%s)", group, version, kind, subresource)
}
return resources, err
}
}
return resources, err
}
func (c serverResources) findResources(group, version, kind, subresource string) (map[TopLevelApiDescription]metav1.APIResource, error) {
_, serverGroupsAndResources, err := c.cachedClient.ServerGroupsAndResources()
if err != nil && !strings.Contains(err.Error(), "Got empty response for") {
if discovery.IsGroupDiscoveryFailedError(err) {
logDiscoveryErrors(err)
} else if isServerCurrentlyUnableToHandleRequest(err) {
logger.Error(err, "failed to find preferred resource version")
} else {
logger.Error(err, "failed to find preferred resource version")
return nil, err
}
}
getGVK := func(gv schema.GroupVersion, group, version, kind string) schema.GroupVersionKind {
if group == "" {
group = gv.Group
}
if version == "" {
version = gv.Version
}
return schema.GroupVersionKind{
Group: group,
Version: version,
Kind: kind,
}
}
resources := map[TopLevelApiDescription]metav1.APIResource{}
// first match resouces
for _, list := range serverGroupsAndResources {
gv, err := schema.ParseGroupVersion(list.GroupVersion)
if err != nil {
return nil, err
} else {
for _, resource := range list.APIResources {
if !strings.Contains(resource.Name, "/") {
gvk := getGVK(gv, resource.Group, resource.Version, resource.Kind)
if wildcard.Match(group, gvk.Group) && wildcard.Match(version, gvk.Version) && wildcard.Match(kind, gvk.Kind) {
gvrs := TopLevelApiDescription{
GroupVersion: gv,
Kind: resource.Kind,
Resource: resource.Name,
}
resources[gvrs] = resource
}
}
}
}
}
// second match subresouces if necessary
subresources := map[TopLevelApiDescription]metav1.APIResource{}
if subresource != "" {
for _, list := range serverGroupsAndResources {
for _, resource := range list.APIResources {
for parent := range resources {
if wildcard.Match(parent.Resource+"/"+subresource, resource.Name) {
parts := strings.Split(resource.Name, "/")
subresources[parent.WithSubResource(parts[1])] = resource
break
}
}
}
}
}
if kind == "*" && subresource == "*" {
for key, value := range subresources {
resources[key] = value
}
return resources, nil
} else if subresource != "" {
return subresources, nil
}
return resources, nil
}
func (c serverResources) findResource(groupVersion string, kind string) (apiResource, parentAPIResource *metav1.APIResource,
gvr schema.GroupVersionResource, err error,
) {
serverPreferredResources, _ := c.cachedClient.ServerPreferredResources()
_, serverGroupsAndResources, err := c.cachedClient.ServerGroupsAndResources()
if err != nil && !strings.Contains(err.Error(), "Got empty response for") {
if _, err := schema.ParseGroupVersion(groupVersion); err != nil {
logger.Error(err, "failed to parse group/version", "groupVersion", groupVersion)
return nil, nil, schema.GroupVersionResource{}, err
}
if discovery.IsGroupDiscoveryFailedError(err) {
logDiscoveryErrors(err)
} else if isServerCurrentlyUnableToHandleRequest(err) {
logger.V(3).Info("failed to find preferred resource version", "error", err.Error())
} else {
logger.Error(err, "failed to find preferred resource version")
return nil, nil, schema.GroupVersionResource{}, err
}
}
kindWithoutSubresource, subresource := kubeutils.SplitSubresource(kind)
if subresource != "" {
parentApiResource, _, _, err := c.findResource(groupVersion, kindWithoutSubresource)
if err != nil {
logger.Error(err, "Unable to find parent resource", "kind", kind)
return nil, nil, schema.GroupVersionResource{}, err
}
parentResourceName := parentApiResource.Name
resource, gvr, err := findSubresource(groupVersion, parentResourceName, subresource, kind, serverGroupsAndResources)
return resource, parentApiResource, gvr, err
}
return findResource(groupVersion, kind, serverPreferredResources, serverGroupsAndResources)
}
// findSubresource finds the subresource for the given parent resource, groupVersion and serverResourcesList
func findSubresource(groupVersion, parentResourceName, subresource, kind string, serverResourcesList []*metav1.APIResourceList) (
apiResource *metav1.APIResource, gvr schema.GroupVersionResource, err error,
) {
for _, serverResourceList := range serverResourcesList {
if groupVersion == "" || kubeutils.GroupVersionMatches(groupVersion, serverResourceList.GroupVersion) {
for _, serverResource := range serverResourceList.APIResources {
if serverResource.Name == parentResourceName+"/"+strings.ToLower(subresource) {
logger.V(6).Info("matched API resource to kind", "apiResource", serverResource, "kind", kind)
serverResourceGv := getServerResourceGroupVersion(serverResourceList.GroupVersion, serverResource.Group, serverResource.Version)
gv, _ := schema.ParseGroupVersion(serverResourceGv)
serverResource.Group = gv.Group
serverResource.Version = gv.Version
groupVersionResource := gv.WithResource(serverResource.Name)
logger.V(6).Info("gv with resource", "gvWithResource", groupVersionResource)
return &serverResource, groupVersionResource, nil
}
}
}
}
return nil, schema.GroupVersionResource{}, fmt.Errorf("resource not found for kind %s", kind)
}
// findResource finds an API resource that matches 'groupVersion', 'kind', in the given serverResourcesList
func findResource(groupVersion string, kind string, serverPreferredResources, serverGroupsAndResources []*metav1.APIResourceList) (
apiResource, parentAPIResource *metav1.APIResource, gvr schema.GroupVersionResource, err error,
) {
matchingServerResources := getMatchingServerResources(groupVersion, kind, serverGroupsAndResources)
onlySubresourcePresentInMatchingResources := len(matchingServerResources) > 0
for _, matchingServerResource := range matchingServerResources {
if !kubeutils.IsSubresource(matchingServerResource.apiResource.Name) {
onlySubresourcePresentInMatchingResources = false
break
}
}
if onlySubresourcePresentInMatchingResources {
apiResourceWithListGV := matchingServerResources[0]
matchingServerResource := apiResourceWithListGV.apiResource
logger.V(6).Info("matched API resource to kind", "apiResource", matchingServerResource, "kind", kind)
groupVersionResource := schema.GroupVersionResource{
Resource: matchingServerResource.Name,
Group: matchingServerResource.Group,
Version: matchingServerResource.Version,
}
logger.V(6).Info("gv with resource", "gvWithResource", groupVersionResource)
gv, err := schema.ParseGroupVersion(apiResourceWithListGV.listGV)
if err != nil {
return nil, nil, schema.GroupVersionResource{}, fmt.Errorf("failed to parse group version %s: %v", apiResourceWithListGV.listGV, err)
}
parentAPIResource, err := findResourceFromResourceName(
gv.WithResource(strings.Split(matchingServerResource.Name, "/")[0]),
serverPreferredResources,
)
if err != nil {
return nil, nil, schema.GroupVersionResource{}, fmt.Errorf("failed to find parent resource for subresource %s: %v", matchingServerResource.Name, err)
}
logger.V(6).Info("parent API resource", "parentAPIResource", parentAPIResource)
return &matchingServerResource, parentAPIResource, groupVersionResource, nil
}
if groupVersion == "" && len(matchingServerResources) > 0 {
for _, serverResourceList := range serverPreferredResources {
for _, serverResource := range serverResourceList.APIResources {
serverResourceGv := getServerResourceGroupVersion(serverResourceList.GroupVersion, serverResource.Group, serverResource.Version)
if serverResource.Kind == kind || serverResource.SingularName == kind {
gv, _ := schema.ParseGroupVersion(serverResourceGv)
serverResource.Group = gv.Group
serverResource.Version = gv.Version
groupVersionResource := gv.WithResource(serverResource.Name)
logger.V(6).Info("matched API resource to kind", "apiResource", serverResource, "kind", kind)
return &serverResource, nil, groupVersionResource, nil
}
}
}
} else {
for _, apiResourceWithListGV := range matchingServerResources {
matchingServerResource := apiResourceWithListGV.apiResource
if !kubeutils.IsSubresource(matchingServerResource.Name) {
logger.V(6).Info("matched API resource to kind", "apiResource", matchingServerResource, "kind", kind)
groupVersionResource := schema.GroupVersionResource{
Resource: matchingServerResource.Name,
Group: matchingServerResource.Group,
Version: matchingServerResource.Version,
}
logger.V(6).Info("gv with resource", "groupVersionResource", groupVersionResource)
return &matchingServerResource, nil, groupVersionResource, nil
}
}
}
return nil, nil, schema.GroupVersionResource{}, fmt.Errorf("kind '%s' not found in groupVersion '%s'", kind, groupVersion)
}
// getMatchingServerResources returns a list of API resources that match the given groupVersion and kind
func getMatchingServerResources(groupVersion string, kind string, serverGroupsAndResources []*metav1.APIResourceList) []apiResourceWithListGV {
matchingServerResources := make([]apiResourceWithListGV, 0)
for _, serverResourceList := range serverGroupsAndResources {
for _, serverResource := range serverResourceList.APIResources {
serverResourceGv := getServerResourceGroupVersion(serverResourceList.GroupVersion, serverResource.Group, serverResource.Version)
if groupVersion == "" || kubeutils.GroupVersionMatches(groupVersion, serverResourceGv) {
if serverResource.Kind == kind || serverResource.SingularName == kind {
gv, _ := schema.ParseGroupVersion(serverResourceGv)
serverResource.Group = gv.Group
serverResource.Version = gv.Version
matchingServerResources = append(matchingServerResources, apiResourceWithListGV{apiResource: serverResource, listGV: serverResourceList.GroupVersion})
}
}
}
}
return matchingServerResources
}
// findResourceFromResourceName finds an API resource that matches 'resourceName', in the given serverResourcesList
func findResourceFromResourceName(gvr schema.GroupVersionResource, serverGroupsAndResources []*metav1.APIResourceList) (*metav1.APIResource, error) {
for _, list := range serverGroupsAndResources {
gv, err := schema.ParseGroupVersion(list.GroupVersion)
if err != nil {
return nil, err
}
if gv.Group == gvr.Group && gv.Version == gvr.Version {
for _, resource := range list.APIResources {
if resource.Name == gvr.Resource {
// if the matched resource has group or version set we don't need to copy from the parent list
if resource.Group != "" || resource.Version != "" {
return &resource, nil
}
result := resource.DeepCopy()
result.Group = gv.Group
result.Version = gv.Version
return result, nil
}
}
}
}
return nil, fmt.Errorf("resource %s not found in group %s", gvr.Resource, gvr.GroupVersion())
}
// getServerResourceGroupVersion returns the groupVersion of the serverResource from the apiResourceMetadata
func getServerResourceGroupVersion(apiResourceListGroupVersion, apiResourceGroup, apiResourceVersion string) string {
var serverResourceGroupVersion string
if apiResourceGroup == "" && apiResourceVersion == "" {
serverResourceGroupVersion = apiResourceListGroupVersion
} else {
serverResourceGroupVersion = schema.GroupVersion{
Group: apiResourceGroup,
Version: apiResourceVersion,
}.String()
}
return serverResourceGroupVersion
}