2013-07-07 03:33:46 +00:00
|
|
|
============
|
|
|
|
``salt-ssh``
|
|
|
|
============
|
|
|
|
|
|
|
|
Synopsis
|
|
|
|
========
|
|
|
|
|
2014-07-13 16:02:33 +00:00
|
|
|
.. code-block:: bash
|
|
|
|
|
2013-07-07 03:33:46 +00:00
|
|
|
salt-ssh '*' [ options ] sys.doc
|
|
|
|
|
|
|
|
salt-ssh -E '.*' [ options ] sys.doc cmd
|
|
|
|
|
|
|
|
Description
|
|
|
|
===========
|
|
|
|
|
2013-11-23 23:18:40 +00:00
|
|
|
Salt SSH allows for salt routines to be executed using only SSH for transport
|
2013-07-07 03:33:46 +00:00
|
|
|
|
|
|
|
Options
|
|
|
|
=======
|
|
|
|
|
2013-09-29 05:16:13 +00:00
|
|
|
.. option:: -r, --raw, --raw-shell
|
|
|
|
|
|
|
|
Execute a raw shell command.
|
|
|
|
|
2014-02-05 14:32:16 +00:00
|
|
|
.. option:: --priv
|
|
|
|
|
|
|
|
Specify the SSH private key file to be used for authentication.
|
|
|
|
|
2014-01-22 17:18:09 +00:00
|
|
|
.. option:: --roster
|
2013-09-29 05:16:13 +00:00
|
|
|
|
|
|
|
Define which roster system to use, this defines if a database backend,
|
|
|
|
scanner, or custom roster system is used. Default is the flat file roster.
|
|
|
|
|
2014-01-22 17:24:29 +00:00
|
|
|
.. option:: --roster-file
|
|
|
|
|
|
|
|
Define an alternative location for the default roster file location. The
|
|
|
|
default roster file is called ``roster`` and is found in the same directory
|
|
|
|
as the master config file.
|
|
|
|
|
2014-07-01 21:01:12 +00:00
|
|
|
.. versionadded:: 2014.1.0
|
2014-01-22 17:24:29 +00:00
|
|
|
|
2013-09-29 05:16:13 +00:00
|
|
|
.. option:: --refresh, --refresh-cache
|
|
|
|
|
|
|
|
Force a refresh of the master side data cache of the target's data. This
|
|
|
|
is needed if a target's grains have been changed and the auto refresh
|
|
|
|
timeframe has not been reached.
|
|
|
|
|
|
|
|
.. option:: --max-procs
|
|
|
|
|
|
|
|
Set the number of concurrent minions to communicate with. This value
|
|
|
|
defines how many processes are opened up at a time to manage connections,
|
|
|
|
the more running process the faster communication should be, default
|
|
|
|
is 25.
|
2014-12-11 03:37:07 +00:00
|
|
|
|
2014-02-05 14:32:16 +00:00
|
|
|
.. option:: -i, --ignore-host-keys
|
|
|
|
|
|
|
|
Ignore the ssh host keys which by default are honored and connections
|
|
|
|
would ask for approval.
|
2013-09-29 05:16:13 +00:00
|
|
|
|
|
|
|
.. option:: --passwd
|
|
|
|
|
2014-02-03 10:19:11 +00:00
|
|
|
Set the default password to attempt to use when authenticating.
|
2013-09-29 05:16:13 +00:00
|
|
|
|
|
|
|
.. option:: --key-deploy
|
|
|
|
|
|
|
|
Set this flag to attempt to deploy the authorized ssh key with all
|
|
|
|
minions. This combined with --passwd can make initial deployment of keys
|
|
|
|
very fast and easy.
|
|
|
|
|
2013-07-07 03:33:46 +00:00
|
|
|
.. program:: salt
|
|
|
|
|
2013-08-10 13:19:43 +00:00
|
|
|
.. include:: _includes/common-options.rst
|
2013-07-07 03:33:46 +00:00
|
|
|
|
2013-08-10 09:27:31 +00:00
|
|
|
.. include:: _includes/target-selection.rst
|
2013-07-07 03:33:46 +00:00
|
|
|
|
2013-08-10 13:06:53 +00:00
|
|
|
.. include:: _includes/logging-options.rst
|
|
|
|
.. |logfile| replace:: /var/log/salt/ssh
|
|
|
|
.. |loglevel| replace:: ``warning``
|
2013-08-10 13:19:43 +00:00
|
|
|
|
2013-08-10 09:06:17 +00:00
|
|
|
.. include:: _includes/output-options.rst
|
2013-07-07 03:33:46 +00:00
|
|
|
|
|
|
|
|
|
|
|
See also
|
|
|
|
========
|
|
|
|
|
|
|
|
:manpage:`salt(7)`
|
|
|
|
:manpage:`salt-master(1)`
|
2014-12-11 03:37:07 +00:00
|
|
|
:manpage:`salt-minion(1)`
|