networking

Documentation

Overview

kvm.go file provides networking supporting functions for kvm flavor

Index

• Constants
• type ForwardedPort
• type NetConf
• type NetParams
• type Networking
  • func Load(podRoot string, podID *types.UUID) (*Networking, error)
  • func Setup(podRoot string, podID types.UUID, fps []ForwardedPort, ...) (*Networking, error)
  • func (n *Networking) GetDefaultHostIP() (net.IP, error)
  • func (n *Networking) GetDefaultIP() net.IP
  • func (e *Networking) GetNetworkParameters() []NetParams
  • func (e *Networking) Save() error
  • func (n *Networking) Teardown(flavor string)

Constants

const (
	// Suffix to LocalConfigDir path, where users place their net configs
	UserNetPathSuffix = "net.d"

	// Default net path relative to stage1 root
	DefaultNetPath           = "etc/rkt/net.d/99-default.conf"
	DefaultRestrictedNetPath = "etc/rkt/net.d/99-default-restricted.conf"
)

const BuiltinNetPluginsPath = "usr/lib/rkt/plugins/net"

const (
	IfNamePattern = "eth%d"
)

const UserNetPluginsPath = "/usr/lib/rkt/plugins/net"

TODO(eyakubovich): make this configurable in rkt.conf

Types

type ForwardedPort

type ForwardedPort struct {
	Protocol string
	HostPort uint
	PodPort  uint
}

ForwardedPort describes a port that will be forwarded (mapped) from the host to the pod

type NetConf

type NetConf struct {
	plugin.NetConf
	IPMasq bool `json:"ipMasq"`
}

NetConf local struct extends plugin.NetConf with information about masquerading similar to CNI plugins

type NetParams

type NetParams struct {
	// runtime based information
	HostIP  net.IP
	GuestIP net.IP
	Mask    net.IP
	IfName  string

	// configuration based information
	Name   string
	Type   string
	IPMasq bool
}

NetParams exposes conf(NetConf)/runtime(NetInfo) data to stage1/init client

type Networking

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

Networking describes the networking details of a pod.

func Load

func Load(podRoot string, podID *types.UUID) (*Networking, error)

Load creates the Networking object from saved state. Assumes the current netns is that of the host.

func Setup

func Setup(podRoot string, podID types.UUID, fps []ForwardedPort, privateNetList common.PrivateNetList, localConfig, flavor string) (*Networking, error)

Setup creates a new networking namespace and executes network plugins to setup private networking. It returns in the new pod namespace

func (*Networking) GetDefaultHostIP

func (n *Networking) GetDefaultHostIP() (net.IP, error)

func (*Networking) GetDefaultIP

func (n *Networking) GetDefaultIP() net.IP

func (*Networking) GetNetworkParameters

func (e *Networking) GetNetworkParameters() []NetParams

GetNetworkParameters returns network parameters created by plugins, which are required for stage1 executor to run (only for KVM)

func (*Networking) Save

func (e *Networking) Save() error

Save writes out the info about active nets for "rkt list" and friends to display

func (*Networking) Teardown

func (n *Networking) Teardown(flavor string)

Teardown cleans up a produced Networking object.