mirror of
https://github.com/valitydev/salt.git
synced 2024-11-08 09:23:56 +00:00
3273bbdab7
Conflicts: - doc/ref/configuration/master.rst - doc/ref/modules/all/index.rst - doc/topics/grains/index.rst - doc/topics/releases/2016.3.4.rst - doc/topics/spm/spm_formula.rst - doc/topics/tutorials/cron.rst - doc/topics/tutorials/index.rst - doc/topics/tutorials/stormpath.rst - salt/engines/slack.py - salt/log/handlers/fluent_mod.py - salt/modules/cyg.py - salt/modules/junos.py - salt/modules/namecheap_dns.py - salt/modules/namecheap_domains.py - salt/modules/namecheap_ns.py - salt/modules/namecheap_ssl.py - salt/modules/namecheap_users.py - salt/modules/reg.py - salt/modules/tomcat.py - salt/modules/vault.py - salt/modules/win_file.py - salt/modules/zpool.py - salt/output/highstate.py - salt/renderers/pass.py - salt/runners/cache.py - salt/states/boto_apigateway.py - salt/states/boto_iam.py - salt/states/boto_route53.py - salt/states/msteams.py - salt/states/reg.py - salt/states/win_iis.py - tests/integration/modules/test_cmdmod.py - tests/integration/states/test_user.py - tests/support/helpers.py - tests/unit/cloud/clouds/test_openstack.py - tests/unit/fileserver/test_gitfs.py - tests/unit/modules/test_junos.py - tests/unit/pillar/test_git.py - tests/unit/states/test_win_path.py - tests/unit/test_pillar.py - tests/unit/utils/test_format_call.py - tests/unit/utils/test_utils.py - tests/unit/utils/test_warnings.py
121 lines
3.6 KiB
ReStructuredText
121 lines
3.6 KiB
ReStructuredText
.. _ref-cli-salt:
|
|
|
|
========
|
|
``salt``
|
|
========
|
|
|
|
Synopsis
|
|
========
|
|
|
|
salt '*' [ options ] sys.doc
|
|
|
|
salt -E '.*' [ options ] sys.doc cmd
|
|
|
|
salt -G 'os:Arch.*' [ options ] test.ping
|
|
|
|
salt -C 'G@os:Arch.* and webserv* or G@kernel:FreeBSD' [ options ] test.ping
|
|
|
|
Description
|
|
===========
|
|
|
|
Salt allows for commands to be executed across a swath of remote systems in
|
|
parallel. This means that remote systems can be both controlled and queried
|
|
with ease.
|
|
|
|
Options
|
|
=======
|
|
|
|
.. program:: salt
|
|
|
|
.. include:: _includes/common-options.rst
|
|
|
|
.. include:: _includes/timeout-option.rst
|
|
.. |timeout| replace:: 5
|
|
|
|
.. option:: -s, --static
|
|
|
|
By default as of version 0.9.8 the salt command returns data to the
|
|
console as it is received from minions, but previous releases would return
|
|
data only after all data was received. Use the static option to only return
|
|
the data with a hard timeout and after all minions have returned.
|
|
Without the static option, you will get a separate JSON string per minion
|
|
which makes JSON output invalid as a whole.
|
|
|
|
.. option:: --async
|
|
|
|
Instead of waiting for the job to run on minions only print the job id of
|
|
the started execution and complete.
|
|
|
|
.. option:: --subset=SUBSET
|
|
|
|
Execute the routine on a random subset of the targeted minions. The
|
|
minions will be verified that they have the named function before
|
|
executing. The SUBSET argument is the count of the minions to target.
|
|
|
|
.. option:: -v VERBOSE, --verbose
|
|
|
|
Turn on verbosity for the salt call, this will cause the salt command to
|
|
print out extra data like the job id.
|
|
|
|
.. option:: --hide-timeout
|
|
|
|
Instead of showing the return data for all minions. This option
|
|
prints only the online minions which could be reached.
|
|
|
|
.. option:: -b BATCH, --batch-size=BATCH
|
|
|
|
Instead of executing on all targeted minions at once, execute on a
|
|
progressive set of minions. This option takes an argument in the form of
|
|
an explicit number of minions to execute at once, or a percentage of
|
|
minions to execute on.
|
|
|
|
.. option:: -a EAUTH, --auth=EAUTH
|
|
|
|
Pass in an external authentication medium to validate against. The
|
|
credentials will be prompted for. The options are `auto`,
|
|
`keystone`, `ldap`, and `pam`. Can be used with the -T
|
|
option.
|
|
|
|
.. option:: -T, --make-token
|
|
|
|
Used in conjunction with the -a option. This creates a token that allows
|
|
for the authenticated user to send commands without needing to
|
|
re-authenticate.
|
|
|
|
.. option:: --return=RETURNER
|
|
|
|
Choose an alternative returner to call on the minion, if an
|
|
alternative returner is used then the return will not come back to
|
|
the command line but will be sent to the specified return system.
|
|
The options are `carbon`, `cassandra`, `couchbase`, `couchdb`,
|
|
`elasticsearch`, `etcd`, `hipchat`, `local`, `local_cache`,
|
|
`memcache`, `mongo`, `mysql`, `odbc`, `postgres`, `redis`,
|
|
`sentry`, `slack`, `sms`, `smtp`, `sqlite3`, `syslog`, and `xmpp`.
|
|
|
|
.. option:: -d, --doc, --documentation
|
|
|
|
Return the documentation for the module functions available on the minions
|
|
|
|
.. option:: --args-separator=ARGS_SEPARATOR
|
|
|
|
Set the special argument used as a delimiter between command arguments of
|
|
compound commands. This is useful when one wants to pass commas as
|
|
arguments to some of the commands in a compound command.
|
|
|
|
.. include:: _includes/logging-options.rst
|
|
.. |logfile| replace:: /var/log/salt/master
|
|
.. |loglevel| replace:: ``warning``
|
|
|
|
.. include:: _includes/target-selection.rst
|
|
.. include:: _includes/extended-target-selection.rst
|
|
|
|
.. include:: _includes/output-options.rst
|
|
|
|
|
|
See also
|
|
========
|
|
|
|
:manpage:`salt(7)`
|
|
:manpage:`salt-master(1)`
|
|
:manpage:`salt-minion(1)`
|