@@ -1,62 +1,61 @@ = passenger-recipes -* http://github.com/jtrupiano/passenger-recipes/tree/master +* http://github.com/jtrupiano/passenger-recipes/tree/master == DESCRIPTION: -This gem provides a set of recipes for deploying with Passenger. It's much -more restrictive than Capistrano in the sense that it 'locks down' some -aspects of what Capistrano actually allows. See the FEATURES section +This gem provides a set of recipes for deploying with Passenger. It's much +more restrictive than Capistrano in the sense that it 'locks down' some +aspects of what Capistrano actually allows. See the FEATURES section below for more specific details. - -== INCOMPLETE == -* Missing a detailed sample config file -* This README is still quite sparse-- add in summaries for each new task -* Describe changes to default deploy recipes -* Discuss dependencies a bit more -* Implement OS-specific default values (Ubuntu and CentOS at a minimum) + +== INCOMPLETE == +* Missing a detailed sample config file +* This README is still quite sparse-- add in summaries for each new task +* Describe changes to default deploy recipes +* Discuss dependencies a bit more +* Implement OS-specific default values (Ubuntu and CentOS at a minimum) == FEATURES/PROBLEMS: - -* Enforces non-root deployment. The deploy:setup task does not actually - execute anything, but rather outputs a set of instructions for you - to manually execute. The reason for this is that certain aspects of - setting up a server require root access. Incremental deployment, by - contrast, does not require this level of privilege. As such, we - recommend that you take care of setting up your server by yourself. - - Note: to "lift" this restriction, you can simply override the - :ensure_not_root function. However, this is not recommended, - considering Apache needs to own all of your files. e.g. - - def ensure_not_root; end - -* Sets up a symlink in the shared directory (passenger.conf) that is - updated on each successive deploy. This allows you to change your - apache config through a deployment. Note that you'll need sudoer - privilege to restart apache (deploy:with_restart) to restart apache. - -* NEW PROPERTIES --> DEFAULTS - # Where is the apache config snippet - :apache_conf --> {"#{latest_release}/config/#{rails_env}/apache.conf"} - - # Which group does apache run as - :apache_group --> www-data - - # Full path to the graceful restart command of apache - :apache_restart_cmd --> /usr/sbin/apache2ctl +* Enforces non-root deployment. The deploy:setup task does not actually + execute anything, but rather outputs a set of instructions for you + to manually execute. The reason for this is that certain aspects of + setting up a server require root access. Incremental deployment, by + contrast, does not require this level of privilege. As such, I + recommend that you take care of setting up your server manually. + + Note: to "lift" this restriction, you can simply override the + :ensure_not_root function. e.g. + + def ensure_not_root; end + + However, this is not recommended, considering Apache needs to own all + of your files. + +* Sets up a symlink in the shared directory (passenger.conf) that is + updated on each successive deploy. This allows you to change your + apache config through a deployment. You'll need to log in manually + as a privileged user to restart apache. + +* NEW PROPERTIES --> DEFAULTS + # Where is the apache config snippet + :apache_conf --> {"#{latest_release}/config/#{rails_env}/apache.conf"} + + # Which group does apache run as + :apache_group --> www-data + == SYNOPSIS: FIX (code sample of usage) == REQUIREMENTS: -* capistrano-extensions 0.1.1 +* capistrano-extensions 0.1.4 == INSTALL: -* rake gem -* sudo gem install pkg/passenger-recipes-0.1.1.gem --local +* rake gem +* sudo gem install pkg/passenger-recipes-0.1.2.gem --local == LICENSE: README.txt 5a896ce65363ff9fca1ce9ffc0c954de9e616db9 John Trupiano john@john-trupianos-macbook-pro.local http://github.com/jtrupiano/passenger-recipes/commit/e6fd3480751a53e74037b90b50618bb6d9fdd309 e6fd3480751a53e74037b90b50618bb6d9fdd309 2008-10-20T19:16:28-07:00 2008-10-20T19:16:28-07:00 Fixed some out of date info in the README. d27832b8f68d77216c65d995df31ef7c50ca1da3 John Trupiano john@john-trupianos-macbook-pro.local