How bhangun/iket works
Iket is a Go API gateway with a CLI for setup and operation, remote management, configurable routing, authentication plugins, and rollout controls. The main runtime path starts with server configuration and gateway initialization; configured requests enter route middleware, then proxy to an upstream service. Management APIs support client and service administration, including proposals and canary rollouts. The graph preserves documented extension, storage, and observability capabilities. Some subsystems are represented at directory level because their implementation files were not sampled; those links are omitted where evidence does not establish ownership.
Main entry points: main.go Server startup · management.go Management API · gateway_routes.go Route registration · gateway.go Gateway runtime
Components 20
Operations
- Iket CLI
cmd/iket-cli/main.go - Server startup
cmd/iket/main.go
Management
- Management API
pkg/api/management.go - Service administration
pkg/api/management_services.go - Client administration
pkg/api/management_clients.go - Change proposals
pkg/api/management_proposals.go - Canary rollouts
pkg/api/management_proposal_canary_handlers.go
Gateway routing
- Gateway runtime
pkg/core/gateway/gateway.go - Route registration
pkg/core/gateway/gateway_routes.go - Request proxy
pkg/core/gateway/proxy_handler.go - BFF orchestration
pkg/core/gateway/bff_handler.go
Identity plugins
- Authentication plugins
pkg/plugin/oauth2/oauth2.go - API key plugin
pkg/plugin/apikey/apikey.go
Configuration and extensions
- Configuration
pkg/config/config.go - Config storage
pkg/config/storage_config.go - Plugin registry
pkg/plugin/registry.go - Gateway extensions
plugins - Metrics
plugins/metrics/prometheus.go
Other components
- Operator
- Upstream services
Connections 20
- Operator → Iket CLI: runs
README.md - Operator → Server startup: starts
README.md - Server startup → Configuration: loads
cmd/iket/main.go - Server startup → Config storage: configures
cmd/iket/main.go - Server startup → Management API: registers
cmd/iket/main.go - Server startup → Gateway runtime: initializes
cmd/iket/main.go - Gateway runtime → Route registration: registers
pkg/core/gateway/gateway_routes.go - Route registration → Request proxy: dispatches
pkg/core/gateway/gateway_routes.go - Request proxy → Upstream services: proxies requests
pkg/core/gateway/proxy_handler.go - Route registration → Authentication plugins: wraps with middleware
pkg/core/gateway/gateway_routes.go - Management API → Service administration: routes service changes
- Management API → Client administration: routes client operations
- Service administration → Change proposals: can propose changes
pkg/api/management_services.go - Change proposals → Canary rollouts: supports rollout
- Client administration → API key plugin: manages clients through
pkg/api/management_clients.go - Plugin registry → Gateway extensions: registers extensions
- Server startup → Plugin registry: registers plugins
cmd/iket/main.go - Server startup → Metrics: enables observability
- Configuration → Gateway runtime: configures
- BFF orchestration → Upstream services: composes requests