pbflags-server

Overview ¶

Binary pbflags-server is the feature flag evaluation service. It reads proto descriptors at startup, builds a defaults registry, and serves the FlagEvaluatorService Connect API. Flag state comes from either direct database access (root mode) or an upstream evaluator (proxy mode).

Root mode:

pbflags-server --database=postgres://... --descriptors=descriptors.pb

Proxy mode:

pbflags-server --server=http://root-evaluator:9201 --descriptors=descriptors.pb

Combined mode (root + embedded admin):

pbflags-server --database=postgres://... --descriptors=descriptors.pb --admin=:9200

Environment variables override config file values:

PBFLAGS_DESCRIPTORS  Path to descriptors.pb
PBFLAGS_SERVER       Upstream evaluator URL (proxy mode)
PBFLAGS_LISTEN       Evaluator listen address
PBFLAGS_ADMIN        Admin listen address (enables combined mode)
PBFLAGS_DATABASE     PostgreSQL connection string (root mode)