allocator

Documentation

Index

• type Allocator
  • func New() *Allocator
  • func (a *Allocator) Allocate(svcKey string, svc *v1.Service, serviceIPFamily ipfamily.Family, ports []Port, ...) ([]net.IP, error)
  • func (a *Allocator) AllocateFromPool(svcKey string, svc *v1.Service, serviceIPFamily ipfamily.Family, ...) ([]net.IP, error)
  • func (a *Allocator) Assign(svcKey string, svc *v1.Service, ips []net.IP, ports []Port, ...) error
  • func (a *Allocator) IPs(svc string) []net.IP
  • func (a *Allocator) Pool(svc string) string
  • func (a *Allocator) PoolForIP(ips []net.IP) *config.Pool
  • func (a *Allocator) SetPools(pools *config.Pools)
  • func (a *Allocator) Unassign(svc string)
• type Port
  • func (p Port) String() string

Types

type Allocator

type Allocator struct {
	// contains filtered or unexported fields
}

An Allocator tracks IP address pools and allocates addresses from them.

func New

func New() *Allocator

New returns an Allocator managing no pools.

func (*Allocator) Allocate

func (a *Allocator) Allocate(svcKey string, svc *v1.Service, serviceIPFamily ipfamily.Family, ports []Port, sharingKey, backendKey string) ([]net.IP, error)

Allocate assigns any available and assignable IP to service.

func (*Allocator) AllocateFromPool

func (a *Allocator) AllocateFromPool(svcKey string, svc *v1.Service, serviceIPFamily ipfamily.Family, poolName string, ports []Port, sharingKey, backendKey string) ([]net.IP, error)

AllocateFromPool assigns an available IP from pool to service.

func (*Allocator) Assign

func (a *Allocator) Assign(svcKey string, svc *v1.Service, ips []net.IP, ports []Port, sharingKey, backendKey string) error

Assign assigns the requested ip to svc, if the assignment is permissible by sharingKey and backendKey.

func (*Allocator) IPs

func (a *Allocator) IPs(svc string) []net.IP

IPs returns the allocated IPs of a service.

func (*Allocator) Pool

func (a *Allocator) Pool(svc string) string

Pool returns the pool from which service's IP was allocated. If service has no IP allocated, "" is returned.

func (*Allocator) PoolForIP

func (a *Allocator) PoolForIP(ips []net.IP) *config.Pool

PoolForIP returns the pool structure associated with an IP.

func (*Allocator) SetPools

func (a *Allocator) SetPools(pools *config.Pools)

SetPools updates the set of address pools that the allocator owns.

func (*Allocator) Unassign

func (a *Allocator) Unassign(svc string)

Unassign frees the IP associated with service, if any.

type Port

type Port struct {
	Proto string
	Port  int
}

Port represents one port in use by a service.

func (Port) String

func (p Port) String() string

String returns a text description of the port.