Orange

A Gateway based on OpenResty(Nginx+lua) for API Monitoring and Management.

Install & Usages

Requirements

MySQL v5.5+
OpenResty v1.9.7.3+ or Nginx+lua module
- install OpenResty with --with-http_stub_status_module option
Lor Framework please mind:
- Orange v0.6.1 and versions before v0.6.1 are compatible with lor v0.2.*
- Orange v0.6.2+ is compatible with lor v0.3.0+

Import the SQL file(e.g. install/orange-v0.7.0.sql) which is adapted to your Orange version into MySQL database named orange.

Install

dependencies

# cd orange          // Go to the Orange directory
# make dependencies  // Installation dependent extension

script management

use shell scripts (e.g. start.sh) to manage Orange.

CLI tools

In addition to start.sh script, a new cli tool could be utilized to manage Orange. You should install the cli first:

# cd orange     // Go to the Orange directory
# make install  // Installation CLI tools

then, the Orange runtime lua module is installed in /usr/local/orange and an executable command named /usr/local/bin/orange is generated.

Usages

Before starting Orange, you should ensure that the orange.conf and nginx.conf are redefined to satisfy the demands of your project.

script management

Just sh start.sh to start Orange. You could rewrite some other shell scripts as you need.

CLI tool

orange help to check usages:

Usage: orange COMMAND [OPTIONS]

The commands are:

start   Start the Orange Gateway
stop    Stop current Orange
reload  Reload the config of Orange
restart Restart Orange
store   Init/Update/Backup Orange store
version Show the version of Orange
help    Show help tips

Documents

Find more about Orange on its website. There is only a Chinese version for now.

Docker

https://store.docker.com/community/images/syhily/orange maintained by @syhily

Contributors

License

MIT

webangeld/orange