Skip to content

A python tool to manage developing and testing with lots of microservices

License

Notifications You must be signed in to change notification settings

elabeca/service-manager

 
 

Repository files navigation

Service Manager

Build Status Join the chat at https://gitter.im/hmrc/service-manager

Developing with lots of microservices often draws complaints from the eventual complexity for the developer. i.e. 10 different services to start that are constantly evolving, owned by different teams and using different technologies... What if there was a way to manage this so you can just get on with your work...

Introducing Service Manager

A set of utilities to run applications and micro services during the development and testing phase, and make development easier in a micro service environment.

Common use cases / Getting started

  • For a list of commands type sm --help
  • For current run status type sm -s
  • To start all services using binaries: sm --start "*" -f

Adding a new application

Modify your services.json file

The application automatically looks for your config in $WORKSPACE/service-manager-config

You can change this directly in $WORKSPACE/service-manager-config to test your changes locally

Add a new application at the bottom of the services.json. There are plenty of examples of how to do this by looking at existing entries

SM Server

Service Manager also has a feature for allowing integration tests

Run smserver and it will run a service that can fire up services on demand

API

Path Supported Methods Description
/ping GET
/start POST
/stop POST
/version_variable GET

Development setup

To run Service Manager please install any dependencies:

$ pip install -r requirements.txt

Running the tests

py.test -v -s test/

Some of the tests pull down large repositories. To skip these online tests, you can use markers: py.test -v -m 'not online -s test/

The unit tests and integration tests are in separate subfolders, so can also be selected independently

License

This code is open source software licensed under the Apache 2.0 License.

About

A python tool to manage developing and testing with lots of microservices

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 96.2%
  • Scala 1.7%
  • Java 1.2%
  • Other 0.9%