fuel-web/tasklib

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