config

type Config struct {
	APIVersion string `json:"api_version"`

	// Address for the server to listen on.
	Address string `json:"address"`

	// DataDir is the root directory for GPUd state and package artifacts.
	DataDir string `json:"data_dir"`

	// State file that persists the latest status.
	// If empty, the states are not persisted to file.
	State string `json:"state"`

	// Amount of time to retain states/metrics for.
	// Once elapsed, old states/metrics are purged/compacted.
	RetentionPeriod metav1.Duration `json:"retention_period"`

	// Interval at which to compact the state database.
	CompactPeriod metav1.Duration `json:"compact_period"`

	// Set true to enable profiler.
	Pprof bool `json:"pprof"`

	// Set false to disable auto update
	EnableAutoUpdate bool `json:"enable_auto_update"`

	// Exit code to exit with when auto updating.
	// Only valid when the auto update is enabled.
	// Set -1 to disable the auto update by exit code.
	AutoUpdateExitCode int `json:"auto_update_exit_code"`

	// VersionFile is the file that contains the target version.
	// If empty, the version file is not used.
	VersionFile string `json:"version_file"`

	// A list of nvidia tool command paths to overwrite the default paths.
	NvidiaToolOverwrites pkgconfigcommon.ToolOverwrites `json:"nvidia_tool_overwrites"`

	// PluginSpecsFile is the file that contains the plugin specs.
	PluginSpecsFile string `json:"plugin_specs_file"`

	// Components specifies the components to enable.
	// Leave empty, "*", or "all" to enable all components.
	// Or prefix component names with "-" to disable them.
	Components []string `json:"components"`

	// FailureInjector is the failure injector.
	FailureInjector *components.FailureInjector `json:"failure_injector,omitempty"`

	// SkipSessionUpdateConfig skips processing of updateConfig session commands. Intended for testing.
	SkipSessionUpdateConfig bool `json:"skip_session_update_config"`

	// DBInMemory enables in-memory SQLite database mode.
	// When true, the database is opened as a shared in-memory database (file::memory:?cache=shared)
	// instead of using the State file path. Data will not persist across restarts.
	// ref. https://github.com/mattn/go-sqlite3?tab=readme-ov-file#faq
	DBInMemory bool `json:"db_in_memory"`

	// SessionToken is the session token for control plane authentication.
	// Used when DBInMemory is true and session credentials are passed via CLI flags.
	// This allows gpud up to pass the session token from login to gpud run.
	SessionToken string `json:"-"`

	// SessionMachineID is the machine ID assigned by the control plane.
	// Used when DBInMemory is true and session credentials are passed via CLI flags.
	// This allows gpud up to pass the assigned machine ID from login to gpud run.
	SessionMachineID string `json:"-"`

	// SessionEndpoint is the control plane endpoint.
	// Used when DBInMemory is true and session credentials are passed via CLI flags.
	// This allows gpud up to pass the endpoint from login to gpud run.
	// The server reads the endpoint from metadata DB, so it must be seeded for in-memory mode.
	SessionEndpoint string `json:"-"`
	// contains filtered or unexported fields
}

type Op struct {
	pkgconfigcommon.ToolOverwrites

	FailureInjector *components.FailureInjector

	DataDir    string
	DBInMemory bool

	// SessionToken is the session token for db-in-memory mode.
	// When DBInMemory is true and this is set, the server will seed
	// this token into the in-memory database.
	SessionToken string

	// SessionMachineID is the machine ID for db-in-memory mode.
	// When DBInMemory is true and this is set, the server will seed
	// this machine ID into the in-memory database.
	SessionMachineID string

	// SessionEndpoint is the control plane endpoint for db-in-memory mode.
	// When DBInMemory is true and this is set, the server will seed
	// this endpoint into the in-memory database.
	// The server reads the endpoint from metadata DB, so it must be seeded for in-memory mode.
	SessionEndpoint string
}

type OpOption func(*Op)