Frunner

A local runner for Fruster services.

Will pull latest version of services defined in a service registry (list of URLs to git repos), build services (if needed) and start them.

Installation

Note: You need a newer version of node, preferably 6.x.

npm install frunner -g

Usage

frunner help

Install from service registry:

frunner install foo/foo-registry master

Run it:

frunner run foo/foo-registry master

Service registry

The service registry is simply a JSON file pointing to other repos. It may also include configuration that will be exposes as env variables to each service.

Example:

{
  "config": {
    // Global config, will be exposed to all services
    "BUS": "nats://localhost:4222"  
  },
  "services": [
    {
      "url": "https://github.com/foo/user-service",
      "config": {
        "BUS": "nats://localhost:4333" // <-- will override global config
      },
      "start": "npm start",
      "test": "npm test",
      "build": "npm install"
    },
    {
      "url": "foo/api-gateway",  // resolves to https://github.com/foo/api-gateway          
      "start": "java -jar target/api-gateway.jar",
      "test": "mvn clean test",
      "build": "mvn clean install"
    }        
  ]
}