@bgrant0607 had recommended to write a doc on scheduling control loops in Kubernetes (with "scheduling" defined broadly), since there are a relatively large set of components involved, and understanding their interactions is useful for understanding how the pieces of the system fit together.
So, I've put together a doc which you can find
here. Anyone on the kubernetes-dev mailing list can view and comment on it.
Here is the first paragraph of the introduction:
This document describes scheduling control loops in Kubernetes, and their interactions. Any component that, based on observing some system state (i.e. not manually triggered), creates a pod or container, binds a pod, evicts a pod or container, adds a node to the cluster, or removes a node from the cluster, is within the scope of this doc. Control loops for networking and storage are outside the scope of this doc.
Please feel free to add suggestions or additions.
Thanks!
David