Skip to main content

Fabric task runner and helper. Executes and manages tasks via web browser.

Project description

Fabric task runner and helper. Execute tasks via web browser.

oozappa is 大雑把.

Change logs.


Oozappa finds tasks from imported modules, not recursive.


$ pip install oozappa

If you use Xcode 5.1(above) and failed with clang: error: unknown argument: ‘-mno-fused-madd’ , export flags before install.

$ export CPPFLAGS=-Qunused-arguments
$ export CFLAGS=-Qunused-arguments

Oozappa data models.


Environment is a category that has fibfile directory and .

A problem about fabric with large project is, too many fabric tasks and complicated task orders.

So you should separate fabfile into domain category. That is Environment.


Job is like a normal fabric execution command.


fab task1 task2 is a job.


Jobset is oozappa operation unit.

Jobset can contain multiple job, even extend over environments.

Oozappa fabric structures.

See sample oozappa project( ).

├── common
│   ├──
│   ├── files
│   ├── functions
│   │   ├──
│   ├── templates
│   │   └── sample_a.txt
│   └──
├── construction
│   ├── fabfile
│   │   ├──
│   │   └──
│   ├── templates
│   └──
├── deployment
│   ├── fabfile
│   │   ├──
│   ├── templates
│   └──
├── production
│   ├── fabfile
│   │   ├──
│   ├── templates
│   └──
└── staging
    ├── fabfile
    │   ├──
    ├── templates
    │   └── sample_a.txt

common is reserved directory. construction and others are environment directory. These names except common are just example.


common and each environment’s might have oozappa.config.OozappaSetting instance named settings. OozappaSetting is dict like object.

common.vars.setting is updated by executed environment’s vars.setting , so you can set base configuration to common.vars.setting and environment’s one overwrite it.

Check printsetting task on staging environment.

You can run fabric task within environment directory as usual.

$ cd sample/ops/staging
$ fab printsetting
{'instance_type': 't1.micro', 'domain': 'localhost', 'sample_template_vars': {'sample_a': {'key_a_2': "a's 2 value from common.vars", 'key_a_1': "a's 1 value from stging.vars"}}, 'email': 'mtsuyuki at'}

See common/ and staging/ .


Same as vars, oozappa.fabrictools.upload_template search template. upload_template is almost same as fabric.contrib.files.upload_template . oozappa’s upload_template doesn’t accept use_jinja, because oozappa’s upload_template pass use_jinja=True to fabric.contrib.files.upload_template.

Jinja2 has inheritance template system and search template from multipul paths. fabric’s upload_template accept only one template_dir string not list. fabric doesn’t assume multiplu environment , so it’s reasonable. Because of this, oozappa’s upload_template search template path is limited only one template_dir that found filename. It mean that you can’t store child template and parent template separately.


Call oozappa.config.procure_common_functions () and add commons/functions directory to sys.path for convinient to using on multiple fabric environment.

Run fabric task via web browser.

Change directory to outside environment directory.

$ cd ..
$ ls
common    production  staging
$ gunicorn -t 3600 -k flask_sockets.worker oozappa:app

Running oozappa:app creates /tmp/oozappa.sqlite .

Open your web browser and browse http://localhost:8000/ .

Rapid execution

Modify Run fabric in raw’s left hand side input to staging and click run_tasks. You can see what tasks exists.

Then input ls ps to right hand side input and click run_tasks .

That’s it.

Better way using sample

register environment to db.

  • Click environment button via top menu.

  • Add new Environment

    • name: constructiton

    • sort_order: 1

    • execute_path: constructiton

  • Add 3 more.


create job in each environments.

  • Click environment you created

  • Create new Job.

    • Click task from Possible tasks in order


create jobset

  • Click jobset button via top menu.

  • Click jobs you’d like to execute once.


run jobset

  • Click navigation button or jobset button via top menu.

  • Click jobset you’d like to execute.

  • Click run jobset button.

  • Running log displays Running log.

  • Reload page when jobset done. or Go to top(via navigation button)

    • You see Execute Logs and show raw log when you click success (or fail).

running jobset

How to create your own

Create common directory

Change directory your own oozappa.

$ mkdir devops
$ cd devops

Then run oozappa.

$ python -m oozappa
Create common environment here? [y/N]y
create common directory. db file path and flask secret key are in common/

Change default settings

Open common/ and change settings using temp directory. Or results disapear when you reboot your machine or server.


    sqlite’s data store path.


    Jobset execute log store directory path.

Create environment

Run oozappa.create_environment with environment name(s).

$ python -m oozappa.create_environment construction deployment
2014-04-20 16:43:26,543 INFO create environment : construction
2014-04-20 16:43:26,544 INFO create environment : deployment

Then you can write fabfile normally and execute via oozappa.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oozappa-0.8.2.tar.gz (36.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page