structuredmerge.go 7.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186
  1. /*
  2. Copyright 2019 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. package internal
  14. import (
  15. "fmt"
  16. "k8s.io/apimachinery/pkg/api/errors"
  17. "k8s.io/apimachinery/pkg/api/meta"
  18. "k8s.io/apimachinery/pkg/runtime"
  19. "k8s.io/apimachinery/pkg/runtime/schema"
  20. "sigs.k8s.io/structured-merge-diff/v4/fieldpath"
  21. "sigs.k8s.io/structured-merge-diff/v4/merge"
  22. )
  23. type structuredMergeManager struct {
  24. typeConverter TypeConverter
  25. objectConverter runtime.ObjectConvertor
  26. objectDefaulter runtime.ObjectDefaulter
  27. groupVersion schema.GroupVersion
  28. hubVersion schema.GroupVersion
  29. updater merge.Updater
  30. }
  31. var _ Manager = &structuredMergeManager{}
  32. // NewStructuredMergeManager creates a new Manager that merges apply requests
  33. // and update managed fields for other types of requests.
  34. func NewStructuredMergeManager(typeConverter TypeConverter, objectConverter runtime.ObjectConvertor, objectDefaulter runtime.ObjectDefaulter, gv schema.GroupVersion, hub schema.GroupVersion, resetFields map[fieldpath.APIVersion]*fieldpath.Set) (Manager, error) {
  35. if typeConverter == nil {
  36. return nil, fmt.Errorf("typeconverter must not be nil")
  37. }
  38. return &structuredMergeManager{
  39. typeConverter: typeConverter,
  40. objectConverter: objectConverter,
  41. objectDefaulter: objectDefaulter,
  42. groupVersion: gv,
  43. hubVersion: hub,
  44. updater: merge.Updater{
  45. Converter: newVersionConverter(typeConverter, objectConverter, hub), // This is the converter provided to SMD from k8s
  46. IgnoredFields: resetFields,
  47. },
  48. }, nil
  49. }
  50. // NewCRDStructuredMergeManager creates a new Manager specifically for
  51. // CRDs. This allows for the possibility of fields which are not defined
  52. // in models, as well as having no models defined at all.
  53. func NewCRDStructuredMergeManager(typeConverter TypeConverter, objectConverter runtime.ObjectConvertor, objectDefaulter runtime.ObjectDefaulter, gv schema.GroupVersion, hub schema.GroupVersion, resetFields map[fieldpath.APIVersion]*fieldpath.Set) (_ Manager, err error) {
  54. return &structuredMergeManager{
  55. typeConverter: typeConverter,
  56. objectConverter: objectConverter,
  57. objectDefaulter: objectDefaulter,
  58. groupVersion: gv,
  59. hubVersion: hub,
  60. updater: merge.Updater{
  61. Converter: newCRDVersionConverter(typeConverter, objectConverter, hub),
  62. IgnoredFields: resetFields,
  63. },
  64. }, nil
  65. }
  66. func objectGVKNN(obj runtime.Object) string {
  67. name := "<unknown>"
  68. namespace := "<unknown>"
  69. if accessor, err := meta.Accessor(obj); err == nil {
  70. name = accessor.GetName()
  71. namespace = accessor.GetNamespace()
  72. }
  73. return fmt.Sprintf("%v/%v; %v", namespace, name, obj.GetObjectKind().GroupVersionKind())
  74. }
  75. // Update implements Manager.
  76. func (f *structuredMergeManager) Update(liveObj, newObj runtime.Object, managed Managed, manager string) (runtime.Object, Managed, error) {
  77. newObjVersioned, err := f.toVersioned(newObj)
  78. if err != nil {
  79. return nil, nil, fmt.Errorf("failed to convert new object (%v) to proper version (%v): %v", objectGVKNN(newObj), f.groupVersion, err)
  80. }
  81. liveObjVersioned, err := f.toVersioned(liveObj)
  82. if err != nil {
  83. return nil, nil, fmt.Errorf("failed to convert live object (%v) to proper version: %v", objectGVKNN(liveObj), err)
  84. }
  85. newObjTyped, err := f.typeConverter.ObjectToTyped(newObjVersioned)
  86. if err != nil {
  87. return nil, nil, fmt.Errorf("failed to convert new object (%v) to smd typed: %v", objectGVKNN(newObjVersioned), err)
  88. }
  89. liveObjTyped, err := f.typeConverter.ObjectToTyped(liveObjVersioned)
  90. if err != nil {
  91. return nil, nil, fmt.Errorf("failed to convert live object (%v) to smd typed: %v", objectGVKNN(liveObjVersioned), err)
  92. }
  93. apiVersion := fieldpath.APIVersion(f.groupVersion.String())
  94. // TODO(apelisse) use the first return value when unions are implemented
  95. _, managedFields, err := f.updater.Update(liveObjTyped, newObjTyped, apiVersion, managed.Fields(), manager)
  96. if err != nil {
  97. return nil, nil, fmt.Errorf("failed to update ManagedFields (%v): %v", objectGVKNN(newObjVersioned), err)
  98. }
  99. managed = NewManaged(managedFields, managed.Times())
  100. return newObj, managed, nil
  101. }
  102. // Apply implements Manager.
  103. func (f *structuredMergeManager) Apply(liveObj, patchObj runtime.Object, managed Managed, manager string, force bool) (runtime.Object, Managed, error) {
  104. // Check that the patch object has the same version as the live object
  105. if patchVersion := patchObj.GetObjectKind().GroupVersionKind().GroupVersion(); patchVersion != f.groupVersion {
  106. return nil, nil,
  107. errors.NewBadRequest(
  108. fmt.Sprintf("Incorrect version specified in apply patch. "+
  109. "Specified patch version: %s, expected: %s",
  110. patchVersion, f.groupVersion))
  111. }
  112. patchObjMeta, err := meta.Accessor(patchObj)
  113. if err != nil {
  114. return nil, nil, fmt.Errorf("couldn't get accessor: %v", err)
  115. }
  116. if patchObjMeta.GetManagedFields() != nil {
  117. return nil, nil, errors.NewBadRequest("metadata.managedFields must be nil")
  118. }
  119. liveObjVersioned, err := f.toVersioned(liveObj)
  120. if err != nil {
  121. return nil, nil, fmt.Errorf("failed to convert live object (%v) to proper version: %v", objectGVKNN(liveObj), err)
  122. }
  123. patchObjTyped, err := f.typeConverter.ObjectToTyped(patchObj)
  124. if err != nil {
  125. return nil, nil, fmt.Errorf("failed to create typed patch object (%v): %v", objectGVKNN(patchObj), err)
  126. }
  127. liveObjTyped, err := f.typeConverter.ObjectToTyped(liveObjVersioned)
  128. if err != nil {
  129. return nil, nil, fmt.Errorf("failed to create typed live object (%v): %v", objectGVKNN(liveObjVersioned), err)
  130. }
  131. apiVersion := fieldpath.APIVersion(f.groupVersion.String())
  132. newObjTyped, managedFields, err := f.updater.Apply(liveObjTyped, patchObjTyped, apiVersion, managed.Fields(), manager, force)
  133. if err != nil {
  134. return nil, nil, err
  135. }
  136. managed = NewManaged(managedFields, managed.Times())
  137. if newObjTyped == nil {
  138. return nil, managed, nil
  139. }
  140. newObj, err := f.typeConverter.TypedToObject(newObjTyped)
  141. if err != nil {
  142. return nil, nil, fmt.Errorf("failed to convert new typed object (%v) to object: %v", objectGVKNN(patchObj), err)
  143. }
  144. newObjVersioned, err := f.toVersioned(newObj)
  145. if err != nil {
  146. return nil, nil, fmt.Errorf("failed to convert new object (%v) to proper version: %v", objectGVKNN(patchObj), err)
  147. }
  148. f.objectDefaulter.Default(newObjVersioned)
  149. newObjUnversioned, err := f.toUnversioned(newObjVersioned)
  150. if err != nil {
  151. return nil, nil, fmt.Errorf("failed to convert to unversioned (%v): %v", objectGVKNN(patchObj), err)
  152. }
  153. return newObjUnversioned, managed, nil
  154. }
  155. func (f *structuredMergeManager) toVersioned(obj runtime.Object) (runtime.Object, error) {
  156. return f.objectConverter.ConvertToVersion(obj, f.groupVersion)
  157. }
  158. func (f *structuredMergeManager) toUnversioned(obj runtime.Object) (runtime.Object, error) {
  159. return f.objectConverter.ConvertToVersion(obj, f.hubVersion)
  160. }