Make Vagrantfile work again
[vagrant-mail.git] / test-vagrant-salt / NOTES.rst
CommitLineData
8de79ad0
NI
1Notes about vagrant-salt usage
2==============================
3
4Documentation links
5-------------------
6
7* https://docs.saltstack.com/en/latest/topics/tutorials/quickstart.html
8 Salt masterless quickstart
9
10
11Quick commands
12--------------
13
14* Start a VM::
15
16 vagrant up
17
2a121065
NI
18* Start a VM using libvirt provider instead of VirtualBox::
19
20 vagrant up --provider=libvirt
21
8de79ad0
NI
22* SSH into a VM::
23
24 vagrant ssh gateway
25 vagrant ssh testvm
26
27* Destroy a VM::
28
29 vagrant destroy
30
31* Apply salt configuration (in an SSH session)::
32
33 sudo salt-call --local state.highstate
34
35* Apply a specfic .sls file::
36
37 sudo salt-call --local state.sls common.packages
38
39* List the current grains::
40
41 sudo salt-call --local grains.ls
42 sudo salt-call --local grains.items
43
cbf0e0a2
NI
44* List the current pillar items::
45
46 sudo salt-call --local pillar.items
47
8de79ad0
NI
48
49Random notes during the development of the project
50--------------------------------------------------
51
52* Architecture: a test VM is installed with a fully functionnal mailing system. It is connected to a `gateway` VM which filters almost everything:
53
54 - HTTP communications are forwarded (to allow installing packets)
55 - emails are never forwarded but stored on the VM
56 - every other TCP and UDP ports are filtered
57