cloudprovider

Documentation

Overview

Package cloudprovider supplies interfaces and implementations for cloud service providers

Index

• func RegisterCloudProvider(name string, cloud Factory)
• type Factory
• type Instances
• type Interface
  • func GetCloudProvider(name string) (Interface, error)
• type TCPLoadBalancer
• type Zone
• type Zones

Functions

func RegisterCloudProvider

func RegisterCloudProvider(name string, cloud Factory)

RegisterCloudProvider registers a cloudprovider.Factory by name. This is expected to happen during app startup.

Types

type Factory

type Factory func() (Interface, error)

Factory is a function that returns a cloudprovider.Interface.

type Instances

type Instances interface {
	// IPAddress returns an IP address of the specified instance.
	IPAddress(name string) (net.IP, error)
	// List lists instances that match 'filter' which is a regular expression which must match the entire instance name (fqdn)
	List(filter string) ([]string, error)
}

Instances is an abstract, pluggable interface for sets of instances.

type Interface

type Interface interface {
	// TCPLoadBalancer returns a balancer interface. Also returns true if the interface is supported, false otherwise.
	TCPLoadBalancer() (TCPLoadBalancer, bool)
	// Instances returns an instances interface. Also returns true if the interface is supported, false otherwise.
	Instances() (Instances, bool)
	// Zones returns a zones interface. Also returns true if the interface is supported, false otherwise.
	Zones() (Zones, bool)
}

Interface is an abstract, pluggable interface for cloud providers

func GetCloudProvider

func GetCloudProvider(name string) (Interface, error)

GetCloudProvider creates an instance of the named cloud provider, or nil if the name is not known. The error return is only used if the named provider was known but failed to initialize.

type TCPLoadBalancer

type TCPLoadBalancer interface {
	// TCPLoadBalancerExists returns whether the specified load balancer exists.
	// TODO: Break this up into different interfaces (LB, etc) when we have more than one type of service
	TCPLoadBalancerExists(name, region string) (bool, error)
	// CreateTCPLoadBalancer creates a new tcp load balancer.
	CreateTCPLoadBalancer(name, region string, port int, hosts []string) error
	// UpdateTCPLoadBalancer updates hosts under the specified load balancer.
	UpdateTCPLoadBalancer(name, region string, hosts []string) error
	// DeleteTCPLoadBalancer deletes a specified load balancer.
	DeleteTCPLoadBalancer(name, region string) error
}

TCPLoadBalancer is an abstract, pluggable interface for TCP load balancers.

type Zone

type Zone struct {
	FailureDomain string
	Region        string
}

Zone represents the location of a particular machine

type Zones

type Zones interface {
	// GetZone returns the Zone containing the current failure zone and locality region that the program is running in
	GetZone() (Zone, error)
}

Zones is an abstract, pluggable interface for zone enumeration.