framework.go 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. /*
  2. Copyright 2018 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 converter
  14. import (
  15. "fmt"
  16. "io/ioutil"
  17. "net/http"
  18. "strings"
  19. "github.com/munnerz/goautoneg"
  20. "k8s.io/klog"
  21. "k8s.io/apiextensions-apiserver/pkg/apis/apiextensions/v1beta1"
  22. metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
  23. "k8s.io/apimachinery/pkg/apis/meta/v1/unstructured"
  24. "k8s.io/apimachinery/pkg/runtime"
  25. "k8s.io/apimachinery/pkg/runtime/serializer/json"
  26. )
  27. // convertFunc is the user defined function for any conversion. The code in this file is a
  28. // template that can be use for any CR conversion given this function.
  29. type convertFunc func(Object *unstructured.Unstructured, version string) (*unstructured.Unstructured, metav1.Status)
  30. // conversionResponseFailureWithMessagef is a helper function to create an AdmissionResponse
  31. // with a formatted embedded error message.
  32. func conversionResponseFailureWithMessagef(msg string, params ...interface{}) *v1beta1.ConversionResponse {
  33. return &v1beta1.ConversionResponse{
  34. Result: metav1.Status{
  35. Message: fmt.Sprintf(msg, params...),
  36. Status: metav1.StatusFailure,
  37. },
  38. }
  39. }
  40. func statusErrorWithMessage(msg string, params ...interface{}) metav1.Status {
  41. return metav1.Status{
  42. Message: fmt.Sprintf(msg, params...),
  43. Status: metav1.StatusFailure,
  44. }
  45. }
  46. func statusSucceed() metav1.Status {
  47. return metav1.Status{
  48. Status: metav1.StatusSuccess,
  49. }
  50. }
  51. // doConversion converts the requested object given the conversion function and returns a conversion response.
  52. // failures will be reported as Reason in the conversion response.
  53. func doConversion(convertRequest *v1beta1.ConversionRequest, convert convertFunc) *v1beta1.ConversionResponse {
  54. var convertedObjects []runtime.RawExtension
  55. for _, obj := range convertRequest.Objects {
  56. cr := unstructured.Unstructured{}
  57. if err := cr.UnmarshalJSON(obj.Raw); err != nil {
  58. klog.Error(err)
  59. return conversionResponseFailureWithMessagef("failed to unmarshall object (%v) with error: %v", string(obj.Raw), err)
  60. }
  61. convertedCR, status := convert(&cr, convertRequest.DesiredAPIVersion)
  62. if status.Status != metav1.StatusSuccess {
  63. klog.Error(status.String())
  64. return &v1beta1.ConversionResponse{
  65. Result: status,
  66. }
  67. }
  68. convertedCR.SetAPIVersion(convertRequest.DesiredAPIVersion)
  69. convertedObjects = append(convertedObjects, runtime.RawExtension{Object: convertedCR})
  70. }
  71. return &v1beta1.ConversionResponse{
  72. ConvertedObjects: convertedObjects,
  73. Result: statusSucceed(),
  74. }
  75. }
  76. func serve(w http.ResponseWriter, r *http.Request, convert convertFunc) {
  77. var body []byte
  78. if r.Body != nil {
  79. if data, err := ioutil.ReadAll(r.Body); err == nil {
  80. body = data
  81. }
  82. }
  83. contentType := r.Header.Get("Content-Type")
  84. serializer := getInputSerializer(contentType)
  85. if serializer == nil {
  86. msg := fmt.Sprintf("invalid Content-Type header `%s`", contentType)
  87. klog.Errorf(msg)
  88. http.Error(w, msg, http.StatusBadRequest)
  89. return
  90. }
  91. klog.V(2).Infof("handling request: %v", body)
  92. convertReview := v1beta1.ConversionReview{}
  93. if _, _, err := serializer.Decode(body, nil, &convertReview); err != nil {
  94. klog.Error(err)
  95. convertReview.Response = conversionResponseFailureWithMessagef("failed to deserialize body (%v) with error %v", string(body), err)
  96. } else {
  97. convertReview.Response = doConversion(convertReview.Request, convert)
  98. convertReview.Response.UID = convertReview.Request.UID
  99. }
  100. klog.V(2).Info(fmt.Sprintf("sending response: %v", convertReview.Response))
  101. // reset the request, it is not needed in a response.
  102. convertReview.Request = &v1beta1.ConversionRequest{}
  103. accept := r.Header.Get("Accept")
  104. outSerializer := getOutputSerializer(accept)
  105. if outSerializer == nil {
  106. msg := fmt.Sprintf("invalid accept header `%s`", accept)
  107. klog.Errorf(msg)
  108. http.Error(w, msg, http.StatusBadRequest)
  109. return
  110. }
  111. err := outSerializer.Encode(&convertReview, w)
  112. if err != nil {
  113. klog.Error(err)
  114. http.Error(w, err.Error(), http.StatusInternalServerError)
  115. return
  116. }
  117. }
  118. // ServeExampleConvert servers endpoint for the example converter defined as convertExampleCRD function.
  119. func ServeExampleConvert(w http.ResponseWriter, r *http.Request) {
  120. serve(w, r, convertExampleCRD)
  121. }
  122. type mediaType struct {
  123. Type, SubType string
  124. }
  125. var scheme = runtime.NewScheme()
  126. var serializers = map[mediaType]runtime.Serializer{
  127. {"application", "json"}: json.NewSerializer(json.DefaultMetaFactory, scheme, scheme, false),
  128. {"application", "yaml"}: json.NewYAMLSerializer(json.DefaultMetaFactory, scheme, scheme),
  129. }
  130. func getInputSerializer(contentType string) runtime.Serializer {
  131. parts := strings.SplitN(contentType, "/", 2)
  132. if len(parts) != 2 {
  133. return nil
  134. }
  135. return serializers[mediaType{parts[0], parts[1]}]
  136. }
  137. func getOutputSerializer(accept string) runtime.Serializer {
  138. if len(accept) == 0 {
  139. return serializers[mediaType{"application", "json"}]
  140. }
  141. clauses := goautoneg.ParseAccept(accept)
  142. for _, clause := range clauses {
  143. for k, v := range serializers {
  144. switch {
  145. case clause.Type == k.Type && clause.SubType == k.SubType,
  146. clause.Type == k.Type && clause.SubType == "*",
  147. clause.Type == "*" && clause.SubType == "*":
  148. return v
  149. }
  150. }
  151. }
  152. return nil
  153. }