pbflags-evaluator

Documentation

Overview

Binary pbflags-evaluator is the read-only flag resolution service.

DB-backed mode (reads flag definitions and state from PostgreSQL):

pbflags-evaluator --database=postgres://readonly@localhost:5432/flags

Upstream proxy mode (forwards to another evaluator, no database needed):

pbflags-evaluator --upstream=http://root-evaluator:9201

Exactly one of --database or --upstream is required.

Flags can also be supplied via picocli-style @file references:

pbflags-evaluator @config.flags

Environment variables override CLI flags:

PBFLAGS_DATABASE            PostgreSQL connection string (readonly)
PBFLAGS_UPSTREAM            Upstream evaluator URL
PBFLAGS_LISTEN              Evaluator listen address (default: localhost:9201)
PBFLAGS_CACHE_KILL_TTL      Kill set cache TTL (default: 30s)
PBFLAGS_CACHE_FLAG_TTL      Global flag state cache TTL (default: 10m)
PBFLAGS_CACHE_OVERRIDE_TTL  Per-entity override cache TTL (default: 10m)