Class QNodeRoles

java.lang.Object

com.kingsrook.qqq.backend.core.cluster.QNodeRoles

public final class QNodeRoles
extends Object

What this node of a multi-node application does (docs/specs/ 2026-10-15-cluster-ha-design.md, section A). Core stays orchestrator-agnostic: roles come from the environment (or system properties), read once. QQQ_NODE_ROLES (qqq.node.roles): comma list of web, worker, scheduler, esb, or "all" (the default - a single node does everything, as before). Explicit per-feature flags win over the role list: - QQQ_HTTP_ENABLED (qqq.http.enabled): serve application routes (probes and metrics are always served); - QQQ_SCHEDULE_MANAGER_ENABLED (qqq.scheduleManager.enabled): start schedulers; - QQQ_ESB_TRIGGERS_ENABLED (qqq.esb.triggers.enabled): run ESB trigger consumers; - QQQ_JOBS_WORKER_THREADS (qqq.jobs.workerThreads): durable job worker threads (without it, a node without the worker role runs 0). The node id is QQQ_NODE_ID, else HOSTNAME (the pod name), else the host name.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	QNodeRoles.Role	A node role.
static final record	QNodeRoles.Settings	The resolved settings of this node.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ENV_ESB_TRIGGERS
static final String	ENV_HTTP
static final String	ENV_NODE_ID
static final String	ENV_ROLES
static final String	ENV_SCHEDULER
static final String	ENV_WORKER_THREADS

Method Summary

Modifier and Type	Method	Description
static QNodeRoles.Settings	get()	This node's settings, resolved on first use.
static boolean	has(QNodeRoles.Role role)	Shorthand: whether this node has the role.
static String	nodeId()	Shorthand: this node's id.
static void	set(QNodeRoles.Settings newSettings)	Replace the settings (tests, or an app that assigns roles itself before the server starts).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ENV_ROLES

public static final String ENV_ROLES

See Also:

• Constant Field Values

ENV_HTTP

public static final String ENV_HTTP

See Also:

• Constant Field Values

ENV_SCHEDULER

public static final String ENV_SCHEDULER

See Also:

• Constant Field Values

ENV_ESB_TRIGGERS

public static final String ENV_ESB_TRIGGERS

See Also:

• Constant Field Values

ENV_WORKER_THREADS

public static final String ENV_WORKER_THREADS

See Also:

• Constant Field Values

ENV_NODE_ID

public static final String ENV_NODE_ID

See Also:

• Constant Field Values

Method Details

get

public static QNodeRoles.Settings get()

This node's settings, resolved on first use.

set

public static void set(QNodeRoles.Settings newSettings)

Replace the settings (tests, or an app that assigns roles itself before the server starts). Null re-reads the environment on next use.

nodeId

public static String nodeId()

Shorthand: this node's id.

has

public static boolean has(QNodeRoles.Role role)

Shorthand: whether this node has the role.