chef-protobuf

Description

Installs Protocol Buffer C++, Java, and Python libraries. protobuf-c (for C support) is a separate project and is not included in this cookbook. Please see [COMPATIBILITY.md](COMPATIBILITY.md) for more information about protobuf 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

• apt
• build-essential
• yum

Attributes

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

Archive Attributes

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

Package Attributes

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

Recipes

• recipe[protobuf] Installs Protocol Buffer
• recipe[protobuf::archive] Installs protobuf via archive
• recipe[protobuf::cpp] Installs protobuf C++
• recipe[protobuf::java] Installs protobuf Java
• recipe[protobuf::package_cpp] Installs protobuf C++ packages
• recipe[protobuf::package_java] Installs protobuf Java packages
• recipe[protobuf::package_python] Installs protobuf Python packages
• recipe[protobuf::python] Installs protobuf Python

Usage

Default Installation

Installs protobuf C++, Java, and Python. Recommended to use cpp, java, and python directly instead.

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

C++ Installation Only

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

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

Java Installation Only

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

• Add recipe['protobuf::java'] to your node's run list

Python Installation Only

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

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

Archive Installation

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

C++ Package Installation Only

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

Java Package Installation Only

• Add recipe['protobuf::package_java'] to your node's run list

Python Package Installation Only

• Add recipe['protobuf::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-protobuf.git
cd chef-protobuf
vagrant up BOX # BOX being centos6, ubuntu1204, ubuntu1210, or ubuntu1304

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](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

• Brian Flad (bflad417@gmail.com)