Skip to content
This repository was archived by the owner on Nov 8, 2026. It is now read-only.

Latest commit

 

History

History
38 lines (29 loc) · 1.61 KB

README.md

File metadata and controls

38 lines (29 loc) · 1.61 KB

Gateway / Engine / Worker quickstart

This example runs Gateway, Engine and Worker as separate containers with real MongoDB and Kafka. Run make quickstart to start them and exercise the public API.

docker compose --env-file /dev/null -f examples/quickstart/compose.yaml build
docker compose --env-file /dev/null -f examples/quickstart/compose.yaml up -d --wait

The public endpoint is 127.0.0.1:8080. Gateway, Engine and Worker metrics are at ports 9090, 19091 and 19092, respectively. Their separate health ports are 8081, 18081, and 18082. Check producer readiness with http://127.0.0.1:18081/readyz?service=sink.kafka.primary and Worker readiness with http://127.0.0.1:18082/readyz before testing async completion.

With the existing sink-go checkout, exercise the public contract:

cd ../sink-go
SINK_INTEGRATION_ADDRESS=127.0.0.1:8080 go test -race -tags=integration \
  -run '^(TestSinkCompatibility|TestNativeCompatibility)$' -count=1

Stop the example with:

docker compose --env-file /dev/null -f examples/quickstart/compose.yaml down

Store routes are configured in gateway.yaml under forwarding.routes. Engine and Worker mount the same store.yaml and load it with --store-config. All listed routes are active. Restart Gateway after changing its configuration.

For another Store, add its own database target, Engine, Worker and route. Replicas of one Store share that Store file's name; different Stores must not share a database target. The example's plaintext route is for the local Compose network. See configuration and scaling.