doc.go 1.4 KB

123456789101112131415161718192021222324252627282930
  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. // Package antiaffinity provides the LimitPodHardAntiAffinityTopology
  14. // admission controller. It rejects any pod that specifies "hard"
  15. // (RequiredDuringScheduling) anti-affinity with a TopologyKey other
  16. // than v1.LabelHostname. Because anti-affinity is symmetric, without
  17. // this admission controller, a user could maliciously or accidentally
  18. // specify that their pod (once it has scheduled) should block other
  19. // pods from scheduling into the same zone or some other large
  20. // topology, essentially DoSing the cluster. In the future we will
  21. // address this problem more fully by using quota and priority, but
  22. // for now this admission controller provides a simple protection, on
  23. // the assumption that the only legitimate use of hard pod
  24. // anti-affinity is to exclude other pods from the same node.
  25. package antiaffinity // import "k8s.io/kubernetes/plugin/pkg/admission/antiaffinity"