instances

package

Go to main page

Versions in this module

v0

v0.0.7

Mar 3, 2026

Changes in this version

+ var ErrInvalidRequest = errors.New("invalid request")

+ var ErrNotSupported = errors.New("operation not supported")

+ type ForkInstanceRequest struct

+ FromRunning bool

+ Name string

+ TargetState State

+ type ListInstancesFilter struct

+ Metadata map[string]string

+ State *State

+ func (f *ListInstancesFilter) Matches(inst *Instance) bool

type Manager

+ ForkInstance func(ctx context.Context, id string, req ForkInstanceRequest) (*Instance, error)

v0.0.6

Feb 16, 2026

Changes in this version

+ const DefaultStopTimeout

+ var ErrInsufficientResources = errors.New("insufficient resources")

type CreateInstanceRequest

+ Cmd []string

+ Entrypoint []string

+ Metadata map[string]string

+ SkipGuestAgent bool

+ SkipKernelHeaders bool

type Manager

+ GetVsockDialer func(ctx context.Context, instanceID string) (hypervisor.VsockDialer, error)

+ ListRunningInstancesInfo func(ctx context.Context) ([]resources.InstanceUtilizationInfo, error)

+ SetResourceValidator func(v ResourceValidator)

+ type ResourceValidator interface

+ ValidateAllocation func(ctx context.Context, vcpus int, memoryBytes int64, networkDownloadBps int64, ...) error

+ type StartInstanceRequest struct

+ Cmd []string

+ Entrypoint []string

type StoredMetadata

+ Cmd []string

+ Entrypoint []string

+ ExitCode *int

+ ExitMessage string

+ Metadata map[string]string

+ SkipGuestAgent bool

+ SkipKernelHeaders bool

+ StopTimeout int

v0.0.5

Jan 16, 2026

Changes in this version

type CreateInstanceRequest

+ GPU *GPUConfig

+ type GPUConfig struct

+ Profile string

type StoredMetadata

+ GPUMdevUUID string

+ GPUProfile string

v0.0.4

Jan 12, 2026

Changes in this version

+ const MaxVolumesPerInstance

+ var ErrAlreadyExists = errors.New("instance already exists")

+ var ErrAmbiguousName = errors.New("multiple instances with the same name")

+ var ErrImageNotReady = errors.New("image not ready")

+ var ErrInvalidState = errors.New("invalid state transition")

+ var ErrLogNotFound = fmt.Errorf("log file not found")

+ var ErrNotFound = errors.New("instance not found")

+ var ErrTailNotFound = fmt.Errorf("tail command not found: required for log streaming")

+ var ValidTransitions = map[State][]State

+ func NewLivenessChecker(m Manager) devices.InstanceLivenessChecker

+ func WaitForProcessExit(pid int, timeout time.Duration) bool

+ type AggregateUsage struct

+ TotalMemory int64

+ TotalVcpus int

+ type AttachVolumeRequest struct

+ MountPath string

+ Readonly bool

+ type CreateInstanceRequest struct

+ Devices []string

+ DiskIOBps int64

+ Env map[string]string

+ HotplugSize int64

+ Hypervisor hypervisor.Type

+ Image string

+ Name string

+ NetworkBandwidthDownload int64

+ NetworkBandwidthUpload int64

+ NetworkEnabled bool

+ OverlaySize int64

+ Size int64

+ Vcpus int

+ Volumes []VolumeAttachment

+ type HostTopology struct

+ CoresPerSocket int

+ Sockets int

+ ThreadsPerCore int

+ type IngressResolver struct

+ func NewIngressResolver(manager Manager) *IngressResolver

+ func (r *IngressResolver) InstanceExists(ctx context.Context, nameOrID string) (bool, error)

+ func (r *IngressResolver) ResolveInstance(ctx context.Context, nameOrID string) (string, string, error)

+ func (r *IngressResolver) ResolveInstanceIP(ctx context.Context, nameOrID string) (string, error)

+ type Instance struct

+ HasSnapshot bool

+ State State

+ StateError *string

+ func (i *Instance) GetHypervisorType() string

+ type LogSource string

+ const LogSourceApp

+ const LogSourceHypeman

+ const LogSourceVMM

+ type Manager interface

+ AttachVolume func(ctx context.Context, id string, volumeId string, req AttachVolumeRequest) (*Instance, error)

+ CreateInstance func(ctx context.Context, req CreateInstanceRequest) (*Instance, error)

+ DeleteInstance func(ctx context.Context, id string) error

+ DetachVolume func(ctx context.Context, id string, volumeId string) (*Instance, error)

+ GetInstance func(ctx context.Context, idOrName string) (*Instance, error)

+ ListInstanceAllocations func(ctx context.Context) ([]resources.InstanceAllocation, error)

+ ListInstances func(ctx context.Context) ([]Instance, error)

+ RestoreInstance func(ctx context.Context, id string) (*Instance, error)

+ RotateLogs func(ctx context.Context, maxBytes int64, maxFiles int) error

+ StandbyInstance func(ctx context.Context, id string) (*Instance, error)

+ StartInstance func(ctx context.Context, id string) (*Instance, error)

+ StopInstance func(ctx context.Context, id string) (*Instance, error)

+ StreamInstanceLogs func(ctx context.Context, id string, tail int, follow bool, source LogSource) (<-chan string, error)

+ func NewManager(p *paths.Paths, imageManager images.Manager, systemManager system.Manager, ...) Manager

+ type Metrics struct

+ type ResourceLimits struct

+ MaxMemoryPerInstance int64

+ MaxOverlaySize int64

+ MaxTotalMemory int64

+ MaxTotalVcpus int

+ MaxVcpusPerInstance int

+ type State string

+ const StateCreated

+ const StatePaused

+ const StateRunning

+ const StateShutdown

+ const StateStandby

+ const StateStopped

+ const StateUnknown

+ func (s State) CanTransitionTo(target State) error

+ func (s State) IsTerminal() bool

+ func (s State) RequiresVMM() bool

+ func (s State) String() string

+ type StoredMetadata struct

+ CreatedAt time.Time

+ DataDir string

+ Devices []string

+ DiskIOBps int64

+ Env map[string]string

+ HotplugSize int64

+ HypervisorPID *int

+ HypervisorType hypervisor.Type

+ HypervisorVersion string

+ IP string

+ Id string

+ Image string

+ KernelVersion string

+ MAC string

+ Name string

+ NetworkBandwidthDownload int64

+ NetworkBandwidthUpload int64

+ NetworkEnabled bool

+ OverlaySize int64

+ Size int64

+ SocketPath string

+ StartedAt *time.Time

+ StoppedAt *time.Time

+ Vcpus int

+ Volumes []VolumeAttachment

+ VsockCID int64

+ VsockSocket string

+ type VolumeAttachment struct

+ MountPath string

+ Overlay bool

+ OverlaySize int64

+ Readonly bool

+ VolumeID string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL