diff --git a/pkg/scheduler/framework/interface.go b/pkg/scheduler/framework/interface.go index f5dd413c3ca..864932e830a 100644 --- a/pkg/scheduler/framework/interface.go +++ b/pkg/scheduler/framework/interface.go @@ -307,10 +307,13 @@ type QueueSortPlugin interface { } // EnqueueExtensions is an optional interface that plugins can implement to efficiently -// move unschedulable Pods in internal scheduling queues. +// move unschedulable Pods in internal scheduling queues. Plugins +// that fail pod scheduling (e.g., Filter plugins) are expected to implement this interface. type EnqueueExtensions interface { - // EventsToRegister returns a series of interested events that - // will be registered when instantiating the internal scheduling queue. + // EventsToRegister returns a series of possible events that may cause a Pod + // failed by this plugin schedulable. + // The events will be registered when instantiating the internal scheduling queue, + // and leveraged to build event handlers dynamically. // Note: the returned list needs to be static (not depend on configuration parameters); // otherwise it would lead to undefined behavior. EventsToRegister() []ClusterEvent