fuel-web/tasklib/README.md
Dima Shulyak 4dd82c6be3 Tasklib implementation in python
Medium between configuration providers and fuel orchestration
solution.

check README.md and functional tests for better understanding
how it works

HOW TO RUN:
python setup.py develop

taskcmd -c tasklib/tests/functional/conf.yaml run puppet/sleep

taskcmd -c tasklib/tests/functional/conf.yaml run exec/fail

taskcmd -c tasklib/tests/functional/conf.yaml daemon exec/long
taskcmd -c tasklib/tests/functional/conf.yaml status exec/long

Related to blueprint granular-deployment-based-on-tasks

Change-Id: Ifed1a9b90042bbbc93215a30dfb34e29dbe8fba2
2014-10-15 09:51:15 +03:00

1.9 KiB

Tasklib

Tasklib is mediator between different configuration management providers and orchestration mechanism in Fuel.

It will try to cover next areas:

  • part of the plugable fuel architecture See tasklib/tasklib/tests/functional for detailed descriptionof how tasklib plugability will work
  • Control mechanism for tasks in fuel To support different types of workflow we will provide ability to terminate, list all running, stop/pause task
  • Abstraction layer between tasks and orchestration, which will allow easier development and debuging of tasks
  • General reporting solution for tasks

Executions drivers

  • puppet
  • exec

Puppet

Puppet executor supports general metadata for running puppet manifests. Example of such metadata (task.yaml):

type: puppet                        - required
puppet_manifest: file.pp            - default is site.pp
puppet_moduels: /etc/puppet/modules
puppet_options: --debug

All defaults you can find in:

taskcmd conf

It works next way: After task.yaml is found - executor will look for puppet_manifest and run: puppet apply --modulepath=/etc/puppet/modules file.pp with additional options you will provide

Exec

type: exec       - required
cmd: echo 12     - required

will execute any cmd provided as subprocess

EXAMPLES:

taskcmd -c tasklib/tests/functional/conf.yaml conf

taskcmd -c tasklib/tests/functional/conf.yaml list

taskcmd -c tasklib/tests/functional/conf.yaml daemon puppet/sleep taskcmd -c tasklib/tests/functional/conf.yaml status puppet/sleep

taskcmd -c tasklib/tests/functional/conf.yaml run puppet/cmd

taskcmd -c tasklib/tests/functional/conf.yaml run puppet/invalid

HOW TO RUN TESTS:

python setup.py develop pip install -r test-requires.txt

nosetests tasklib/tests

For some functional tests installed puppet is required, so if you dont have puppet - they will be skipped