Configuration rollout, rollback, and long polling
Treat configuration as versioned runtime state instead of a mutable key-value record.
A configuration center must control how changes become visible. Editing a value, publishing a version, selecting a rollout scope, and delivering an update to listeners are separate operations.
Confirmed facts
- Max config content length: 20,000 characters.
- Max page size: 100.
- Publish, progressive delivery, and rollback are supported.
- One file can keep multiple active gray releases; full publish does not end them; stop-gray is per release.
- When a client matches several grays, the newest by version/mtime wins.
- Clients watch via SSE or long polling.
- Pole Agent confirmed writes become drafts only; humans still publish.
Recommended rhythm
- Create the group and file in the correct Namespace.
- Edit the draft and validate content.
- Publish one or more grays by client labels; watch hits under Release history → Gray and Subscriptions.
- “Submit as formal draft” on the validated gray, then full-publish; keep or stop other grays independently.
- On issues, roll back full or stop the relevant gray; audit History.
Open measurements
This site does not publish listener latency or concurrency claims without reproducible benchmarks.