config

Documentation

Index

• type Advertisement
• type Config
  • func Parse(bs []byte) (*Config, error)
• type Peer
• type Pool

Types

type Advertisement

type Advertisement struct {
	// Roll up the IP address into a CIDR prefix of this
	// length. Optional, defaults to 32 (i.e. no aggregation) if not
	// specified.
	AggregationLength int
	// Value of the LOCAL_PREF BGP path attribute. Used only when
	// advertising to IBGP peers (i.e. Peer.MyASN == Peer.ASN).
	LocalPref uint32
	// Value of the COMMUNITIES path attribute.
	Communities map[uint32]bool
}

Advertisement describes one translation from an IP address to a BGP advertisement.

type Config

type Config struct {
	// BGP routers that MetalLB should peer with.
	Peers []*Peer
	// Address pools from which to allocate load balancer IPs.
	Pools map[string]*Pool
}

Config is a parsed MetalLB configuration.

func Parse

func Parse(bs []byte) (*Config, error)

Parse loads and validates a Config from bs.

type Peer

type Peer struct {
	// AS number to use for the local end of the session.
	MyASN uint32
	// AS number to expect from the remote end of the session.
	ASN uint32
	// Address to dial when establishing the session.
	Addr net.IP
	// Port to dial when establishing the session.
	Port uint16
	// Requested BGP hold time, per RFC4271.
	HoldTime time.Duration
}

Peer is the configuration of a BGP peering session.

type Pool

type Pool struct {
	// The addresses that are part of this pool, expressed as CIDR
	// prefixes. config.Parse guarantees that these are
	// non-overlapping, both within and between pools.
	CIDR []*net.IPNet
	// Some buggy consumer devices mistakenly drop IPv4 traffic for IP
	// addresses ending in .0 or .255, due to poor implementations of
	// smurf protection. This setting marks such addresses as
	// unusable, for maximum compatibility with ancient parts of the
	// internet.
	AvoidBuggyIPs bool
	// When an IP is allocated from this pool, how should it be
	// translated into BGP announcements?
	Advertisements []*Advertisement
}

Pool is the configuration of an IP address pool.