factory_client_access.go 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178
  1. /*
  2. Copyright 2016 The Kubernetes Authors.
  3. Licensed under the Apache License, Version 2.0 (the "License");
  4. you may not use this file except in compliance with the License.
  5. You may obtain a copy of the License at
  6. http://www.apache.org/licenses/LICENSE-2.0
  7. Unless required by applicable law or agreed to in writing, software
  8. distributed under the License is distributed on an "AS IS" BASIS,
  9. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  10. See the License for the specific language governing permissions and
  11. limitations under the License.
  12. */
  13. // this file contains factories with no other dependencies
  14. package util
  15. import (
  16. "sync"
  17. corev1 "k8s.io/api/core/v1"
  18. "k8s.io/apimachinery/pkg/api/meta"
  19. "k8s.io/cli-runtime/pkg/genericclioptions"
  20. "k8s.io/cli-runtime/pkg/resource"
  21. "k8s.io/client-go/discovery"
  22. "k8s.io/client-go/dynamic"
  23. "k8s.io/client-go/kubernetes"
  24. restclient "k8s.io/client-go/rest"
  25. "k8s.io/client-go/tools/clientcmd"
  26. "k8s.io/kubernetes/pkg/kubectl/cmd/util/openapi"
  27. openapivalidation "k8s.io/kubernetes/pkg/kubectl/cmd/util/openapi/validation"
  28. "k8s.io/kubernetes/pkg/kubectl/validation"
  29. )
  30. type factoryImpl struct {
  31. clientGetter genericclioptions.RESTClientGetter
  32. // openAPIGetter loads and caches openapi specs
  33. openAPIGetter openAPIGetter
  34. }
  35. type openAPIGetter struct {
  36. once sync.Once
  37. getter openapi.Getter
  38. }
  39. func NewFactory(clientGetter genericclioptions.RESTClientGetter) Factory {
  40. if clientGetter == nil {
  41. panic("attempt to instantiate client_access_factory with nil clientGetter")
  42. }
  43. f := &factoryImpl{
  44. clientGetter: clientGetter,
  45. }
  46. return f
  47. }
  48. func (f *factoryImpl) ToRESTConfig() (*restclient.Config, error) {
  49. return f.clientGetter.ToRESTConfig()
  50. }
  51. func (f *factoryImpl) ToRESTMapper() (meta.RESTMapper, error) {
  52. return f.clientGetter.ToRESTMapper()
  53. }
  54. func (f *factoryImpl) ToDiscoveryClient() (discovery.CachedDiscoveryInterface, error) {
  55. return f.clientGetter.ToDiscoveryClient()
  56. }
  57. func (f *factoryImpl) ToRawKubeConfigLoader() clientcmd.ClientConfig {
  58. return f.clientGetter.ToRawKubeConfigLoader()
  59. }
  60. func (f *factoryImpl) KubernetesClientSet() (*kubernetes.Clientset, error) {
  61. clientConfig, err := f.ToRESTConfig()
  62. if err != nil {
  63. return nil, err
  64. }
  65. return kubernetes.NewForConfig(clientConfig)
  66. }
  67. func (f *factoryImpl) DynamicClient() (dynamic.Interface, error) {
  68. clientConfig, err := f.ToRESTConfig()
  69. if err != nil {
  70. return nil, err
  71. }
  72. return dynamic.NewForConfig(clientConfig)
  73. }
  74. // NewBuilder returns a new resource builder for structured api objects.
  75. func (f *factoryImpl) NewBuilder() *resource.Builder {
  76. return resource.NewBuilder(f.clientGetter)
  77. }
  78. func (f *factoryImpl) RESTClient() (*restclient.RESTClient, error) {
  79. clientConfig, err := f.ToRESTConfig()
  80. if err != nil {
  81. return nil, err
  82. }
  83. setKubernetesDefaults(clientConfig)
  84. return restclient.RESTClientFor(clientConfig)
  85. }
  86. func (f *factoryImpl) ClientForMapping(mapping *meta.RESTMapping) (resource.RESTClient, error) {
  87. cfg, err := f.clientGetter.ToRESTConfig()
  88. if err != nil {
  89. return nil, err
  90. }
  91. if err := setKubernetesDefaults(cfg); err != nil {
  92. return nil, err
  93. }
  94. gvk := mapping.GroupVersionKind
  95. switch gvk.Group {
  96. case corev1.GroupName:
  97. cfg.APIPath = "/api"
  98. default:
  99. cfg.APIPath = "/apis"
  100. }
  101. gv := gvk.GroupVersion()
  102. cfg.GroupVersion = &gv
  103. return restclient.RESTClientFor(cfg)
  104. }
  105. func (f *factoryImpl) UnstructuredClientForMapping(mapping *meta.RESTMapping) (resource.RESTClient, error) {
  106. cfg, err := f.clientGetter.ToRESTConfig()
  107. if err != nil {
  108. return nil, err
  109. }
  110. if err := restclient.SetKubernetesDefaults(cfg); err != nil {
  111. return nil, err
  112. }
  113. cfg.APIPath = "/apis"
  114. if mapping.GroupVersionKind.Group == corev1.GroupName {
  115. cfg.APIPath = "/api"
  116. }
  117. gv := mapping.GroupVersionKind.GroupVersion()
  118. cfg.ContentConfig = resource.UnstructuredPlusDefaultContentConfig()
  119. cfg.GroupVersion = &gv
  120. return restclient.RESTClientFor(cfg)
  121. }
  122. func (f *factoryImpl) Validator(validate bool) (validation.Schema, error) {
  123. if !validate {
  124. return validation.NullSchema{}, nil
  125. }
  126. resources, err := f.OpenAPISchema()
  127. if err != nil {
  128. return nil, err
  129. }
  130. return validation.ConjunctiveSchema{
  131. openapivalidation.NewSchemaValidation(resources),
  132. validation.NoDoubleKeySchema{},
  133. }, nil
  134. }
  135. // OpenAPISchema returns metadata and structural information about Kubernetes object definitions.
  136. func (f *factoryImpl) OpenAPISchema() (openapi.Resources, error) {
  137. discovery, err := f.clientGetter.ToDiscoveryClient()
  138. if err != nil {
  139. return nil, err
  140. }
  141. // Lazily initialize the OpenAPIGetter once
  142. f.openAPIGetter.once.Do(func() {
  143. // Create the caching OpenAPIGetter
  144. f.openAPIGetter.getter = openapi.NewOpenAPIGetter(discovery)
  145. })
  146. // Delegate to the OpenAPIGetter
  147. return f.openAPIGetter.getter.Get()
  148. }