Man Linux: Main Page and Category List

NAME

       cap — cap is an utlity to invoke capistrano tasks.

SYNOPSIS

       cap <command> [options]

DESCRIPTION

       Capistrano  is  a  utility  and  framework  for  executing  commands in
       parallel on multiple remote machines, via SSH. It  uses  a  simple  DSL
       (borrowed  in  part  from Rake, http://rake.rubyforge.org/) that allows
       you to define _tasks_, which may be  applied  to  machines  in  certain
       roles.  It also supports tunneling connections via some gateway machine
       to allow operations to be performed behind VPN’s and firewalls.

       Capistrano was originally designed to simplify and automate  deployment
       of  web  applications  to distributed environments, and originally came
       bundled with a set of tasks designed for deploying Rails  applications.
       The  deployment tasks are now (as of Capistrano 2.0) opt-in and require
       clients to explicitly put "load ’deploy’" in their recipes.

       Capistrano is  a  self-documenting program by giving you  an  extensive
       help  listing  for  each command. If you think that this manual page is
       outdated, simply running

       cap -h

ASSUMPTIONS

       Capistrano is "opinionated software", which  means  it  has  very  firm
       ideas about how things ought to be done, and tries to force those ideas
       on you. Some of the assumptions behind these opinions are:

         * You are using SSH to access the remote servers.
         * You either have the same password to all target  machines,  or  you
       have public keys in place to allow passwordless access to them.

       Do not expect these assumptions to change.

OPTIONS

       Capistrano   is  extensible  configurable,  and  it  has  the following
       configuration options:

       -e           --explain TAKS
                 Displays help (if available) for the task.

       -F           --default-config
                 Always use default config, even with -f.

       -f           --file FILE
                 A recipe file to load. May be given more than once.

       -H           --long-help
                 Explain these options.

       -h           --help
                 Display this help message.

       -p           --password
                 Immediately prompt for the password.

       -q           --quiet
                 Make the output as quiet as possible.

       -S           --set-before NAME=VALUE
                 Set a variable before the recipes are loaded.

       -s           --set NAME=VALUE
                 Set a variable after the recipes are loaded.

       -T           --taks
                 List all tasks in the loaded recipe files.

       -V           --version
                 Display the Capistrano version, and exit.

       -v           --verbose
                 Be more verbose. May be given more than once.

       -X           --skip-system-config
                 Don’t load the system config file (capistrano.conf)

       -x           --skip-user-config
                 Don’t load the user config file (.caprc)

SEE ALSO

       capify (1).

AUTHOR

       This  manual  page  was   written   by   Leandro   Nunes   dos   Santos
       leandronunes@colivre.coop.br  for the Debian system (but may be used by
       others).  Permission is granted to copy, distribute and/or modify  this
       document  under  the terms of the GNU General Public License, Version 2
       any later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public  License
       can be found in /usr/share/common-licenses/GPL.

                                                                 CAPISTRANO(1)