69263fbc624c12dfde81badb1edfb8c8014a3d5b
[dockerfile.git] / salt-minion / README.md
1 Run this [Salt Stack][salt] minion image with:
2
3     $ docker run -d --name salt-minion-0 --hostname salt-minion-0 wking/salt-minion
4
5 The [default master name][master-name] is `salt`, so make sure that
6 resolves appropriately on your Docker host (via DNS or an entry in
7 `/etc/hosts`).
8
9 You have two options for setting up minon keys.  The more secure
10 approach is to create and install minion keys on the master:
11
12     salt# mkdir /tmp/salt-minion-0
13     salt# chmod 700 /tmp/salt-minion-0
14     salt# salt-key --gen-keys=minion --gen-keys-dir=/tmp/salt-minion-0
15     salt# cp /tmp/salt-minion-0/minion.pub /etc/salt/pki/master/minions/salt-minion-0
16     salt# cp /etc/salt/pki/master/master.pub /tmp/salt-minion-0/minion_master.pub
17     salt# scp -rp /tmp/salt-minion-0/ docker-host:/etc/salt/pki/salt-minion-0/
18     salt# rm -rf /tmp/salt-minion-0
19
20 and [preseed the minion][preseed] with a [volume
21 mount][volume-mount]:
22
23     $ docker run -d --name salt-minion-0 --hostname salt-minion-0 \
24     >   -v /etc/salt/pki/salt-minion-0:/etc/salt/pki/minion wking/salt-minion
25
26 The less secure approach is to [auto-accept][] the minion's
27 internally-generated key.
28
29 [salt]: http://saltstack.com/community.html
30 [master-name]: http://docs.saltstack.com/ref/configuration/minion.html#master
31 [preseed]: http://docs.saltstack.com/topics/tutorials/preseed_key.html
32 [volume-mount]: http://docs.docker.io/en/latest/use/working_with_volumes/
33 [auto-accept]: http://docs.saltstack.com/ref/configuration/master.html#auto-accept