7c77df8acc
This makes it a bit simpler to remove this interface for v2 plugins and not break external projects (libnetwork and swarmkit). Note that before we remove the `Client()` interface from `CompatPlugin` libnetwork and swarmkit must be updated to explicitly check for the v1 client interface as is done int his PR. This is just a minor tweak that I realized is needed after trying to implement the needed changes on libnetwork. Signed-off-by: Brian Goff <cpuguy83@gmail.com>
52 lines
1.3 KiB
Go
52 lines
1.3 KiB
Go
package plugingetter // import "github.com/docker/docker/pkg/plugingetter"
|
|
|
|
import (
|
|
"net"
|
|
"time"
|
|
|
|
"github.com/docker/docker/pkg/plugins"
|
|
)
|
|
|
|
const (
|
|
// Lookup doesn't update RefCount
|
|
Lookup = 0
|
|
// Acquire increments RefCount
|
|
Acquire = 1
|
|
// Release decrements RefCount
|
|
Release = -1
|
|
)
|
|
|
|
// CompatPlugin is an abstraction to handle both v2(new) and v1(legacy) plugins.
|
|
type CompatPlugin interface {
|
|
Name() string
|
|
ScopedPath(string) string
|
|
IsV1() bool
|
|
PluginWithV1Client
|
|
}
|
|
|
|
// PluginWithV1Client is a plugin that directly utilizes the v1/http plugin client
|
|
type PluginWithV1Client interface {
|
|
Client() *plugins.Client
|
|
}
|
|
|
|
// PluginAddr is a plugin that exposes the socket address for creating custom clients rather than the built-in `*plugins.Client`
|
|
type PluginAddr interface {
|
|
Addr() net.Addr
|
|
Timeout() time.Duration
|
|
Protocol() string
|
|
}
|
|
|
|
// CountedPlugin is a plugin which is reference counted.
|
|
type CountedPlugin interface {
|
|
Acquire()
|
|
Release()
|
|
CompatPlugin
|
|
}
|
|
|
|
// PluginGetter is the interface implemented by Store
|
|
type PluginGetter interface {
|
|
Get(name, capability string, mode int) (CompatPlugin, error)
|
|
GetAllByCap(capability string) ([]CompatPlugin, error)
|
|
GetAllManagedPluginsByCap(capability string) []CompatPlugin
|
|
Handle(capability string, callback func(string, *plugins.Client))
|
|
}
|