Skip to main content

Module guest

Module guest 

Source
Expand description

Guest plugin runtime - exposes a GuestPlugin as a gRPC server.

Guest plugins run inside a VM. The daemon is the gRPC client; this runtime spins up the matching server using the GuestPlugin trait implementation.

Module layout:

  • self - GuestRuntime, GuestRuntimeConfig (public API)
  • files - file push/pull and path-traversal protection
  • stream - result streaming + log entry conversion
  • collector - auto-collection logic

Modulesยง

collector ๐Ÿ”’
Auto-collection of artifact and external log files after task execution.
files ๐Ÿ”’
File push/pull and path resolution helpers for the guest runtime.
stream ๐Ÿ”’
Result streaming + log entry conversion for the guest runtime.

Structsยง

AutoCollectRuntimeConfig
Auto-collection settings for a single directory (artifacts or external logs).
GuestRuntime
Runtime for GuestPlugin implementations.
GuestRuntimeConfig
Configuration for the guest plugin runtime.
GuestService ๐Ÿ”’
Internal gRPC service implementation that delegates RPCs to a GuestPlugin.

Functionsยง

sweep_log_overflow_orphans
Sweep log overflow files older than 10 minutes. Called once on runtime startup to clean up orphans from prior crashed runs.