/chef-brightbox

Brightbox Next Gen Ruby + Passenger / Nginx recipes for Chef.

Primary LanguageRubyApache License 2.0Apache-2.0

chef-brightbox

This recipe provides support for installing the BrightBox builds of Ruby 1.9.3, Nginx and Passenger.

For more documentation on these builds, please see the official brightbox documentation.

Please Note: If you're upgrading from an older version, the default action is to upgrade packages. To change this, you need to override node['brightbox']['ruby']['default_action'].

Usage

Simple add chef-brightbox to your recipe, and then include one of the following recipes:

Name Description
brightbox::default Installs the ruby and nginx passenger recipes.
brightbox::ruby Adds the repository, Installs The full Ruby 1.9 package from brightbox, sets it as the default then installs a sane server gemrc and adds bundler, rake and rubygems-bundler gems to bootstrap your environment.
brightbox::nginx_passenger Requires the ruby recipe, will install passenger with 1.9.1 and nginx, setting up nginx to use passenger.

Definitions

We provide a nginx_site recipe that will enable / disable an nginx vhost.

Usage is similar to:

# Use the configuration at /etc/nginx/sites-available/your-application.com
# Note we don't generate that configuration
nginx_site "your-application.com" do
  enable true # Or false, true is default.
end

Contributing

We encourage all community contributions. Keeping this in mind, please follow these general guidelines when contributing:

  • Fork the project
  • Create a topic branch for what you’re working on (git checkout -b awesome_feature)
  • Commit away, push that up (git push your_remote awesome_feature)
  • Create a new GitHub Issue with the commit, asking for review. Alternatively, send a pull request with details of what you added.
  • Once it’s accepted, if you want access to the core repository feel free to ask! Otherwise, you can continue to hack away in your own fork.

Other than that, our guidelines very closely match the GemCutter guidelines here.

(Thanks to GemCutter for the contribution guide)

Copyright

Copyright 2012-2013 Filter Squad.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.