daemon

package

v1.3.1 Latest Latest Go to latest Published: Jun 29, 2026 License: MIT Imports: 19 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/a-novel-kit/stack

Links

Open Source Insights

Documentation ¶

Overview ¶

Package daemon owns the daemon's process lifecycle: socket listener, graceful shutdown, signal handling, and (later) recovery of orphan containers. The actual RPC handlers live in internal/daemon/server.

Index ¶

func Run(ctx context.Context, opts Options) error
type Options

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Run ¶

func Run(ctx context.Context, opts Options) error

Run starts the daemon: binds the unix socket, serves connect-rpc until ctx is cancelled or a shutdown signal arrives, then cleans up the socket file. Blocks until the daemon exits — callers wanting a background daemon must fork the process themselves (see cli/core/start).

Types ¶

type Options ¶

type Options struct {
	Version    string         // daemon binary version
	SocketPath string         // override; default paths.Socket()
	Stacks     []stacks.Stack // override; default stacks.ParseEnv()
}

Options configures Run.

Source Files ¶

View all Source files

daemon.go

Directories ¶

Path	Synopsis
discovery Package discovery parses each stack's per-service podman-compose.yaml files and exposes the result as a structured model (services, targets, infra, volumes, networks, dependency graph).	Package discovery parses each stack's per-service podman-compose.yaml files and exposes the result as a structured model (services, targets, infra, volumes, networks, dependency graph).
env Package env owns the daemon's environment-variable handling: port allocation (with refcounting), value synthesis (HOST / URL for allocated ports), cross-service propagation, and operator un-prefix —.	Package env owns the daemon's environment-variable handling: port allocation (with refcounting), value synthesis (HOST / URL for allocated ports), cross-service propagation, and operator un-prefix —.
logs Package logs owns the daemon-side log storage and streaming hub.	Package logs owns the daemon-side log storage and streaming hub.
reinstall Package reinstall implements the daemon's reinstall-handoff checkpoint.	Package reinstall implements the daemon's reinstall-handoff checkpoint.
runner Package runner owns the daemon-side process supervision: spawning targets in either go-exec or container mode, tracking each instance's lifecycle (phase / exit-reason / health), and enforcing the lifecycle invariants (mutual exclusion, dependency-walk gating, idempotency).	Package runner owns the daemon-side process supervision: spawning targets in either go-exec or container mode, tracking each instance's lifecycle (phase / exit-reason / health), and enforcing the lifecycle invariants (mutual exclusion, dependency-walk gating, idempotency).
server Package server implements anovel.v1.CoreService.	Package server implements anovel.v1.CoreService.
volumes Package volumes owns the daemon-side volume operations: list, backup, restore, clear — all service-scoped.	Package volumes owns the daemon-side volume operations: list, backup, restore, clear — all service-scoped.

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