Skip to content

dhgwilliam/hiera-browser

Repository files navigation

hiera-browser

Gem Version Inline docs Code Climate

hiera-browser is a tool that simply makes an admin aware of what values a node can expect to retrieve from hiera.

As of right now, hiera-browser only supports infrastructures with a single yaml backend.

WARNING

What this tool does is it takes all your configuration data, including anything it can decrypt using hiera-eyaml, and exposes it. Please be careful about how you run this software in production.

installing

For open source puppet:

gem install hiera-browser
HIERA_YAML=$(puppet master --configprint hiera_config) hiera-browser

For PE:

/opt/puppet/bin/gem install hiera-browser
HIERA_YAML=$(/opt/puppet/bin/puppet master --configprint hiera_config) /opt/puppet/bin/hiera-browser

as of right now, this runs hiera-browser as a totally exposed web server, so be careful

testing

NOTE: as above, this will install the FOSS puppet gem, so be careful

bundle install
bundle exec rake cucumber
bundle exec rake rspec

or, alternatively, if you're actively developing against hiera-browser, it might be worthwhile to run guard:

bundle exec guard

This will launch a guard process that should run tests whenever you save classes or spec tests.

demoing

There is real live (fake) test data so you can get a demo up and running fairly quickly:

bundle install
bundle exec rake demo

contributors