admin/cloud-services
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7784b81c05fdc56fe0562f0aa2a172957a55bbef
cloud-services/services/gateway/README.md

1.0 KiB
Raw Blame History

Gateway Service

WebSocket API gateway for vehicle (TRex), HMI, and mobile app connections.

What it does

  • Authenticates WebSocket connections via JWT
  • Routes messages to Kafka topics
  • Manages connection state in Redis
  • Serves Swagger docs

Ports

Port Purpose
8077 HTTP/WebSocket
11011 Health check

WebSocket Endpoints

  • /ws/trex - Vehicle connections
  • /ws/hmi - HMI connections
  • /ws/mobile - Mobile app connections

Build

# Local
go build .

# Docker
docker build -t gateway -f Dockerfile ../..

Run

# Required env vars
export KAFKA_HOSTS=localhost:9092
export REDIS_HOST=localhost
export JWK_URL=https://keycloak.example.com/realms/consumer/protocol/openid-connect/certs

./gateway

Configuration

See deploy/base/configmap-common.yaml for all options.

Key settings:

  • KAFKA_HOSTS - Kafka bootstrap servers
  • REDIS_HOST/PORT - Redis for session state
  • JWK_URL - JWKS endpoint for JWT validation
  • LOG_LEVEL - debug, info, warn, error