kic

Documentation

Index

• Constants
• type Config
• type Driver
  • func NewDriver(c Config) *Driver
  • func (d *Driver) Create() error
  • func (d *Driver) DriverName() string
  • func (d *Driver) GetExternalIP() (string, error)
  • func (d *Driver) GetIP() (string, error)
  • func (d *Driver) GetSSHHostname() (string, error)
  • func (d *Driver) GetSSHKeyPath() string
  • func (d *Driver) GetSSHPort() (int, error)
  • func (d *Driver) GetSSHUsername() string
  • func (d *Driver) GetState() (state.State, error)
  • func (d *Driver) GetURL() (string, error)
  • func (d *Driver) Kill() error
  • func (d *Driver) Remove() error
  • func (d *Driver) Restart() error
  • func (d *Driver) RunSSHCommandFromDriver() error
  • func (d *Driver) Start() error
  • func (d *Driver) Stop() error
  • func (d *Driver) Unpause() error

Constants

const (
	// Docker default bridge network is named "bridge" (https://docs.docker.com/network/bridge/#use-the-default-bridge-network)
	DefaultNetwork = "bridge"
	// DefaultPodCIDR is The CIDR to be used for pods inside the node.
	DefaultPodCIDR = "10.244.0.0/16"

	// BaseImage is the base image is used to spin up kic containers. it uses same base-image as kind.
	BaseImage = "gcr.io/k8s-minikube/kicbase:v0.0.5@sha256:3ddd8461dfb5c3e452ccc44d87750b87a574ec23fc425da67dccc1f0c57d428a"
	// OverlayImage is the cni plugin used for overlay image, created by kind.
	// CNI plugin image used for kic drivers created by kind.
	OverlayImage = "kindest/kindnetd:0.5.3"
)

Types

type Config

type Config struct {
	MachineName   string            // maps to the container name being created
	CPU           int               // Number of CPU cores assigned to the container
	Memory        int               // max memory in MB
	StorePath     string            // libmachine store path
	OCIBinary     string            // oci tool to use (docker, podman,...)
	ImageDigest   string            // image name with sha to use for the node
	Mounts        []oci.Mount       // mounts
	APIServerPort int               // kubernetes api server port inside the container
	PortMappings  []oci.PortMapping // container port mappings
	Envs          map[string]string // key,value of environment variables passed to the node
}

Config is configuration for the kic driver used by registry

type Driver

type Driver struct {
	*drivers.BaseDriver
	*pkgdrivers.CommonDriver
	URL string

	NodeConfig Config
	OCIBinary  string // docker,podman
	// contains filtered or unexported fields
}

Driver represents a kic driver https://minikube.sigs.k8s.io/docs/reference/drivers/docker

func NewDriver

func NewDriver(c Config) *Driver

NewDriver returns a fully configured Kic driver

func (*Driver) Create

func (d *Driver) Create() error

Create a host using the driver's config

func (*Driver) DriverName

func (d *Driver) DriverName() string

DriverName returns the name of the driver

func (*Driver) GetExternalIP

func (d *Driver) GetExternalIP() (string, error)

GetExternalIP returns an IP which is accissble from outside

func (*Driver) GetIP

func (d *Driver) GetIP() (string, error)

GetIP returns an IP or hostname that this host is available at

func (*Driver) GetSSHHostname

func (d *Driver) GetSSHHostname() (string, error)

GetSSHHostname returns hostname for use with ssh

func (*Driver) GetSSHKeyPath

func (d *Driver) GetSSHKeyPath() string

GetSSHKeyPath returns the ssh key path

func (*Driver) GetSSHPort

func (d *Driver) GetSSHPort() (int, error)

GetSSHPort returns port for use with ssh

func (*Driver) GetSSHUsername

func (d *Driver) GetSSHUsername() string

GetSSHUsername returns the ssh username

func (*Driver) GetState

func (d *Driver) GetState() (state.State, error)

GetState returns the state that the host is in (running, stopped, etc)

func (*Driver) GetURL

func (d *Driver) GetURL() (string, error)

GetURL returns ip of the container running kic control-panel

func (*Driver) Kill

func (d *Driver) Kill() error

Kill stops a host forcefully, including any containers that we are managing.

func (*Driver) Remove

func (d *Driver) Remove() error

Remove will delete the Kic Node Container

func (*Driver) Restart

func (d *Driver) Restart() error

Restart a host

func (*Driver) RunSSHCommandFromDriver

func (d *Driver) RunSSHCommandFromDriver() error

RunSSHCommandFromDriver implements direct ssh control to the driver

func (*Driver) Start

func (d *Driver) Start() error

Start a _stopped_ kic container not meant to be used for Create().

func (*Driver) Stop

func (d *Driver) Stop() error

Stop a host gracefully, including any containers that we are managing.

func (*Driver) Unpause

func (d *Driver) Unpause() error

Unpause a kic container