cookbook 'rails_application', '= 0.1.7'
rails_application (14) Versions 0.1.7 Follow15
Installs/Configures rails_application
cookbook 'rails_application', '= 0.1.7', :supermarket
knife supermarket install rails_application
knife supermarket download rails_application
rails_application Cookbook
This cookbooks installs the server-side Rails application.
Unlike the official OpsCode cookbooks, this cookbook has all of the possible
tweaks externalized in the form of attributes - it was intended that this
cookbook is used by a wrapper cookbook that provides the attributes which
configure the rails application per the requirements of the actual application.
This cookbook replaces the unicorn process supervisor to be upstart instead of
runit, it means that it will work on Ubuntu systems, later versions might allow
customizing the process supervisor as well.
Requirements
Tested on Ubuntu 12.04 and depends on several OpsCode official cookbooks that
actually do the majority of the work.
packages
This cookbook depends on several OpsCode cookbooks, namely -
- git
- ruby
- nginx
- unicorn
- application
- application_ruby
- application_nginx
for the rails_application::database_credentials cookbook, you also need -
- database
Several of the above required minor modifications, all of these have pull
requests and tickets with OpsCode, but until these get accepted, forks that
include the modifications are available here -
application_nginx cookbook
- Ticket: http://tickets.opscode.com/browse/COOK-2579
- Pull Request: https://github.com/opscode-cookbooks/application_nginx/pull/5
- Modified Cookbook: https://github.com/devops-israel/opscode-cookbooks-application_nginx.git
application_ruby cookbook (no pull requests at this time)
- Modified Cookbook: https://github.com/devops-israel/opscode-cookbooks-application_ruby.git
OpsCode cookbooks are available at -
- https://github.com/opscode-cookbooks/git.git
- https://github.com/opscode-cookbooks/ruby.git
- https://github.com/opscode-cookbooks/nginx.git
- https://github.com/opscode-cookbooks/unicorn.git
- https://github.com/opscode-cookbooks/application.git
- https://github.com/opscode-cookbooks/application_ruby.git
- https://github.com/opscode-cookbooks/application_nginx.git
- https://github.com/opscode-cookbooks/database.git
Attributes
rails_application::default
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>rails/ruby/version</tt></td>
<td>String</td>
<td>which ruby version to use, see: ruby cookbook</td>
<td><tt>1.9.1</tt></td>
</tr>
<tr>
<td><tt>rails/app/name</tt></td>
<td>String</td>
<td>how to call the application</td>
<td><tt>rails_app</tt></td>
</tr>
<tr>
<td><tt>rails/app/path</tt></td>
<td>String</td>
<td>where the application is deployed to</td>
<td><tt>/var/www/project/{{rails/app/name}}</tt></td>
</tr>
<tr>
<td><tt>rails/app/environment</tt></td>
<td>String</td>
<td>rails/rack environment name</td>
<td><tt>production</tt></td>
</tr>
<tr>
<td><tt>rails/owner</tt></td>
<td>String</td>
<td>user name to own files and processes</td>
<td><tt>deploy</tt></td>
</tr>
<tr>
<td><tt>rails/group</tt></td>
<td>String</td>
<td>group name to own files and processes</td>
<td><tt>deploy</tt></td>
</tr>
</tr>
<tr>
<td><tt>rails/packages</tt></td>
<td>Array</td>
<td>additional packages that need to be installed for the application to work</td>
<td><tt>[ ]</tt></td>
</tr>
<tr>
<td><tt>rails/gems</tt></td>
<td>Array</td>
<td>additional system-wide gems that need to be installed for the application to work</td>
<td><tt>[ ]</tt></td>
</tr>
</table>
Usage
rails_application::default
Just include rails_application
in your node's run_list
:
{ "name":"my_node", "run_list": [ "recipe[rails_application]" ] }
Contributing
This cookbook is still a work in progress, you are welcome to help by
contributing fixes, documentation and tests.
e.g.
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write you change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
License
See [LICENSE](LICENSE) for full details.
Authors:
- Evgeny Zislis evgeny@devops.co.il
- Elad Dolev elad@devops.co.il
Dependent cookbooks
git >= 0.0.0 |
ruby >= 0.0.0 |
nginx >= 0.0.0 |
unicorn >= 0.0.0 |
application >= 2.0.2 |
application_ruby >= 0.0.0 |
application_nginx >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.