Skip to content
my workstation setup, in chef form
Find file
Pull request Compare This branch is 2 commits ahead, 40 commits behind infochimps-labs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
notes @ 3c290b8

Chimpstation-homebase: infochimps developers' desktop environment

This repo uses chef and ironfan to provision a developer workstation on OSX. It unifies:

  • Cookbooks, roles, and environments
  • Cluster descriptions
  • Your Chef and cloud credentials
  • Pantries (collections of cookbooks, roles and so forth)


  sudo chgrp admin /Applications/ 
  sudo chmod g+wrx /Applications/

Getting Started

We'll use the following conventions:

  • ${organization} for the name of your chef organization
  • ${chef_user} for your user name on the chef server
  • ${chimpstation} for the directory holding your chimpstation-homebase repo

First time per organization

You only have to do the following once:

  • chimpstation repo

    • on github, fork the chimpstation-homebase repo
    • clone it to your machine, into the directory you'll use (${chimpstation})
    • run the following to produce a new credentials repo. Note that the credentials directory will not be added to the chimpstation-homebase; you should use a separate git remote for it.

      cd knife cp -rp example-credentials ${organization}-credentials ln -s ${organization}-credentials credentials cd .. ln -s ./knife .chef git add . ; git commit -m "set up credentials pointers"

  • chimpstation repo:

    • clone your chimpstation-homebase repo to your machine, into the directory you'll use (${chimpstation})

      git clone chimpstation cd chimpstation git submodule update --init git submodule foreach git checkout master ln -s ./knife .chef

    • grab the credentials repo from a co-worker, and put it as knife/${organization}-credentials.

  • chef organization

    • go to opscode, create a chef organization.
    • download the ${organization}-validator.pem to knife/credentials
    • copy your chef server user key to knife/credentials/${chef_user}.pem
    • fix the permissions on the key files: chmod 600 knife/credentials/*.pem
  • create a .chef link from the chimpstation-homebase repo

    • 'ln -s knife .chef'

Commands like knife client list should now work; note that you have to cd into the chimpstation to do so.

  • populate the chef server:

    knife cookbook upload --all
    knife role from file roles/*.rb
    knife environment from file environments/ws.rb


  • initial set up:

    • install Xcode
    • Follow instructions to install Homebrew. We highly recommend using the git install method:

      /usr/bin/ruby -e "$(/usr/bin/curl -fsSL" brew update brew install git ruby-build rbenv rbenv install 1.9.3-p0 rbenv rehash echo 'eval "$(rbenv init -)"' >> ~/.bash_profile gem install chef

  • initialize workstation

    • in the clusters/workstation.rb file, add a facet named for yourself (${chef_user})
    • knife cluster sync workstation-${chef_user} --sync-all --no-cloud will create the chef node for you, and leave the client key in knife/credentials/client_keys/client-workstation-${chef_user}-0.pem.
    • run the following (note the $USER vs $chef_user)

      sudo mkdir /etc/chef sudo chown $USER /etc/chef cp knife/credentials/client_keys/client-workstation-${chef_user}-0.pem /etc/chef cp config/client.rb /etc/chef mkdir -p /usr/local/var/chef/$USER

    • lastly, edit the top section of the /etc/chef/client.rb file to add your organization, facet and facet_index

  • run chef-client -- your workstation should configure itself!!

What it do

Ironfan Toolset

Chimpstation uses ironfan, an expressive toolset for constructing scalable, resilient architectures. The full Ironfan toolset:


  • ironfan-homebase: Centralizes the cookbooks, roles and clusters. A solid foundation for any Chef user.
  • ironfan gem: The core Ironfan models, and Knife plugins to orchestrate machines and coordinate truth among your homebase, cloud and chef server.
  • ironfan-pantry: Our collection of industrial-strength, cloud-ready recipes for Hadoop, HBase, Cassandra, Elasticsearch, Zabbix and more.
  • silverware cookbook: Helps you coordinate discovery of services ("list all the machines for awesome_webapp, that I might load balance them") and aspects ("list all components that write logs, that I might logrotate them, or that I might monitor the free space on their volumes"). Found within the ironfan-pantry.


To jump right into using Ironfan, follow our Installation Instructions. For an explanatory tour, check out our Web Walkthrough. Please file all issues on Ironfan Issues.


Ideas, code, inspiration, two bucks in change, an old copy of Tiger Beat, but mostly code were taken from:

Something went wrong with that request. Please try again.