1.. _proxy-minion-beacon:
2
3.. versionadded:: 2015.8.3
4
5===================
6Proxy Minion Beacon
7===================
8
9
10The salt proxy beacon is meant to facilitate configuring
11multiple proxies on one or many minions. This should simplify
12configuring and managing multiple ``salt-proxy`` processes.
13
141. On your salt-master, ensure that pillar is configured properly.  Select an ID
15   for your proxy (in this example we will name the proxy 'p8000').
16   In your pillar topfile, place an entry for your proxy:
17
18.. code-block:: yaml
19
20   base:
21     'p8000':
22       - p8000
23
24This says that Salt's pillar should load some values for the proxy ``p8000``
25from the file ``/srv/pillar/p8000.sls`` (if you have not changed your default pillar_roots)
26
272. In the pillar root for your base environment, create the ``p8000.sls`` file with the
28   following contents:
29
30.. code-block:: yaml
31
32   proxy:
33     # set proxytype for your proxymodule
34     proxytype: ssh_sample
35     host: saltyVM
36     username: salt
37     password: badpass
38
39This should complete the proxy setup for ``p8000``
40
413. `Configure`_ the ``salt_proxy`` beacon
42
43.. code-block:: yaml
44
45    beacons:
46      salt_proxy:
47        - proxies:
48            p8000: {}
49            p8001: {}
50
51
52Once this beacon is configured it will automatically start the ``salt-proxy``
53process. If the ``salt-proxy`` process is terminated the beacon will
54re-start it.
55
564. Accept your proxy's key on your salt-master
57
58.. code-block:: bash
59
60   salt-key -y -a p8000
61   The following keys are going to be accepted:
62   Unaccepted Keys:
63   p8000
64   Key for minion p8000 accepted.
65
665. Now you should be able to run commands on your proxy.
67
68.. code-block:: bash
69
70    salt p8000 pkg.list_pkgs
71
72.. _Configure: https://docs.saltproject.io/en/latest/topics/beacons/#configuring-beacons
73