tart

Documentation

Index

• Variables
• func Cleanup() error
• func Cmd(ctx context.Context, additionalEnvironment map[string]string, name string, ...) (string, string, error)
• func CmdWithLogger(ctx context.Context, additionalEnvironment map[string]string, ...) (string, string, error)
• func Installed() bool
• func PrePull(ctx context.Context, image string, logger *echelon.Logger) error
• type Info
• type Option
  • func WithDiskSize(diskSize uint32) Option
  • func WithDisplay(display string) Option
  • func WithLogger(logger logger.Lightweight) Option
  • func WithSoftnet() Option
  • func WithVolumes(volumes []*api.Isolation_Tart_Volume) Option
• type Tart
  • func New(vmName string, sshUser string, sshPassword string, sshPort uint16, cpu uint32, ...) (*Tart, error)
  • func (tart *Tart) Attributes() []attribute.KeyValue
  • func (tart *Tart) Close(ctx context.Context) error
  • func (tart *Tart) Image() string
  • func (tart *Tart) Run(ctx context.Context, config *runconfig.RunConfig) (err error)
  • func (tart *Tart) Warmup(ctx context.Context, ident string, additionalEnvironment map[string]string, ...) error
  • func (tart *Tart) WorkingDirectory(projectDir string, dirtyMode bool) string
• type VM
  • func NewVMClonedFrom(ctx context.Context, from string, to string, lazyPull bool, ...) (*VM, error)
  • func (vm *VM) Close() error
  • func (vm *VM) Configure(ctx context.Context, cpu uint32, memory uint32, diskSize uint32, ...) error
  • func (vm *VM) ErrChan() chan error
  • func (vm *VM) Ident() string
  • func (vm *VM) Info(ctx context.Context) (*Info, error)
  • func (vm *VM) RetrieveIP(ctx context.Context) (string, error)
  • func (vm *VM) Start(ctx context.Context, softnet bool, directoryMounts []directoryMount)

Variables

var (
	ErrTartNotFound = errors.New("tart command not found")
	ErrTartFailed   = errors.New("tart command returned non-zero exit code")
)

var (
	ErrFailed     = errors.New("tart isolation failed")
	ErrSyncFailed = errors.New("failed to sync project directory")
)

Functions

func Cleanup

func Cleanup() error

func Cmd

func Cmd(
	ctx context.Context,
	additionalEnvironment map[string]string,
	name string,
	args ...string,
) (string, string, error)

func CmdWithLogger

func CmdWithLogger(
	ctx context.Context,
	additionalEnvironment map[string]string,
	logger *echelon.Logger,
	name string,
	args ...string,
) (string, string, error)

func Installed

func Installed() bool

func PrePull

func PrePull(ctx context.Context, image string, logger *echelon.Logger) error

Types

type Info

type Info struct {
	OS string `json:"os"`
}

type Option

type Option func(*Tart)

func WithDiskSize

func WithDiskSize(diskSize uint32) Option

func WithDisplay

func WithDisplay(display string) Option

func WithLogger

func WithLogger(logger logger.Lightweight) Option

func WithSoftnet

func WithSoftnet() Option

func WithVolumes

func WithVolumes(volumes []*api.Isolation_Tart_Volume) Option

type Tart

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

func New

func New(
	vmName string,
	sshUser string,
	sshPassword string,
	sshPort uint16,
	cpu uint32,
	memory uint32,
	opts ...Option,
) (*Tart, error)

func (*Tart) Attributes

func (tart *Tart) Attributes() []attribute.KeyValue

func (*Tart) Close

func (tart *Tart) Close(ctx context.Context) error

func (*Tart) Image

func (tart *Tart) Image() string

func (*Tart) Run

func (tart *Tart) Run(ctx context.Context, config *runconfig.RunConfig) (err error)

func (*Tart) Warmup

func (tart *Tart) Warmup(
	ctx context.Context,
	ident string,
	additionalEnvironment map[string]string,
	logger *echelon.Logger,
) error

func (*Tart) WorkingDirectory

func (tart *Tart) WorkingDirectory(projectDir string, dirtyMode bool) string

type VM

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

func NewVMClonedFrom

func NewVMClonedFrom(
	ctx context.Context,
	from string,
	to string,
	lazyPull bool,
	env map[string]string,
	logger *echelon.Logger,
) (*VM, error)

func (*VM) Close

func (vm *VM) Close() error

func (*VM) Configure

func (vm *VM) Configure(
	ctx context.Context,
	cpu uint32,
	memory uint32,
	diskSize uint32,
	display string,
	logger *echelon.Logger,
) error

func (*VM) ErrChan

func (vm *VM) ErrChan() chan error

func (*VM) Ident

func (vm *VM) Ident() string

func (*VM) Info

func (vm *VM) Info(ctx context.Context) (*Info, error)

func (*VM) RetrieveIP

func (vm *VM) RetrieveIP(ctx context.Context) (string, error)

func (*VM) Start

func (vm *VM) Start(
	ctx context.Context,
	softnet bool,
	directoryMounts []directoryMount,
)