This is SONATA's Service Platform Gatekeeper's repository.
The Gatekeeper is the component that implements all the Northbound Interface (NBI) of the Servive Platform.
- accepting new developers' to be part of the contributors of new developed services;
- accepting new services, in the package format, to be deployed in the platform;
- validating submited packages, both in terms of file format and developer submitting the package;
- accepting new service instance requests from customers interested in instantiating a service;
- following a service performance through automatically monitoring each on-boarded service or function;
This section details what is needed for developing the Gatekeeper.
This repository is organized by micro-service (one folder to one micro-service).
Micro-services currently implemented are the following:
son-gtkapi: the only 'door' to the Gatekeeper, where the API is exposed and requests are validated and dispached to the other micro-services of the Gatekeeper;
son-gtkpkg: where packages are opened, validated and submited to the Catalogues;
son-gtksrv: where requests for services' meta-data are forwarded to the Catalogues and service instantiation requests are sent to the
son-gtkfnct: where requests for functions' meta-data are forwarded to the Catalogues and requests for function metrics are sent to the Monitoring Framework;
son-gtkvim: through which the GUI accesses VIMs and WIMs configurations;
son-gtkrec: where requests for services' or functions' records are forwarded to the Repositories;
son-gtklic: where Licences' are managed;
son-gtkusr: where all User Management's features are implemented;
son-gtkkpi: where all KPIs' features are implemented;
son-sec-gw: the front-end implementing external secured (
son-keycloak: the back-end of the User Management micro-service;
son-gtkrlt: the implemented simple rate limiter;
Most of these micro-services have been implemented using
ruby programming language and the
sinatra framework. The two exceptions are the
son-gtklic, which is implemented in
son-keycloak, implemented in
son-sec-gw is just a
NGINx fron-end, adequately configured). The only need is that the micro-service to be implemented provides a REST API, whatever the language it is implemented in.
'Building' the Gatekeeper, given the approach mentioned above, is more like 'composing' it from the available micro-services. So:
- each micro-service is provided in its own container (we're using
Dockerfilein each folder specifies the environment the container needs to work;
docker-compose.ymlfile in the root of this repository provides the linking of all the micro-services.
The libraries the Gatekeep depends on are the following:
addressable>=2.4.0 (Apache 2.0)
rest-client>=2.0.0 (Apache 2.0)
For the micro-services implemented in ruby these dependencies can be checked in each folder's
Contributing to the Gatekeeper is really easy. You must:
- Clone this repository;
- Work on your proposed changes, preferably through submiting issues;
- Submit a Pull Request;
- Follow/answer related issues (see Feedback-Chanel, below).
Installing the Gatekeeper is really easy. You'll need:
- the ruby programming language: we prefer doing this by using a version manager tool such as rvm or rbenv (we are using version 2.2.3);
- in each one of the subfolders, just run:
- please follow each specific folder's instructions on which environment variables to set
We do three kinds of automated tests:
- Unit tests, which are done with the
RSpecframework (see the
- Integration tests, which are done with a set of
shellscripts and the
curlcommand (see the
- White-box tests, which are done by using the
XMLreports by executing the command
$ bundle exec rake ci:all
everytime a pull request is done.
Please see the several levels of tests that may be considered.
Please refer to the Usage documentation wiki pages for all the usage details.
The license of the SONATA Gatekeeper is Apache 2.0 (please see the license file).
The following lead developers are responsible for this repository and have admin rights. They can, for example, merge pull requests.
Please use the GitHub issues and the SONATA development mailing list
email@example.com for feedback.