https://github.com/telefonicaid/orchestrator
Orchestrator groups all provision operations for IoT Platform that tipically implies several steps or several systems interaction.
https://github.com/telefonicaid/orchestrator
docker iot-platform keypass keystone openstack orchestrator python
Last synced: about 1 year ago
JSON representation
Orchestrator groups all provision operations for IoT Platform that tipically implies several steps or several systems interaction.
- Host: GitHub
- URL: https://github.com/telefonicaid/orchestrator
- Owner: telefonicaid
- License: agpl-3.0
- Created: 2015-05-04T14:11:14.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2025-01-14T11:33:11.000Z (over 1 year ago)
- Last Synced: 2025-01-14T12:38:49.543Z (over 1 year ago)
- Topics: docker, iot-platform, keypass, keystone, openstack, orchestrator, python
- Language: Python
- Homepage:
- Size: 2.12 MB
- Stars: 5
- Watchers: 11
- Forks: 5
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
Awesome Lists containing this project
README
[](http://ci-iot-deven-01.hi.inet/jenkins/job/IOTP-Orchestrator-Package/)
[](https://opensource.org/licenses/AGPL-3.0)
[](https://travis-ci.org/telefonicaid/orchestrator)
[](https://hub.docker.com/r/telefonicaiot/orchestrator/)
[](http://stackoverflow.com/questions/tagged/orchestrator/)
[](https://gitter.im/telefonicaid/orchestrator?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Orchestrator tries to group all provision operations for IoT platform that typically implies several steps or several systems' interaction.
Orchestrator exposes an API and provides scripts to perform all these operations. Scripts simplifies the inherent usage of keystone, such as usage of long identifiers not so easy to remember and to use, using names and resolving internally to deal with keystone.
Orchestrator scripts can interact with any remote 3rd party, since related host and port should be provideed as argument to earch script.
A typical scenario for IoT Platform can be [these scenarios](https://github.com/telefonicaid/orchestrator/blob/master/src/tests/scenarios/SCENARIOS.md).
Orchestrator is used to:
- Create/List/Update/Delete services
- Create/List/Update/Delete subservices
- Create/List/Update/Delete users in a service
- Create/List/Update/Delete roles in a service
- Create/List/Update/Delete groups in a service
- Assign/unassign roles to users in a service
- Create/List Trust Tokens
- Activate / deactivate IoT Modules
- Retrieve statistics and metrics about API usage
- Retrieve stats about UWSGI server usage
- Create, List, Modify LDAP Users
- Create, List, Modify LDAP Groups
Orchestrator is based mainly on:
- Python 3 needed
- Django / DjangoRestFramework
- UWSGI
Orchestrator relies on these other IoT parts:
- Identity Manager: Keystone (mandatory)
- Access Control: Keypass (mandatory)
- Context Broker: Orion (optional)
- CEP: Perseo (optional)
- Cygnus (optional)
- OpenLDAP (optional)
- Mailer (optional)
- MongoDB (optional)
Some of these IoT parts are optional, this means that orchestrator can work without them but excluding the part of feature in which are involved. This way Keystone and Keypass are mandatory to deal with Orchestrator.
These are all dependencies [requirements.txt](https://github.com/telefonicaid/orchestrator/blob/master/requirements.txt).
Orchestrator needs a WSGI server like Apache, Lighttpd or NGIX: [wsgi.py](https://github.com/telefonicaid/orchestrator/blob/master/src/wsgi.py).
Orchestrator interacts mainly with Identity Manager [Keystone](https://github.com/telefonicaid/fiware-keystone-scim) and Access Control [Keypass](https://github.com/telefonicaid/fiware-keypass).
Since ContextBroker and CEP are secured elements (by [PepProxy](https://github.com/telefonicaid/fiware-pep-steelskin)) orchestrator can interact directly with tem using user provided credencials. If credencials or access control level is not enoght then orchestrator operation will not be performed.
In this README document you could find how to get started with the application and basic concepts. For a more detailed information you can read the following docs:
* [API](http://docs.orchestrator2.apiary.io)
* [Scripts](SCRIPTS.md)
* [Logs and Alarms](TROUBLESHOOTING.md)
* [Installation guide](INSTALL.md)
* [Configuration](CONFIG.md)
* [IoTModules](IOTMODULES.md)
* [Docker configuraton](DOCKER.md)
* [Tests](TESTS.md)