Arbiter is a utility for generating XML Oozie workflows from a YAML specification.
Read the blog post that introduced Arbiter on Code as Craft, Etsy's engineering blog.
There is a mailing list for this project at https://groups.google.com/forum/#!forum/arbiter-oozie. If you have questions or suggestions for the project send them here!
Arbiter requires at least Java 7.
Arbiter is built with Maven. Run mvn clean package
to build an uber-JAR suitable for use in running Arbiter.
Pre-built Arbiter JAR files are also available in Maven Central:
<dependency>
<groupId>com.etsy</groupId>
<artifactId>arbiter</artifactId>
<version>0.5.0</version>
</dependency>
Before writing workflows with Arbiter, you must define at least one configuration file. See Configuration for details on writing a configuration file.
See Workflow Definition for details on writing workflows with Arbiter.
Flag | Meaning |
---|---|
-c |
Specifies the path to a configuration file. Required once, but can be specified multiple times to provide multiple configuration files. |
-l |
Specifies the path to a low-priority configuration file. Low priority configurations will be overridden by standard configurations if they define overlapping settings. Optional. |
-i |
Specifies the path to a YAML workflow definition to process. Required once, but can be specified multiple times to process multiple workflows. |
-o |
Specifies the directory to which Arbiter will output the generated workflows. Required. |
-g [ |
Enables generating a image of the workflow graph using Graphviz. The dot tool must be installed and on the PATH for this to work. SVG is the default format but any format supported by dot may be specified as an argument to for this flag. |
-h | Prints a usage message |
First build an Arbiter uber-JAR as described in the Building section above. Arbiter can then be invoked like so:
java -jar arbiter.jar [OPTIONS]