Skip to content

jigs.md

Latest commit

 

History

History
53 lines (31 loc) · 2.46 KB

jigs.md

File metadata and controls

53 lines (31 loc) · 2.46 KB

Configuration Managers (aka Jigs)

Jigs are the interface between OpenCrowbar and external work that needs to be done.

OpenCrowbar provides a pluggable model for interacting with nodes and other datacetner infrastructural components such as switches, power controllers, failover controllers, etc. Each differing configuration manager has its own interfaces and control methods. OpenCrowbar provides a defined API for the configuration managers meeded to control and manage a collection of machines and systems.

For convenience the OpenCrowbar method for initiating and controlling a node-role state transition operation through a particular control manager is via a Jig. A Jig provides a consistent interface for OpenCrowbar state transition vectors. State transition vectors operate within the context of a predefined dependency graph. The collection of OpenCrowbar Jigs provide a platform-agnostic and operationally neutral method for initiating, monitoring, and completing a node-role state transition.

OpenCrowbar must have 1 or more Jigs that preform the work of OpenCrowbar of node-role state transition operations, known as Jobs.

##For initial OpenCrowbar work, the primary Jigs inclide:

  • the Chef jig in Barclamp-Chef
  • the script jig in Barclamp-Script
  • the noop jig in Barclamp-Noop

##JIG semantic standard operations:

  1. A jig can create roles for operation
  2. A jig can set attributes for operations

The OpenCrowbar roadmap includes provision to use a Puppet jig. The Puppet JIG will include both front0-end driver as well as a Puppet-client capability.

For testing, OpenCrowbar provides a Test Jig that is included in the core OpenCrowbar barclamp.

Schema

Jig names have a limited character set. They can only include alphanumeric characters and underscore (_). They cannot start with underscore.

Inbound path

The jig can read data from the system and store it into attribute collection via JSON databags.

User Data

More information to follow.

System Data

More information to follow.

Outbound path

More information to follow.

Methods

Each jig overrides the following core methods in OpenCrowbar:

Create Node

Handles when a node is added to the OpenCrowbar DB. Allows the jig to make approporate entries in independant databases

Delete Node

Handles when a node is removed from the OpenCrowbar DB. Allows the jig to remove entries from its database

Run (input is list of Tacks)