gatewei

gate + 喂 (Chinese for "hello") = gatewei

Short Description

An opinionated, dead-simple but powerful gateway for your microservice architecture.

Installation

npm

npm i -g gatewei

yarn

yarn global add gatewei

Highlights

• Simple: Get up and running with only a few steps
• Lightweight: Low memory footprint, no unnecessary bloat
• Scalable: Multithreaded load balancing already included

Usage

1. Create a file called config.json or specify a path with the flag --config
2. Configure to your liking using the options below
3. Run gatewei or gatewei --config <your_config_path> if you use a file other than the default config.json in the current working directory.

Options

Configuration Options

Property	Description	Default
serverPort	Port for gatewei to listen for incoming requests	Required to be added manually
services	Array of services to proxy requests for	[]
removeRouteSlug	Remove prefix of service (e.g /api/users will become /users)	true
clusterSize	Specify number of threads to use	Count of CPU cores
forceShutdownOnWorkerExit	Shut down gatewei when worker exits unexpectedly	false
restartWorkers	Restart worker when it exits unexpectedly	true
enableWS	Enable WebSocket proxying	false
changeOrigin	Replace Host header of proxy request with target host instead of request host	false

When enabling WebSocket proxying, to activate the proxy, an initial request has to be sent to the target service. For more information, visit this page.

Service Configuration

A service is a simple object containing the following properties

Property	Description
slug	The service slug which will identify the service and be used for selecting the service to use for incoming requests
target	The target service URL. Can be either a simple host or even contain a path prefix