keaz/flux-gate-edge repository overview

FluxGate Edge is the high‑performance evaluation service for FluxGate, delivering low‑latency, context‑aware feature decisions to your applications. It keeps a live sync with the FluxGate Control Plane and optionally reports evaluation analytics.

Full documentation can be found here https://github.com/keaz/fluxgate/tree/main⁠

What is this image? • Serves feature evaluations over a simple HTTP API • Keeps an up‑to‑date in‑memory snapshot by subscribing to the Control Plane’s update stream • Optionally pushes evaluation analytics at configurable intervals • Stateless and horizontally scalable

Key capabilities • Fast, cached evaluations for your apps • Context targeting and percentage rollouts (sticky bucketing) • Optional analytics batching and delivery to the Control Plane • Health endpoint for readiness/liveness checks

Tags and architectures • Tags: latest, 1.x.y (semantic versions) • Architectures: linux/amd64, linux/arm64 (as available per release)

Exposed ports • 8081/tcp — Evaluation API (HTTP)

Quick start Prerequisites: a reachable FluxGate Control Plane endpoint and valid client credentials.

Run:

docker run -d \
  --name fluxgate-edge \
  -p 8081:8081 \
  -e EDGE_BACKEND_GRPC="http://control-plane:50051" \
  -e EDGE_HTTP_ADDR="0.0.0.0:8081" \
  -e EDGE_CLIENT_ID="{{CLIENT_ID_UUID}}" \
  -e EDGE_CLIENT_SECRET="{{CLIENT_API_KEY}}" \
  keaz/flux-gate-edge:1.0.0

Health check:

curl -sS http://localhost:8081/health
# OK (HTTP 200 when connected to the Control Plane stream)

Evaluate example:

curl -sS -X POST http://localhost:8081/evaluate \
  -H "Content-Type: application/json" \
  -d '{
    "feature_key": "my-feature",
    "environment_id": "production",
    "context": [
      {"key": "user.id", "value": "user-123"},
      {"key": "country", "value": "US"}
    ]
  }'
# => {"enabled": true|false}