= app-deploy 0.7
by Lin Jen-Shin (aka godfat-真常[http://godfat.org])
  godfat (XD) godfat.org

== LINKS:

* github-project[http://github.com/godfat/app-deploy]

== DESCRIPTION:

 rake tasks for deployment

== FEATURES:

$ rake -T app
(in /Users/godfat/project/godfat/app-deploy)
rake app:daemon:restart[config]                       # restart the daemon cluster
rake app:daemon:start[config]                         # start the daemon cluster
rake app:daemon:stop[config]                          # stop the daemon cluster
rake app:deploy                                       # deploy to master state
rake app:deploy:after                                 # after deploy hook for you to override
rake app:deploy:before                                # before deploy hook for you to override
rake app:gem:install                                  # install gems
rake app:gem:reinstall                                # reinstall gems
rake app:gem:uninstall                                # uninstall gems
rake app:git[cmd]                                     # generic git cmd walk through all dependency
rake app:git:clone                                    # clone repoitory from github
rake app:git:pull                                     # pull anything from origin
rake app:git:stash                                    # make anything reflect master state
rake app:git:submodule                                # init and update submodule
rake app:install                                      # install this application
rake app:install:after                                # after install hook for you to override
rake app:install:before                               # before install hook for you to override
rake app:install:remote[hosts,git,cd,branch,script]   # remote installation
rake app:nginx:kill[signal]                           # send a signal to nginx
rake app:nginx:reload                                 # reload config
rake app:nginx:restart[config,nginx,timeout]          # restart nginx
rake app:nginx:start[config,nginx]                    # start nginx, default config is config/nginx.conf
rake app:nginx:stop[timeout]                          # stop nginx
rake app:rack:restart[config]                         # restart the rack cluster
rake app:rack:start[config]                           # start the rack cluster
rake app:rack:stop[config]                            # stop the rack cluster
rake app:remote:setup[user,file,hosts,script]         # upload a tarball and untar to user home, then useradd
rake app:remote:sh[hosts,script]                      # invoke a shell script on remote machines
rake app:remote:upload[file,hosts,path]               # upload a file to remote machines
rake app:remote:useradd[user,hosts,script]            # create a user on remote machines
rake app:server:reload                                # reload nginx(passenger)
rake app:server:restart                               # please define your server:restart task
rake app:signal:kill[signal,pidfile,name]             # send a signal to a process with a pidfile
rake app:signal:reload[pidfile,name]                  # send HUP to a process with a pidfile
rake app:signal:restart[script,pidfile,name,timeout]  # restart a process with a pidfile
rake app:signal:start[script,pidfile]                 # execute a script if pidfile is not existed
rake app:signal:stop[pidfile,name,timeout]            # terminate a process with a pidfile
rake app:unicorn:kill[signal]                         # send a signal to unicorn
rake app:unicorn:reload                               # reload config
rake app:unicorn:restart[config,env,unicorn,timeout]  # restart unicorn
rake app:unicorn:start[config,env,unicorn]            # start unicorn, default config is config/unicorn.rb
rake app:unicorn:stop[timeout]                        # stop unicorn

== SYNOPSIS:

 see
   - example/Rakefile
   - example/rack_cluster.yaml
   - example/daemon_cluster.yaml

== REQUIREMENTS:

* ruby 1.8.7+
* [required] rake
* [optional] rubygems for rubygems task
* [optional] git      for git      task
* [optional] nginx    for nginx    task
* [optional] rack and daemons for rack-cluster task
* [optional] thin     for thin     task

== INSTALL:

* gem install app-deploy

== LICENSE:

Apache License 2.0

Copyright (c) 2008-2009, Lin Jen-Shin (aka godfat 真常)

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.