Skip to content

Latest commit

 

History

History
131 lines (102 loc) · 4.14 KB

README.md

File metadata and controls

131 lines (102 loc) · 4.14 KB
Raw

ohai-plugins

This repo contains plugins for Opscode's Ohai tool. Many of these plugins are provided in a self-contained Ohai package called ohai-solo.

##Writing Ohai Plugins ####Using Vagrant Using Vagrant, you can easily create new/modify Ohai plugins in the /plugins directory and test them on an Ubuntu 12.04 system.

vagrant up
vagrant ssh
/opt/ohai-solo/bin/ohai -d /vagrant/plugins

This command runs Ohai and tells it to use the plugins located in this repo.

Ohai-Solo

Ohai-Solo is a package that contains an embedded version of Ruby 1.9.3, Ohai, and the plugins from this repo. Packages are built using Opscode's Omnibus system. You can find the Omnibus build environment for Ohai-Solo here.

Packages are currently provided/tested for these distributions:

  • Ubuntu 10.04
  • Ubuntu 10.10 (Uses 10.04 package)
  • Ubuntu 11.04 (Uses 10.04 package)
  • Ubuntu 11.10 (Uses 10.04 package)
  • Ubuntu 12.04
  • Ubuntu 12.10
  • Ubuntu 13.04
  • Ubuntu 13.10 (Uses 13.04 package)
  • Ubuntu 14.04 (Uses 13.04 package)
  • CentOS/RHEL 5 (use "el" as platform name)
  • CentOS/RHEL 6 (use "el" as platform name)
  • Debian 6
  • Debian 7

###Installing Ohai-Solo:

curl -sSL http://ohai.rax.io/install.sh|bash
ohai-solo

###Installing Ohai-Solo (manual):

To use ohai-solo, grab the latest package for your distribution by querying the list of packages (this example uses HTTPie - if you don't have it, you should):

http http://ohai.rax.io/packages.json
...

    "ohai-solo_1.0.5-1.ubuntu.12.04_amd64.deb": {
        "arch": "x86_64",
        "basename": "ohai-solo_1.0.5-1.ubuntu.12.04_amd64.deb",
        "last_modified": "2014-01-03T16:54:52",
        "md5": "ebc323c06e7645ec7a3a159617cd1b7b",
        "platform": "ubuntu",
        "platform_version": "12.04",
        "sha256": "2f62e94ca7bf7155280f18e32fa072953941a055bcbbfcc13022ea2cb48fc96b",
        "version": "1.0.5"
    },
 ...

You can also request the latest package for your distribution by querying http://ohai.rax.io/latest.<platform>.<platform_version>.<arch>.json. For example:

  • Ubuntu 12.04 64-bit:
http http://ohai.rax.io/latest.ubuntu.12.04.x86_64.json
...

{
    "arch": "x86_64",
    "basename": "ohai-solo_1.0.5-1.ubuntu.12.04_amd64.deb",
    "last_modified": "2014-01-03T16:55:04",
    "md5": "ebc323c06e7645ec7a3a159617cd1b7b",
    "platform": "ubuntu",
    "platform_version": "12.04",
    "sha256": "2f62e94ca7bf7155280f18e32fa072953941a055bcbbfcc13022ea2cb48fc96b",
    "version": "1.0.5"
}
  • CentOS/RHEL 6 64-bit:
http http://ohai.rax.io/latest.el.6.x86_64.json
...
{
    "arch": "x86_64",
    "basename": "ohai-solo-1.0.3-1.el6.x86_64.rpm",
    "last_modified": "2014-01-03T16:53:57",
    "md5": "c3a864c198defe4dcb9c1995876ded65",
    "platform": "el",
    "platform_version": "6.4",
    "sha256": "6fffad237f58bbd567785d9c97c3228babb01bd387d53c397d63a0937d0a5611",
    "version": "1.0.3"
}

Once you have your package name, download and install it using the basename returned from the API:

wget http://ohai.rax.io/ohai-solo_1.0.5-1.ubuntu.12.04_amd64.deb
dpkg -i ohai-solo_1.0.5-1.ubuntu.12.04_amd64.deb

This will install ohai-solo to /opt/ohai-solo. Simply run ohai-solo to get all output.

###Contributing: If you would like to contribute an Ohai plugin to this project, add the plugin to the plugins directory. Then write a serverspec test in test/integration/ohaiplugins/serverspec/localhost/ that tests your plugin.

To run tests we will assume you are using bundler:

bundle install --binstubs

There is a provided .kitchen.rackspace.yml file if you prefer to use Rackspace Performance Cloud Servers for testing instead of Vagrant. To use this workflow, copy .kitchen.rackspace.yml to .kitchen.local.yml and provide the appropriate environment variables.

Once setup, run bundle exec kitchen test to test all OS's or run bundle exec kitchen test <distro>. Use bundle exec kitchen list to see all possibilities.