runner

package
v0.17.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 11, 2026 License: Apache-2.0 Imports: 26 Imported by: 0

Documentation

Index

Constants

View Source
const (
	DefaultInviteExpiryHours = 1
	MaxInviteExpiryHours     = 168 // 7 days

)

Variables

This section is empty.

Functions

This section is empty.

Types

type LbdBuilderImageEnsurer added in v0.17.0

type LbdBuilderImageEnsurer interface {
	EnsureLbdBuilderImage(ctx context.Context) (string, error)
}

LbdBuilderImageEnsurer builds the lbd toolchain image into the cluster registry if it is not already there. servers/build.Builder implements it; this is an interface so the runner registration server does not depend on the whole build server to ask one question of it.

type RegistrationServer

type RegistrationServer struct {
	RegistrationServerConfig
}

func (*RegistrationServer) CordonRunner added in v0.11.0

CordonRunner marks a runner unschedulable without disrupting its running sandboxes. The scheduler stops placing new work on the node; existing sandboxes keep running.

func (*RegistrationServer) CreateInvite

func (*RegistrationServer) DrainRunner added in v0.11.0

DrainRunner cordons a runner and evicts its sandboxes so app controllers reschedule them onto other ready nodes. It marks each scheduled sandbox STOPPED — the same action the sandbox pool takes during a crash cooldown — which makes the owning runner tear down its local container (via its node-scoped watch on the sandbox status) and lets the pool controllers recreate the capacity elsewhere. The sandbox entities themselves are left in place (STOPPED, not deleted), as are disk mounts, volumes, and leases (unlike RemoveRunner --force). It blocks until no live sandboxes remain on the node or the timeout elapses, then reports how many sandboxes were evicted.

func (*RegistrationServer) InstallDiskAccelerator added in v0.17.0

InstallDiskAccelerator builds and loads the lbd kernel module on a runner.

The work splits across two machines. The toolchain image is built once, here, because the coordinator is where BuildKit and the registry live. The module itself is built on the target node, because it has to be compiled against the kernel running there and loaded into it.

Failures come back in the result rather than as an RPC error, so an operator sees why the install did not happen.

func (*RegistrationServer) IssueSystemWorkloadToken added in v0.13.0

IssueSystemWorkloadToken mints a system workload identity token on behalf of a distributed runner, which does not hold the cluster signing key. The caller is an mTLS-authenticated runner, and the workload it may request is constrained by runnerSystemWorkloads.

func (*RegistrationServer) IssueWorkloadToken added in v0.10.0

IssueWorkloadToken mints a workload identity token for a sandbox on behalf of a distributed runner, which does not hold the cluster signing key. The caller is an mTLS-authenticated runner.

func (*RegistrationServer) Join

func (*RegistrationServer) ListInvites

func (*RegistrationServer) ListRunners

func (*RegistrationServer) Query added in v0.17.0

func (*RegistrationServer) QueryInfo added in v0.17.0

func (*RegistrationServer) RefreshCertificate added in v0.10.0

RefreshCertificate re-issues the calling runner's server certificate with SANs derived from its current listen address. A runner needs this when its listen IP changes but its persisted certificate (e.g. on a disk that outlives the VM) still carries the old IP. The method is public at the RPC layer but authorizes the caller here: the presented client certificate must chain to the cluster CA and be a runner certificate, and the re-issued certificate keeps that certificate's CommonName so a runner can only refresh its own identity.

func (*RegistrationServer) RemoveRunner added in v0.7.0

func (*RegistrationServer) RevokeInvite

func (*RegistrationServer) UncordonRunner added in v0.11.0

UncordonRunner clears a runner's cordon, making it eligible for scheduling again.

func (*RegistrationServer) ValidateQuery added in v0.17.0

func (*RegistrationServer) WorkloadIssuerInfo added in v0.10.0

WorkloadIssuerInfo reports the issuer and current coordinator internal address. Distributed runners read both at startup, including when identity is disabled.

type RegistrationServerConfig added in v0.7.0

type RegistrationServerConfig struct {
	Log                   *slog.Logger
	Authority             *caauth.Authority
	EAC                   *entityserver_v1alpha.EntityAccessClient
	CoordinatorAddr       string
	CoordinatorInternalIP netip.Addr
	EtcdEndpoints         []string
	EtcdPrefix            string

	// Observability endpoints provided to runners at join time
	VictoriametricsAddress string
	VictorialogsAddress    string

	// WorkloadIssuer mints workload identity tokens. Distributed runners, which
	// do not hold the cluster signing key, request tokens from the coordinator
	// through this server. May be nil when no issuer is configured.
	WorkloadIssuer *workloadidentity.Issuer

	// LbdBuilder builds the lbd toolchain image into the cluster registry, so
	// a node has something to pull before it compiles the kernel module. Nil
	// on a cluster with no BuildKit, where accelerator mode is unavailable.
	LbdBuilder LbdBuilderImageEnsurer

	// RPC is how the coordinator reaches a specific runner. Installing the
	// kernel module has to happen on the node itself, so unlike the rest of
	// this server it is not enough to write an entity and wait.
	RPC *rpc.State
}

Jump to

Keyboard shortcuts

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