drivers

Documentation

Index

• Variables
• func GetCreateFlags() []cli.Flag
• func GetCreateFlagsForDriver(name string) ([]cli.Flag, error)
• func GetDriverNames() []string
• func GetSSHCommandFromDriver(d Driver, args ...string) (*exec.Cmd, error)
• func MachineInState(d Driver, desiredState state.State) func() bool
• func Register(name string, registeredDriver *RegisteredDriver) error
• type ByFlagName
  • func (flags ByFlagName) Len() int
  • func (flags ByFlagName) Less(i, j int) bool
  • func (flags ByFlagName) Swap(i, j int)
• type Driver
  • func NewDriver(name string, machineName string, storePath string, caCert string, ...) (Driver, error)
• type DriverOptions
• type Port
• type RegisteredDriver

Variables

var ErrHostIsNotRunning = errors.New("host is not running")

Functions

func GetCreateFlags

func GetCreateFlags() []cli.Flag

GetCreateFlags runs GetCreateFlags for all of the drivers and returns their return values indexed by the driver name

func GetCreateFlagsForDriver

func GetCreateFlagsForDriver(name string) ([]cli.Flag, error)

func GetDriverNames

func GetDriverNames() []string

GetDriverNames returns a slice of all registered driver names

func GetSSHCommandFromDriver

func GetSSHCommandFromDriver(d Driver, args ...string) (*exec.Cmd, error)

func MachineInState

func MachineInState(d Driver, desiredState state.State) func() bool

func Register

func Register(name string, registeredDriver *RegisteredDriver) error

Register a driver

Types

type ByFlagName

type ByFlagName []cli.Flag

func (ByFlagName) Len

func (flags ByFlagName) Len() int

func (ByFlagName) Less

func (flags ByFlagName) Less(i, j int) bool

func (ByFlagName) Swap

func (flags ByFlagName) Swap(i, j int)

type Driver

type Driver interface {
	// AuthorizePort authorizes a port for machine access
	AuthorizePort(ports []*Port) error

	// Create a host using the driver's config
	Create() error

	// DeauthorizePort removes a port for machine access
	DeauthorizePort(ports []*Port) error

	// DriverName returns the name of the driver as it is registered
	DriverName() string

	// GetIP returns an IP or hostname that this host is available at
	// e.g. 1.2.3.4 or docker-host-d60b70a14d3a.cloudapp.net
	GetIP() (string, error)

	// GetMachineName returns the name of the machine
	GetMachineName() string

	// GetSSHHostname returns hostname for use with ssh
	GetSSHHostname() (string, error)

	// GetSSHKeyPath returns key path for use with ssh
	GetSSHKeyPath() string

	// GetSSHPort returns port for use with ssh
	GetSSHPort() (int, error)

	// GetSSHUsername returns username for use with ssh
	GetSSHUsername() string

	// GetURL returns a Docker compatible host URL for connecting to this host
	// e.g. tcp://1.2.3.4:2376
	GetURL() (string, error)

	// GetState returns the state that the host is in (running, stopped, etc)
	GetState() (state.State, error)

	// GetProviderType returns whether the instance is local/remote
	GetProviderType() provider.ProviderType

	// Kill stops a host forcefully
	Kill() error

	// PreCreateCheck allows for pre-create operations to make sure a driver is ready for creation
	PreCreateCheck() error

	// Remove a host
	Remove() error

	// Restart a host. This may just call Stop(); Start() if the provider does not
	// have any special restart behaviour.
	Restart() error

	// SetConfigFromFlags configures the driver with the object that was returned
	// by RegisterCreateFlags
	SetConfigFromFlags(flags DriverOptions) error

	// Start a host
	Start() error

	// Stop a host gracefully
	Stop() error
}

Driver defines how a host is created and controlled. Different types of driver represent different ways hosts can be created (e.g. different hypervisors, different cloud providers)

func NewDriver

func NewDriver(name string, machineName string, storePath string, caCert string, privateKey string) (Driver, error)

NewDriver creates a new driver of type "name"

type DriverOptions

type DriverOptions interface {
	String(key string) string
	Int(key string) int
	Bool(key string) bool
}

type Port

type Port struct {
	Protocol string
	Port     int
}

type RegisteredDriver

type RegisteredDriver struct {
	New            func(machineName string, storePath string, caCert string, privateKey string) (Driver, error)
	GetCreateFlags func() []cli.Flag
}

RegisteredDriver is used to register a driver with the Register function. It has two attributes:

• New: a function that returns a new driver given a path to store host configuration in
• RegisterCreateFlags: a function that takes the FlagSet for "docker hosts create" and returns an object to pass to SetConfigFromFlags