salt/doc/topics/proxyminion/beacon.rst

73 lines
1.7 KiB
ReStructuredText

.. _proxy-minion-beacon:
.. versionadded:: 2015.8.3
===================
Proxy Minion Beacon
===================
The salt proxy beacon is meant to facilitate configuring
multiple proxies on one or many minions. This should simplify
configuring and managing multiple ``salt-proxy`` processes.
1. On your salt-master, ensure that pillar is configured properly. Select an ID
for your proxy (in this example we will name the proxy 'p8000').
In your pillar topfile, place an entry for your proxy:
.. code-block:: yaml
base:
'p8000':
- p8000
This says that Salt's pillar should load some values for the proxy ``p8000``
from the file /srv/pillar/p8000.sls (if you have not changed your default pillar_roots)
2. In the pillar root for your base environment, create this file:
.. code-block:: yaml
p8000.sls
---------
proxy:
# set proxytype for your proxymodule
proxytype: ssh_sample
host: saltyVM
username: salt
password: badpass
This should complete the proxy setup for ``p8000``
3. `Configure`_ the ``salt_proxy`` beacon
.. code-block:: yaml
beacons:
salt_proxy:
- p8000: {}
Once this beacon is configured it will automatically start the ``salt-proxy``
process. If the ``salt-proxy`` process is terminated the beacon will
re-start it.
4. Accept your proxy's key on your salt-master
.. code-block:: bash
salt-key -y -a p8000
The following keys are going to be accepted:
Unaccepted Keys:
p8000
Key for minion p8000 accepted.
5. Now you should be able to run commands on your proxy.
.. code-block:: bash
salt p8000 pkg.list_pkgs
.. _Configure: https://docs.saltstack.com/en/latest/topics/beacons/#configuring-beacons