/Hanlon

Next-generation automation software for bare-metal and virtual server discovery and provisioning.
  1. Ruby 70.1%
  2. JavaScript 11.1%
  3. HTML 9.3%
  4. Shell 4.2%
  5. CSS 4.1%
  6. PowerShell 1.2%
Ruby JavaScript HTML Shell CSS PowerShell
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 1f1d676 Oct 13, 2016 @jcpowermac jcpowermac Merge pull request #443 from mtnbikenc/readme-fix 
Update contact info
Permalink
Failed to load latest commit information.
cli removed unnecessary require Dec 2, 2015
core Created salt broker plugin Aug 7, 2016
scripts Made handlon_docker.sh more 12 factorish Mar 24, 2016
test Updating rspec tests to verify SMBIOS UUID Nov 10, 2015
util Removes support for JRuby from Hanlon Apr 13, 2015
web Save the ipxe boot_mac and use it for dhcp_mac Jun 22, 2016
.autotest Massive complete rewrite of almost everything in prep for making this… Mar 2, 2012
.dockerignore Adding docker-compose to automate the containers for Hanlon Feb 12, 2016
.gitignore trivial dependency format changes Dec 2, 2015
.mailmap Refactoring to change project name from Razor to Occam Mar 11, 2014
.travis.yml removing libbz2-dev from TravisCI build and attempting a conditional … Nov 18, 2015
.yardopts new model constructs Feb 24, 2012
CONTRIBUTING.md Fixes 'CLA Signing' and 'Trivial Patch Exemption' links Aug 12, 2014
Dockerfile preparing to tag for v3.0.1 release Dec 8, 2015
Gemfile trivial adjustment to gemspec and switch to bzip2-ffi Dec 2, 2015
Gemfile.lock preparing to tag for v3.0.1 release Dec 8, 2015
LICENSE Fixes #219 (Typo in $HANLON_HOME/LICENSE) Oct 31, 2014
README.md Update contact info Oct 13, 2016
Rakefile modifications to change project name from "Occam" to "Hanlon" Apr 23, 2014
docker-compose.yml correct atftpd image Mar 17, 2016
docker-entrypoint.sh Modifications for IPMI Jun 4, 2015
hanlon.env Adding docker-compose to automate the containers for Hanlon Feb 12, 2016
hanlon.gemspec preparing to tag for v3.0.1 release Dec 8, 2015
hanlon_init Changes Docker to support Cassandra Jun 2, 2015

README.md

Build Status

Project Hanlon (v3.0.1)

Join the chat at https://gitter.im/csc/Hanlon

Introduction

Project Hanlon is a power control, provisioning, and management application designed to deploy both bare-metal and virtual computer resources. Hanlon provides broker plugins for integration with third party such as Puppet.

Hanlon started its life as Razor so you may encounter links to original created-for-Razor content. The following links, for example, provide background info about the project:

Project Hanlon is versioned with semantic versioning, and we follow the precepts of that document.

How to Get Help

We really want Hanlon to be simple to contribute to, and to ensure that you can get started quickly. A big part of that is being available to help you figure out the right way to solve a problem, and to make sure you get up to speed quickly.

You can always reach out and ask for help by email or through the web on the hanlon-project@googlegroups.com mailing list. (membership is required to post.)

If you want to help improve Hanlon directly we have a fairly detailed CONTRIBUTING guide in the repository that you can use to understand how code gets in to the system, how the project runs, and how to make changes yourself.

We welcome contributions at all levels, including working strictly on our documentation, tests, or code contributions. We also welcome, and value, input about your experiences with Project Hanlon, and provisioning in general, on the mailing list as we discuss how the project might solve these sorts of problems.

Installation

Follow wiki documentation for Installation Overview

Project Committers

This is the official list of users with "committer" rights to the Hanlon project. For details on what that means, see the CONTRIBUTING guide in the repository.

Please reach out to opensource@csc.com if you have any questions about the project.

Hanlon MicroKernel

Hanlon uses an associated Hanlon-Microkernel instance to discover new nodes. Pre-build (Docker) images of the current Hanlon-Microkernel (v3.0.0) are officially available via DockerHub at cscdock/hanlon-microkernel. You can also find the original source code that went into this release in the releases area of the Hanlon-Microkernel project, here.

Finally, you can find more information on the Microkernel and on the process for building your own Microkernel images at the Hanlon MicroKernel project page:

https://github.com/csc/Hanlon-Microkernel

License

Project Hanlon is distributed under the Apache 2.0 license. See the LICENSE file for full details.

Reference

The following links contain useful information on the Hanlon (and Hanlon-Microkernel) projects as well as information on the new CSC Open Source Program:

Finally, these links provide an introduction to the original Razor project (and, given Hanlon's roots in the original Razor project, they may be of interest to those new to the Razor/Hanlon community):

  • The original Razor Overview posting: Nickapedia.com
  • A video of Nick Weaver's Razor Session from PuppetConf 2012: Youtube
  • The original posting by Nan Liu describing the first Puppet Labs Razor Module: Puppetlabs.com

Even though the Puppet Labs module described in the last link is no longer maintained, and even though it doesn't support Hanlon, we included it here because we felt that the information in that blog posting may provide useful to those who would like to develop a corresponding Hanlon module.