subnet

Documentation

Index

• func CheckNetworkConfig(config *Config) error
• func MakeSubnetKey(sn ip.IP4Net, sn6 ip.IP6Net) string
• func ParseSubnetKey(s string) (*ip.IP4Net, *ip.IP6Net)
• func WatchLease(ctx context.Context, sm Manager, sn ip.IP4Net, sn6 ip.IP6Net, ...)
• func WatchLeases(ctx context.Context, sm Manager, ownLease *lease.Lease, ...)
• func WriteSubnetFile(path string, config *Config, ipMasq bool, sn ip.IP4Net, ipv6sn ip.IP6Net, ...) error
• type Config
  • func ParseConfig(s string) (*Config, error)
  • func (c *Config) AddNetwork(net *net.IPNet)
  • func (c *Config) GetFlannelIPv6Network(sn *ip.IP6Net) (ip.IP6Net, error)
  • func (c *Config) GetFlannelNetwork(sn *ip.IP4Net) (ip.IP4Net, error)
  • func (c *Config) HasIPv6Networks() bool
  • func (c *Config) HasNetworks() bool
• type Manager

Functions

func CheckNetworkConfig

func CheckNetworkConfig(config *Config) error

CheckNetworkConfig checks the coherence of the flannel configuration. It is used only with the local network manager, not with the kubernetes-based manager.

func MakeSubnetKey

func MakeSubnetKey(sn ip.IP4Net, sn6 ip.IP6Net) string

func ParseSubnetKey

func ParseSubnetKey(s string) (*ip.IP4Net, *ip.IP6Net)

func WatchLease

func WatchLease(ctx context.Context, sm Manager, sn ip.IP4Net, sn6 ip.IP6Net, receiver chan lease.Event)

WatchLease performs a long term watch of the given network's subnet lease and communicates addition/deletion events on receiver channel. It takes care of handling "fall-behind" logic where the history window has advanced too far and it needs to diff the latest snapshot with its saved state and generate events

func WatchLeases

func WatchLeases(ctx context.Context, sm Manager, ownLease *lease.Lease, receiver chan []lease.Event)

WatchLeases performs a long term watch of the given network's subnet leases and communicates addition/deletion events on receiver channel. It takes care of handling "fall-behind" logic where the history window has advanced too far and it needs to diff the latest snapshot with its saved state and generate events

func WriteSubnetFile

func WriteSubnetFile(path string, config *Config, ipMasq bool, sn ip.IP4Net, ipv6sn ip.IP6Net, mtu int) error

Types

type Config

type Config struct {
	EnableIPv4    bool
	EnableIPv6    bool
	Network       ip.IP4Net
	IPv6Network   ip.IP6Net
	Networks      []ip.IP4Net
	IPv6Networks  []ip.IP6Net
	SubnetMin     ip.IP4
	SubnetMax     ip.IP4
	IPv6SubnetMin *ip.IP6
	IPv6SubnetMax *ip.IP6
	SubnetLen     uint
	IPv6SubnetLen uint
	BackendType   string          `json:"-"`
	Backend       json.RawMessage `json:",omitempty"`
}

func ParseConfig

func ParseConfig(s string) (*Config, error)

func (*Config) AddNetwork

func (c *Config) AddNetwork(net *net.IPNet)

AddNetwork adds net to either c.Networks or c.IPv6Networks depending on its type

func (*Config) GetFlannelIPv6Network

func (c *Config) GetFlannelIPv6Network(sn *ip.IP6Net) (ip.IP6Net, error)

GetFlannelIPv6Network returns the relevant IPv6 network (i.e. clusterCIDR) for subnet sn If Networks is not empty, GetFlannelIPv6Network returns the first networks that contains subnet sn. If Networks is empty, this means we are not using the MultiClusterCIDR API so GetFlannelIPv6Network falls back to the standard behavior and returns the single IPv6Network entry

func (*Config) GetFlannelNetwork

func (c *Config) GetFlannelNetwork(sn *ip.IP4Net) (ip.IP4Net, error)

GetFlannelNetwork returns the relevant IPv4 network (i.e. clusterCIDR) for subnet sn If Networks is not empty, GetFlannelNetwork returns the first networks that contains subnet sn. If Networks is empty, this means we are not using the MultiClusterCIDR API so GetFlannelNetwork falls back to the standard behavior and returns the single Network entry

func (*Config) HasIPv6Networks

func (c *Config) HasIPv6Networks() bool

HasIPv6Networks returns true if there is at least 1 IPv6 network in the flannel config, false otherwise

func (*Config) HasNetworks

func (c *Config) HasNetworks() bool

HasNetworks returns true if there is at least 1 IPv4 network in the flannel config, false otherwise

type Manager

type Manager interface {
	GetNetworkConfig(ctx context.Context) (*Config, error)
	HandleSubnetFile(path string, config *Config, ipMasq bool, sn ip.IP4Net, ipv6sn ip.IP6Net, mtu int) error
	AcquireLease(ctx context.Context, attrs *lease.LeaseAttrs) (*lease.Lease, error)
	RenewLease(ctx context.Context, lease *lease.Lease) error
	WatchLease(ctx context.Context, sn ip.IP4Net, sn6 ip.IP6Net, receiver chan []lease.LeaseWatchResult) error
	WatchLeases(ctx context.Context, receiver chan []lease.LeaseWatchResult) error
	CompleteLease(ctx context.Context, lease *lease.Lease, wg *sync.WaitGroup) error

	Name() string
}