Collins

Central Source of Truth

Truth is important in your infrastruture. Keeping it in a central location lets you automate repetitive tasks easily, and with confidence.

Collins acts as a central Source of Truth in the Genesis Stack. It provides an object-oriented view of different infrastructure components, and exposes these through a web interface and a REST-ful JSON api.

Collins was developed by tumblr, and this fork is maintained by http://www.shopify.com.

Getting started

You can find more documenatation on setting up Collins here.

Or, try out this vagrant box to avoid setting up depenencies.

The API

Collins has a well documented REST api. The best way to learn it is to run through it.

Try the following actions using the API:

• Create an asset
• Update / add attributes of that asset
• Add entries to the asset log
• Assign an IP address
• Add / Update IPMI data
• Create a new asset state
• Update the state of an asset
• Delete an asset
• Create an asset hierarchy