af94edbda4 | ||
---|---|---|
roles | ||
.gitignore | ||
CHANGELOG.md | ||
FUNDING.md | ||
LICENSE.md | ||
README.md | ||
site-prod.yaml | ||
site.yaml |
README.md
Conductor Setup
Conductor Setup is composed of a set of ansible roles and a playbook named site.yaml useful for deploying a docker swarm running Conductor microservice orchestrator by Netflix OSS.
Structure of the project
The AutoDynomite Docker image script file is present in dynomite
folder.
The Docker Compose Swarm files are present in the stack
folder.
Built With
Documentation
The provided Docker stack files provide the following configuration:
- 2 Conductor Server nodes with 2 replicas handled by Swarm
- 2 Conductor UI nodes with 2 replicas handled by Swarm
- 1 Elasticsearch node
- 1 Database node that can be postgres (default), mysql or mariadb
- 2 Optional replicated instances of PyExec worker running the tasks Http, Eval and Shell
- 1 Optional cluster-replacement service that sets up a networking environment (including on HAProxy LB) similar to the one available in production. By default it's disabled.
The default configuration is run with the command: ansible-playbook site.yaml
Files for swarms and configurations will be generated inside a temporary folder named /tmp/conductor_stack on the local machine.
In order to change destination folder use the switch: -e target_path=anotherdir
If you only want to review the generated files run the command ansible-playbook site.yaml -e dry=true
In order to switch between postgres and mysql specify the db on the proper variable: -e db=mysql
In order to connect to an external postgres withouth pulling up a service in the stack use -e db=remote-postgres
In order to skip worker creation specify the noworker variable: -e noworker=true
In order to enable the cluster replacement use the switch: -e cluster_replacement=true
If you run the stack in production behind a load balanced setup ensure the variable cluster_check is true: ansible-playbook site.yaml -e cluster_check=true
In order to avoid confusion of all variables a proper site.yaml has been created for prod environment. Run ansible-playbook site-prod.yaml
and this should deploy a stack with prod setup.
Other setting can be fine tuned by checking the variables in the proper roles which are:
- common: defaults and common tasks
- conductor: defaults, templates and tasks for generating swarm files for replicated conductor-server and ui.
- elasticsearch: defaults, templates and task for starting in the swarm a single instance of elasticsearch
- mysql: defaults, template and tasks for starting in the swarm a single instance of mysql/mariadb
- postgres: defaults, templates and tasks for starting in the swarm a single instance of postgres
- workers: defaults and task for starting in the swarm a replicated instance of the workers for executing HTTP, Shell, Eval operations.
Change log
See CHANGELOG.md.
Authors
- Marco Lettere (Nubisware S.r.l.)
- Mauro Mugnaini (Nubisware S.r.l.)
How to Cite this Software
[Intentionally left blank]
License
This project is licensed under the EUPL V.1.1 License - see the LICENSE.md file for details.
About the gCube Framework
This software is part of the gCubeFramework: an open-source software toolkit used for building and operating Hybrid Data Infrastructures enabling the dynamic deployment of Virtual Research Environments by favouring the realisation of reuse oriented policies.
The projects leading to this software have received funding from a series of European Union programmes see FUNDING.md
Acknowledgments
[Intentionally left blank]