image

type BuildConfig struct {
	// Name is the image name (e.g. "hello").
	Name string
	// Tag is the image tag (default "latest" if empty).
	Tag string
	// BinaryPath is the path to the static ELF binary to package.
	BinaryPath string
	// ProgramPath, when non-empty, is the in-image guest path at which the
	// program is placed and from which it is executed (e.g.
	// "usr/local/postgresql/bin/postgres"). The Nanos manifest's program field,
	// argv[0], and /proc/self/exe all resolve to this path, so binaries that
	// locate their installation prefix relative to their own executable (e.g.
	// postgres) and binaries with $ORIGIN-relative RPATHs resolve correctly.
	// Empty places the program flat at /program (the default for compiled and
	// interpreted-runtime builds, where the layout is irrelevant).
	ProgramPath string
	// MkfsRun invokes mkfs to produce the disk image.
	// Use internal/tools.ResolveMkfs to obtain a platform-appropriate func.
	MkfsRun MkfsFunc
	// Memory is the default VM memory string (e.g. "256M").
	Memory string
	// CPUs is the default number of virtual CPUs.
	CPUs int
	// PkgFiles is a list of package files to include in the image.
	// Each entry carries both the host path (on the build machine) and the
	// guest path (inside the Nanos image). For jerboa packages, GuestPath is
	// typically filepath.Base(HostPath). For ops packages, GuestPath
	// preserves the sysroot/ hierarchy (e.g. "lib/x86_64-linux-gnu/libc.so").
	PkgFiles []pkg.File
	// Entrypoint is the script or file to pass as the first argument to the
	// runtime binary (e.g. "hi.js" for Node.js). Empty for compiled languages.
	// Emitted with a leading "/" (image-root-relative).
	Entrypoint string
	// Args holds additional argv elements appended after Entrypoint (if set).
	// Used by lang="raw" builds to pass arguments to the resolved program
	// (e.g. ["-jar", "/app.jar"]). Each element is emitted as-is — use
	// absolute in-image paths for file arguments.
	Args []string
	// Env holds runtime environment variables to bake into the image manifest.
	// Sourced from ops package.manifest Env fields and language driver output.
	Env map[string]string
	// Port is the service port declared for the image. It is metadata only:
	// network config is injected at run time (fw_cfg / boot args), not baked
	// into the manifest.
	Port int
	// Ports holds default host:guest port-publish specs (from [run] ports).
	// Stored in the image manifest and applied at run time when the VM joins a
	// network and no -p flag is given.
	Ports []string
	// DiskSize is the minimum image file size passed to mkfs (e.g. "512M", "1G").
	// When non-empty, emitted as imagesize in the Nanos manifest so mkfs pads
	// the image to at least that size, leaving free space for runtime writes.
	DiskSize string
	// Output is where mkfs subprocess output is written. Nil defaults to os.Stderr.
	Output io.Writer
}

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

type Config struct {
	// Memory is the default QEMU memory string (e.g. "256M").
	Memory string `json:"memory"`
	// CPUs is the default number of virtual CPUs.
	CPUs int `json:"cpus"`
	// Env is the list of environment variables passed to the application.
	Env []string `json:"env,omitempty"`
	// Ports holds default host:guest port-publish specs (from [run] ports in
	// unikernel.toml). They are applied at run time when the VM joins a network
	// and no -p flag is given, so an image can declare the ports it serves.
	Ports []string `json:"ports,omitempty"`
}

type Manifest struct {
	// SchemaVersion must equal SchemaVersion (1).
	SchemaVersion int `json:"schemaVersion"`
	// Name is the image name (e.g. "hello").
	Name string `json:"name"`
	// Tag is the image tag (e.g. "latest").
	Tag string `json:"tag"`
	// Created is the build timestamp.
	Created time.Time `json:"created"`
	// Config holds default VM parameters.
	Config Config `json:"config"`
	// DiskDigest is the sha256 digest of the raw disk image ("sha256:<hex>").
	DiskDigest string `json:"diskDigest"`
	// DiskSize is the byte size of the raw disk image.
	DiskSize int64 `json:"diskSize"`
}

type MkfsFunc func(ctx context.Context, imgPath, binaryPath string, manifest string) *exec.Cmd

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