Fetching contributors…
Cannot retrieve contributors at this time
17 lines (10 sloc) 1.81 KB


To run octocatalog-diff you will need these basics:

  • Ruby 2.0 or higher
  • Mac OS, Linux, or other Unix-line operating system (Windows is not supported)
  • Ability to install gems, e.g. with rbenv or rvm, or root privileges to install into the system Ruby
  • Puppet agent for Linux or Mac OS X, or installed as a gem

We recommend that you also have the following to get the most out of octocatalog-diff, but these are not absolute requirements:

  • If your Puppet code stored in a git repository, octocatalog-diff can check out branches for you as it does its comparisons. Your git repository can be stored on, GitHub Enterprise, or similar. If your Puppet code is not stored in a git repository, you can still point the tool at "from" and "to" directories, but you'll have to check them out yourself.

  • If you have API access (HTTPS) to PuppetDB, octocatalog-diff can retrieve facts automatically and also support exported resources if you use them. If you are not using PuppetDB or don't have access, the tool can still read facts from YAML files.

  • If your site uses an external node classifier, octocatalog-diff can execute the ENC script as part of its catalog compiles. Depending on how your ENC is designed, this may require network access or credentials to some service. If you are not using an ENC, that's fine. If you have an ENC but don't have the requisite access, depending on your setup the tool could produce unexpected results.