 Documentation
      ¶
      Documentation
      ¶
    
    
  
    
  
    Index ¶
Constants ¶
This section is empty.
Variables ¶
      View Source
      
  
var ErrHostIsNotRunning = errors.New("host is not running")
    Functions ¶
func GetCreateFlags ¶
GetCreateFlags runs GetCreateFlags for all of the drivers and returns their return values indexed by the driver name
func GetDriverNames ¶
func GetDriverNames() []string
GetDriverNames returns a slice of all registered driver names
func GetSSHCommandFromDriver ¶ added in v0.2.0
func Register ¶
func Register(name string, registeredDriver *RegisteredDriver) error
Register a driver
Types ¶
type ByFlagName ¶
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(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)
type DriverOptions ¶
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
       Directories
      ¶
      Directories
      ¶
    
    | Path | Synopsis | 
|---|---|
| this is empty to allow builds on non-windows platforms | this is empty to allow builds on non-windows platforms | 
| this is empty to allow builds on non-darwin platforms | this is empty to allow builds on non-darwin platforms | 
 Click to show internal directories. 
   Click to hide internal directories.