| /* |
| Copyright 2014 The Kubernetes 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 statefulset |
| |
| import ( |
| "context" |
| |
| appsv1beta1 "k8s.io/api/apps/v1beta1" |
| appsv1beta2 "k8s.io/api/apps/v1beta2" |
| apiequality "k8s.io/apimachinery/pkg/api/equality" |
| "k8s.io/apimachinery/pkg/runtime" |
| "k8s.io/apimachinery/pkg/runtime/schema" |
| "k8s.io/apimachinery/pkg/util/validation/field" |
| genericapirequest "k8s.io/apiserver/pkg/endpoints/request" |
| "k8s.io/apiserver/pkg/registry/rest" |
| "k8s.io/apiserver/pkg/storage/names" |
| "k8s.io/kubernetes/pkg/api/legacyscheme" |
| "k8s.io/kubernetes/pkg/api/pod" |
| "k8s.io/kubernetes/pkg/apis/apps" |
| "k8s.io/kubernetes/pkg/apis/apps/validation" |
| ) |
| |
| // statefulSetStrategy implements verification logic for Replication StatefulSets. |
| type statefulSetStrategy struct { |
| runtime.ObjectTyper |
| names.NameGenerator |
| } |
| |
| // Strategy is the default logic that applies when creating and updating Replication StatefulSet objects. |
| var Strategy = statefulSetStrategy{legacyscheme.Scheme, names.SimpleNameGenerator} |
| |
| // DefaultGarbageCollectionPolicy returns OrphanDependents by default. For apps/v1, returns DeleteDependents. |
| func (statefulSetStrategy) DefaultGarbageCollectionPolicy(ctx context.Context) rest.GarbageCollectionPolicy { |
| if requestInfo, found := genericapirequest.RequestInfoFrom(ctx); found { |
| groupVersion := schema.GroupVersion{Group: requestInfo.APIGroup, Version: requestInfo.APIVersion} |
| switch groupVersion { |
| case appsv1beta1.SchemeGroupVersion, appsv1beta2.SchemeGroupVersion: |
| // for back compatibility |
| return rest.OrphanDependents |
| default: |
| return rest.DeleteDependents |
| } |
| } |
| return rest.OrphanDependents |
| } |
| |
| // NamespaceScoped returns true because all StatefulSet' need to be within a namespace. |
| func (statefulSetStrategy) NamespaceScoped() bool { |
| return true |
| } |
| |
| // PrepareForCreate clears the status of an StatefulSet before creation. |
| func (statefulSetStrategy) PrepareForCreate(ctx context.Context, obj runtime.Object) { |
| statefulSet := obj.(*apps.StatefulSet) |
| // create cannot set status |
| statefulSet.Status = apps.StatefulSetStatus{} |
| |
| statefulSet.Generation = 1 |
| |
| pod.DropDisabledAlphaFields(&statefulSet.Spec.Template.Spec) |
| } |
| |
| // PrepareForUpdate clears fields that are not allowed to be set by end users on update. |
| func (statefulSetStrategy) PrepareForUpdate(ctx context.Context, obj, old runtime.Object) { |
| newStatefulSet := obj.(*apps.StatefulSet) |
| oldStatefulSet := old.(*apps.StatefulSet) |
| // Update is not allowed to set status |
| newStatefulSet.Status = oldStatefulSet.Status |
| |
| pod.DropDisabledAlphaFields(&newStatefulSet.Spec.Template.Spec) |
| pod.DropDisabledAlphaFields(&oldStatefulSet.Spec.Template.Spec) |
| |
| // Any changes to the spec increment the generation number, any changes to the |
| // status should reflect the generation number of the corresponding object. |
| // See metav1.ObjectMeta description for more information on Generation. |
| if !apiequality.Semantic.DeepEqual(oldStatefulSet.Spec, newStatefulSet.Spec) { |
| newStatefulSet.Generation = oldStatefulSet.Generation + 1 |
| } |
| |
| } |
| |
| // Validate validates a new StatefulSet. |
| func (statefulSetStrategy) Validate(ctx context.Context, obj runtime.Object) field.ErrorList { |
| statefulSet := obj.(*apps.StatefulSet) |
| return validation.ValidateStatefulSet(statefulSet) |
| } |
| |
| // Canonicalize normalizes the object after validation. |
| func (statefulSetStrategy) Canonicalize(obj runtime.Object) { |
| } |
| |
| // AllowCreateOnUpdate is false for StatefulSet; this means POST is needed to create one. |
| func (statefulSetStrategy) AllowCreateOnUpdate() bool { |
| return false |
| } |
| |
| // ValidateUpdate is the default update validation for an end user. |
| func (statefulSetStrategy) ValidateUpdate(ctx context.Context, obj, old runtime.Object) field.ErrorList { |
| validationErrorList := validation.ValidateStatefulSet(obj.(*apps.StatefulSet)) |
| updateErrorList := validation.ValidateStatefulSetUpdate(obj.(*apps.StatefulSet), old.(*apps.StatefulSet)) |
| return append(validationErrorList, updateErrorList...) |
| } |
| |
| // AllowUnconditionalUpdate is the default update policy for StatefulSet objects. |
| func (statefulSetStrategy) AllowUnconditionalUpdate() bool { |
| return true |
| } |
| |
| type statefulSetStatusStrategy struct { |
| statefulSetStrategy |
| } |
| |
| var StatusStrategy = statefulSetStatusStrategy{Strategy} |
| |
| // PrepareForUpdate clears fields that are not allowed to be set by end users on update of status |
| func (statefulSetStatusStrategy) PrepareForUpdate(ctx context.Context, obj, old runtime.Object) { |
| newStatefulSet := obj.(*apps.StatefulSet) |
| oldStatefulSet := old.(*apps.StatefulSet) |
| // status changes are not allowed to update spec |
| newStatefulSet.Spec = oldStatefulSet.Spec |
| } |
| |
| // ValidateUpdate is the default update validation for an end user updating status |
| func (statefulSetStatusStrategy) ValidateUpdate(ctx context.Context, obj, old runtime.Object) field.ErrorList { |
| // TODO: Validate status updates. |
| return validation.ValidateStatefulSetStatusUpdate(obj.(*apps.StatefulSet), old.(*apps.StatefulSet)) |
| } |