docs/recipes/deploy.txt in capitate-0.2.2 vs docs/recipes/deploy.txt in capitate-0.2.3
- old
+ new
@@ -87,14 +87,18 @@
h3(#deploy:restart). deploy:restart
+Restarts your application. This works by calling the script/process/reaper script under the current path.
+By default, this will be invoked via sudo as the `app' user. If you wish to run it as a different user, set the :runner variable to that user. If you are in an environment where you can't use sudo, set the :use_sudo variable to false:
+ set :use_sudo, false
+
h3(#deploy:rollback). deploy:rollback
Rolls back to a previous version and restarts. This is handy if you ever discover that you've deployed a lemon; `cap rollback' and you're right back where you were, on the previously deployed version.
@@ -115,16 +119,20 @@
h3(#deploy:start). deploy:start
+Start the application servers. This will attempt to invoke a script in your application called `script/spin', which must know how to start your application listeners. For Rails applications, you might just have that script invoke `script/process/spawner' with the appropriate arguments.
+By default, the script will be executed via sudo as the `app' user. If you wish to run it as a different user, set the :runner variable to that user. If you are in an environment where you can't use sudo, set the :use_sudo variable to false.
h3(#deploy:stop). deploy:stop
+Stop the application servers. This will call script/process/reaper for both the spawner process, and all of the application processes it has spawned. As such, it is fairly Rails specific and may need to be overridden for other systems.
+By default, the script will be executed via sudo as the `app' user. If you wish to run it as a different user, set the :runner variable to that user. If you are in an environment where you can't use sudo, set the :use_sudo variable to false.
h3(#deploy:symlink). deploy:symlink