vm

Documentation

Index

• type Boot
• type CPU
  • func (c CPU) String() string
• type Client
  • func NewClient(unix string) *Client
  • func (c *Client) Inspect(ctx context.Context) (CPU, MemMib, error)
  • func (c *Client) Shutdown(ctx context.Context) error
• type Config
• type Disk
  • func (d Disk) String() string
• type Disks
• type Interface
• type InterfaceType
• type Interfaces
• type LegacyMonitor
  • func (m *LegacyMonitor) Monitor(ctx context.Context)
• type Machine
  • func MachineFromFile(n string) (*Machine, error)
  • func (m *Machine) Run(ctx context.Context, socket, logs string) error
  • func (m *Machine) Save(n string) error
• type MemMib
  • func (m MemMib) String() string
• type Module
  • func NewVMModule(cl zbus.Client, root string) (*Module, error)
  • func (m *Module) Delete(name string) error
  • func (m *Module) Exists(id string) bool
  • func (m *Module) Inspect(name string) (pkg.VMInfo, error)
  • func (m *Module) List() ([]string, error)
  • func (m *Module) Logs(name string) (string, error)
  • func (m *Module) Monitor(ctx context.Context)
  • func (m *Module) Run(vm pkg.VM) error

Types

type Boot

type Boot struct {
	Kernel string `json:"kernel_image_path"`
	Initrd string `json:"initrd_path,omitempty"`
	Args   string `json:"boot_args"`
}

Boot config struct

type CPU

type CPU uint8

CPU type

func (CPU) String

func (c CPU) String() string

type Client

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

Client to a cloud hypervisor instance

func NewClient

func NewClient(unix string) *Client

NewClient creates a new instance of client

func (*Client) Inspect

func (c *Client) Inspect(ctx context.Context) (CPU, MemMib, error)

Inspect return information about the vm

func (*Client) Shutdown

func (c *Client) Shutdown(ctx context.Context) error

Shutdown shuts the machine down

type Config

type Config struct {
	CPU       CPU    `json:"vcpu_count"`
	Mem       MemMib `json:"mem_size_mib"`
	HTEnabled bool   `json:"ht_enabled"`
}

Config struct

type Disk

type Disk struct {
	ID         string `json:"drive_id"`
	Path       string `json:"path_on_host"`
	RootDevice bool   `json:"is_root_device"`
	ReadOnly   bool   `json:"is_read_only"`
}

Disk struct

func (Disk) String

func (d Disk) String() string

type Disks

type Disks []Disk

Disks is a list of vm disks

type Interface

type Interface struct {
	ID  string `json:"iface_id"`
	Tap string `json:"host_dev_name"`
	Mac string `json:"guest_mac,omitempty"`
}

Interface nic struct

type InterfaceType

type InterfaceType string

InterfaceType interface type

const (
	// InterfaceTAP tuntap type
	InterfaceTAP InterfaceType = "tuntap"
	// InterfaceMACvTAP mactap type
	InterfaceMACvTAP InterfaceType = "macvtap"
)

type Interfaces

type Interfaces []Interface

Interfaces is a list of node interfaces

type LegacyMonitor

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

LegacyMonitor has code to clean up legacy machines death

func (*LegacyMonitor) Monitor

func (m *LegacyMonitor) Monitor(ctx context.Context)

Monitor start vms monitoring

type Machine

type Machine struct {
	ID         string     `json:"id"`
	Boot       Boot       `json:"boot-source"`
	Disks      Disks      `json:"drives"`
	Interfaces Interfaces `json:"network-interfaces"`
	Config     Config     `json:"machine-config"`
	// NoKeepAlive is not used by firecracker, but instead a marker
	// for the vm  mananger to not restart the machine when it stops
	NoKeepAlive bool `json:"no-keep-alive"`
}

Machine struct

func MachineFromFile

func MachineFromFile(n string) (*Machine, error)

MachineFromFile loads a vm config from file

func (*Machine) Run

func (m *Machine) Run(ctx context.Context, socket, logs string) error

Run run the machine with cloud-hypervisor

func (*Machine) Save

func (m *Machine) Save(n string) error

Save saves a machine into a file

type MemMib

type MemMib int64

MemMib is memory size in mib

func (MemMib) String

func (m MemMib) String() string

type Module

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

Module implements the VMModule interface

func NewVMModule

func NewVMModule(cl zbus.Client, root string) (*Module, error)

NewVMModule creates a new instance of vm manager

func (*Module) Delete

func (m *Module) Delete(name string) error

Delete deletes a machine by name (id)

func (*Module) Exists

func (m *Module) Exists(id string) bool

Exists checks if firecracker process running for this machine

func (*Module) Inspect

func (m *Module) Inspect(name string) (pkg.VMInfo, error)

Inspect a machine by name

func (*Module) List

func (m *Module) List() ([]string, error)

List all running vms names

func (*Module) Logs

func (m *Module) Logs(name string) (string, error)

Logs returns machine logs for give machine name

func (*Module) Monitor

func (m *Module) Monitor(ctx context.Context)

Monitor start vms monitoring

func (*Module) Run

func (m *Module) Run(vm pkg.VM) error

Run vm