https://github.com/gomicro/avenues
A small CORS Proxy to create a singular API of Microservices for testing locally
https://github.com/gomicro/avenues
cors-proxy docker docker-image golang hacktoberfest microservices testing-tool
Last synced: 5 months ago
JSON representation
A small CORS Proxy to create a singular API of Microservices for testing locally
- Host: GitHub
- URL: https://github.com/gomicro/avenues
- Owner: gomicro
- License: mit
- Created: 2018-01-01T09:29:11.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-10-17T23:06:31.000Z (over 4 years ago)
- Last Synced: 2024-11-15T04:46:21.318Z (over 1 year ago)
- Topics: cors-proxy, docker, docker-image, golang, hacktoberfest, microservices, testing-tool
- Language: Go
- Size: 17.9 MB
- Stars: 0
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Avenues
[](https://github.com/gomicro/avenues/actions?query=workflow%3ABuild+branch%3Amaster)
[](https://goreportcard.com/report/github.com/gomicro/avenues)
[](https://godoc.org/github.com/gomicro/avenues)
[](https://github.com/gomicro/avenues/blob/master/LICENSE.md)
[](https://github.com/gomicro/avenues/releases/latest)
Avenues is specifically for creating a singular API layer out of several dockerized Microservices. More specifically for local testing. It is in no way expected to take a production load. Ideally in production you'll have a load balancer or some other service that has been significantly battle tested to demonstrate reliability. Beyond that, you typically don't have a load balancer or these other things when testing locally, and it is very nice to test your entire API holistically rather than as individual services. Avenues allows for you to provide a config for the routing, and will proxy all requests to the designated services. The benefit coming from it's simplicity and being light weight. The container houses only the app, and as such is a very tiny docker image.
# Requirements
Docker
# Usage
## Configuration
The configuration always looks to read from a `routes.yaml` file. It expects one segment, definition of given routes.
The endpoints are treated as the root of the endpoint, so all sub paths of the routes specified will direct to those routes as well. i.e. `/v1/teams` will match for `/v1/teams`, `/v1/teams/{teamID}`, `/v1/teams/{teamID}/admin`, and so on.
```
routes:
"/v1/projects":
type: "static"
backend: "http://service1:4567"
"/v1/users":
backend: "http://service2:4567"
"/v1/teams":
backend: "http://service2:4567"
"/v1/posts":
type: "ordinal"
backends:
- "http://service3:4567"
- "http://anothermockofservice3:4567"
- "http://mockfailureservice:4567"
reset: "/a/custom/path/for/reset" # Optional
status: "/a/custom/path/for/status" # Optional
cert: "cert for serving ssl" # Optional
cert_path: "path to file containing cert" # Optional
key: "key for serving ssl" # Optional
key_path: "path to file containing key" # Optional
ca: "a custom CA to include for SSL" # Optional
ca_path: "path to file containing CA(.)(.)" # Optional
```
## Running
Avenues is intended to be used in conjunction with local Docker testing of a service.
```
docker pull ghcr.io/gomicro/avenues
docker run -it -v $PWD/routes.yaml:/routes.yaml ghcr.io/gomicro/avenues
```
# Versioning
The app will be versioned in accordance with [Semver 2.0.0](http://semver.org). See the [releases](https://github.com/gomicro/avenues/releases) section for the latest version. Until version 1.0.0 the app is considered to be unstable.
# License
See [LICENSE.md](./LICENSE.md) for more information.