firecracker

type BalloonDeviceConfig struct {
	// AmountMib is the target balloon size in MiB.
	AmountMib int64 `json:"amount_mib"`
	// DeflateOnOOM  when set to true will deflate the balloon in case the guest is out of memory.
	DeflateOnOOM bool `json:"deflate_on_oom"`
	// StatsPollingInterval is the interval in seconds between refreshing statistics.
	StatsPollingInterval int64 `json:"stats_polling_interval_s"`
}

type BlockDeviceConfig struct {
	// ID is the unique identifier of the drive.
	ID string `json:"drive_id"`
	// PathOnHost is the path of the drive on the host machine.
	PathOnHost string `json:"path_on_host"`
	// IsRootDevice when true makes the current device the root block device.
	// Setting this flag to true will mount the block device in the
	// guest under /dev/vda unless the partuuid is present.
	IsRootDevice bool `json:"is_root_device"`
	// PartUUID represents the unique id of the boot partition of this device. It is
	// optional and it will be used only if the `IsRootDevice` field is true.
	PartUUID string `json:"partuuid,omitempty"`
	// IsReadOnly when true the drive is opened in read-only mode. Otherwise, the
	// drive is opened as read-write.
	IsReadOnly bool `json:"is_read_only"`
	// CacheType indicates whether the drive will ignore flush requests coming from
	// the guest driver.
	CacheType CacheType `json:"cache_type"`
}

type BootSourceConfig struct {
	// KernelImagePage is the path of the kernel image.
	KernelImagePage string `json:"kernel_image_path"`
	// InitrdPath is the path of the initrd, if there is one.
	InitrdPath *string `json:"initrd_path,omitempty"`
	// BootArgs contains the boot arguments to pass to the kernel. If this field is uninitialized, the default
	// kernel command line is used: `reboot=k panic=1 pci=off nomodules 8250.nr_uarts=0`.
	BootArgs *string `json:"boot_args,omitempty"`
}

type CacheType string

type Config struct {
	// FirecrackerBin is the firecracker binary to use.
	FirecrackerBin string
	// StateRoot is the folder to store any required firecracker state (i.e. socks, pid, log files).
	StateRoot string
	// RunDetached indicates that the firecracker processes should be run detached (a.k.a daemon) from the parent process.
	RunDetached bool
	// DeleteVMTimeout is the timeout to wait for the microvm to be deleted.
	DeleteVMTimeout time.Duration
}

type ConfigOption func(cfg *VmmConfig) error

type FileEngineType string

type InstanceState string

type LogLevel string

type LoggerConfig struct {
	// LogPath is the named pipe or file used as output for logs.
	LogPath string `json:"log_path"`
	// Level is the level of the logger.
	Level LogLevel `json:"level"`
	// ShowLevel when set to true the logger will append to the output the severity of the log entry.
	ShowLevel bool `json:"show_level"`
	// ShowLogOrigin when set to true the logger will append the origin of the log entry.
	ShowLogOrigin bool `json:"show_log_origin"`
}

type MMDSConfig struct {
	// Version specifies the MMDS version to use. If not specified it will default to V1. Supported values are V1 & V2.
	Version MMDSVersion `json:"version,omitempty"`
	// NetworkInterfaces specifies the interfaces that allow forwarding packets to MMDS.
	NetworkInterfaces []string `json:"network_interfaces,omitempty"`
	// IPV4Address is the MMDS IPv4 configured address.
	IPV4Address *string `json:"ipv4_address,omitempty"`
}

type MMDSVersion string

type MachineConfig struct {
	// VcpuCount is the number of vcpu to start.
	VcpuCount int64 `json:"vcpu_count"`
	// MemSizeMib is the memory size in MiB.
	MemSizeMib int64 `json:"mem_size_mib"`
	// SMT enables or disabled hyperthreading.
	SMT bool `json:"smt"`
	// CPUTemplate is a CPU template that it is used to filter the CPU features exposed to the guest.
	CPUTemplate *string `json:"cpu_template,omitempty"`
	// TrackDirtyPages enables or disables dirty page tracking. Enabling allows incremental snapshots.
	TrackDirtyPages bool `json:"track_dirty_pages"`
}

type Metadata struct {
	Latest map[string]string `json:"latest"`
}

type MetricsConfig struct {
	// Path is the named pipe or file used as output for metrics.
	Path string `json:"metrics_path"`
}

type NetworkInterfaceConfig struct {
	// IfaceID is the ID of the guest network interface.
	IfaceID string `json:"iface_id"`
	// HostDevName is the host level path for the guest network interface.
	HostDevName string `json:"host_dev_name"`
	// GuestMAC is the mac address to use.
	GuestMAC string `json:"guest_mac,omitempty"`
}

type State interface {
	Root() string

	PID() (int, error)
	PIDPath() string
	SetPid(pid int) error

	LogPath() string
	MetricsPath() string
	StdoutPath() string
	StderrPath() string

	ConfigPath() string
	Config() (VmmConfig, error)
	SetConfig(cfg *VmmConfig) error

	MetadataPath() string
	Metadata() (Metadata, error)
	SetMetadata(meta *Metadata) error
}

type VmmConfig struct {
	// Balloon hols the balloon device configuration.
	Balloon *BalloonDeviceConfig `json:"balloon,omitempty"`
	// BlockDevices is the configuration for the drives.
	BlockDevices []BlockDeviceConfig `json:"drives"`
	// BootSourec is the boot source configuration for the microvm.
	BootSource BootSourceConfig `json:"boot-source"`
	// Logger is the logger configuration.
	Logger *LoggerConfig `json:"logger,omitempty"`
	// MachineConfig contains the microvm machine config.
	MachineConfig MachineConfig `json:"machine-config"`
	// Metrics is the metrics configuration.
	Metrics *MetricsConfig `json:"metrics,omitempty"`
	// Mmds is the configuration for the metadata service
	Mmds *MMDSConfig `json:"mmds-config,omitempty"`
	// NetDevices is the configuration for the microvm network devices.
	NetDevices []NetworkInterfaceConfig `json:"network-interfaces"`
	// VsockDevice is the configuration for the vsock device.
	VsockDevice *VsockDeviceConfig `json:"vsock,omitempty"`
}

type VsockDeviceConfig struct {
	// ID of the vsock device.
	ID string `json:"vsock_id"`
	// GuestCID is a 32-bit Context Identifier (CID) used to identify the guest.
	GuestCID int64 `json:"guest_cid"`
	// UDSPath is the path to local unix socket.
	UDSPath string `json:"uds_path"`
}