GitHubHelp

bflad/chef-gflags

Chef Cookbook for Google Commandline Flags Module

★ 0Forks 0RubyGitHub ↗Compare

README

chef-gflags Build Status

Description

Installs gflags. Please see COMPATIBILITY.md for more information about gflags versions that are tested and supported by cookbook versions.

Requirements

Platforms

  • CentOS 6
  • Fedora 18, 19, 20
  • RHEL 6
  • Ubuntu 12.04, 12.10, 13.04, 13.10

Cookbooks

Opscode Cookbooks

Attributes

These attributes are under the node['gflags'] namespace.

Attribute Description Type Default
install_type Override platform and version auto-detection for installation ("archive" or "package") String nil (auto-detect)

Archive Attributes

These attributes are under the node['gflags']['archive'] namespace.

Attribute Description Type Default
checksum SHA256 checksum for archive String auto-detected (see attributes/default.rb)
install_dir Installation prefix String /usr/local
url Archive URL String https://gflags.googlecode.com/files/gflags-#{node['gflags']['archive']['version']}.tar.bz2
version Archive version to install String 2.0

Package Attributes

These attributes are under the node['gflags']['package'] namespace.

Attribute Description Type Default
cpp_packages C++ packages for installation Array of Strings auto-detected (see attributes/default.rb)
python_packages Python packages for installation Array of Strings auto-detected (see attributes/default.rb)

Recipes

  • recipe[gflags] Installs gflags
  • recipe[gflags::archive] Installs gflags via archive
  • recipe[gflags::cpp] Installs gflags C++
  • recipe[gflags::package_cpp] Installs gflags C++ packages
  • recipe[gflags::package_python] Installs gflags Python packages
  • recipe[gflags::python] Installs gflags Python

Usage

Default Installation

Installs gflags C++ and Python. Recommended to use cpp and python directly instead.

  • Add recipe[gflags] to your node's run list

C++ Installation Only

Installs gflags C++ via archive or package depending on platform and version auto-detection or node['gflags']['install_type'] if set.

  • Add recipe['gflags::cpp'] to your node's run list

Python Installation Only

Installs gflags Python via archive or package depending on platform and version auto-detection or node['gflags']['install_type'] if set.

  • Add recipe['gflags::python'] to your node's run list

Archive Installation

  • If necessary, set node['gflags']['archive']['version'] and node['gflags']['archive']['checksum']
  • Set node['gflags']['install_type'] to "archive" or add recipe['gflags::archive'] to your node's run list

C++ Package Installation Only

  • Add recipe['gflags::package_cpp'] to your node's run list

Python Package Installation Only

  • Add recipe['gflags::package_python'] to your node's run list

Testing and Development

Vagrant

Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant and Berkshelf.

vagrant plugin install vagrant-berkshelf
vagrant plugin install vagrant-cachier
vagrant plugin install vagrant-omnibus
git clone git://github.com/bflad/chef-gflags.git
cd chef-gflags
vagrant up BOX # BOX being centos5, centos6, debian7, fedora18, fedora19, fedora20, freebsd9, ubuntu1204, ubuntu1210, ubuntu1304, or ubuntu1310

You can then SSH into the running VM using the vagrant ssh BOX command.

The VM can easily be stopped and deleted with the vagrant destroy command. Please see the official Vagrant documentation for a more in depth explanation of available commands.

Test Kitchen

Please see documentation in: TESTING.md

Contributing

Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes or Test Kitchen suite.

Maintainers

Contributors

bflad

Issues