Merge pull request #316 from chippr-robotics/copilot/create-kong-docker-template

Add Kong API Gateway for multi-network routing, HADR, and observability

Author: realcodywburns

docker/README.md

@@ -2,6 +2,20 @@
 
 This directory contains Dockerfiles for building and running Fukuii Ethereum Client in containerized environments.
 
+## Kong API Gateway
+
+For production deployments with load balancing, authentication, and monitoring, see the [Kong API Gateway setup](kong/README.md) which provides:
+
+- **API Gateway**: Kong Gateway for routing and managing all traffic
+- **High Availability**: Load balancing across multiple Fukuii instances
+- **Security**: Basic Auth, JWT, rate limiting, and CORS support
+- **Monitoring**: Prometheus metrics and Grafana dashboards
+- **Multi-Network Support**: HD wallet hierarchy routing for Bitcoin, Ethereum, and Ethereum Classic
+
+Quick start: `cd kong && ./setup.sh`
+
+Full documentation: [kong/README.md](kong/README.md)
+
 ## Container Registries
 
 Fukuii maintains images in multiple container registries:

docker/kong/.env.example

@@ -0,0 +1,54 @@
+# Kong API Gateway Configuration
+# Copy this file to .env and customize for your deployment
+
+# Kong Admin Credentials (change these in production!)
+KONG_ADMIN_USER=admin
+KONG_ADMIN_PASSWORD=change_me_in_production
+
+# Grafana Configuration (CHANGE THESE!)
+GRAFANA_ADMIN_USER=admin
+GRAFANA_ADMIN_PASSWORD=fukuii_grafana_admin_change_me
+
+# Cassandra Configuration
+CASSANDRA_CLUSTER_NAME=fukuii-kong-cluster
+CASSANDRA_DC=dc1
+CASSANDRA_RACK=rack1
+
+# Fukuii Configuration
+FUKUII_NETWORK=etc
+JAVA_OPTS=-Xmx4g -Xms4g
+
+# Network Configuration
+FUKUII_PRIMARY_RPC_PORT=8545
+FUKUII_PRIMARY_WS_PORT=8546
+FUKUII_PRIMARY_P2P_PORT=30303
+FUKUII_PRIMARY_METRICS_PORT=9095
+
+FUKUII_SECONDARY_RPC_PORT=8547
+FUKUII_SECONDARY_WS_PORT=8548
+FUKUII_SECONDARY_P2P_PORT=30304
+FUKUII_SECONDARY_METRICS_PORT=9096
+
+# Kong Ports
+KONG_PROXY_HTTP_PORT=8000
+KONG_PROXY_HTTPS_PORT=8443
+KONG_ADMIN_HTTP_PORT=8001
+KONG_ADMIN_HTTPS_PORT=8444
+
+# Monitoring Ports
+PROMETHEUS_PORT=9090
+GRAFANA_PORT=3000
+
+# Authentication Secrets (CHANGE THESE!)
+BASIC_AUTH_ADMIN_PASSWORD=fukuii_admin_password
+BASIC_AUTH_DEV_PASSWORD=fukuii_dev_password
+API_KEY_ADMIN=admin_api_key_change_me
+API_KEY_DEV=dev_api_key_change_me
+JWT_SECRET=your_jwt_secret_change_me
+
+# Logging
+LOG_LEVEL=info
+
+# Backup Configuration
+BACKUP_ENABLED=false
+BACKUP_SCHEDULE="0 2 * * *"  # Daily at 2 AM

docker/kong/.gitignore

@@ -0,0 +1,63 @@
+# Environment variables with secrets
+.env
+
+# SSL certificates and keys
+ssl/
+*.key
+*.crt
+*.pem
+*.p12
+*.pfx
+
+# Secrets
+secrets/
+
+# Logs
+*.log
+logs/
+
+# Backup files
+*.bak
+*.backup
+backups/
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+
+# Database dumps
+*.sql
+*.dump
+*.dmp
+
+# Cassandra data (managed by Docker volumes)
+cassandra-data/
+
+# Prometheus data (managed by Docker volumes)
+prometheus-data/
+
+# Grafana data (managed by Docker volumes)
+grafana-data/
+
+# Fukuii data (managed by Docker volumes)
+fukuii-data/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Docker
+.docker/
+
+# Local testing configurations
+*-local.yml
+*-local.conf
+test-*.yml