projects / vagrant-mail.git / blame
| Commit | Line | Data |
|---|---|---|
| 8de79ad0 NI |
1 | Notes about vagrant-salt usage |
| 2 | ============================== | |
| 3 | ||
| 4 | Documentation links | |
| 5 | ------------------- | |
| 6 | ||
| 7 | * https://docs.saltstack.com/en/latest/topics/tutorials/quickstart.html | |
| 8 | Salt masterless quickstart | |
| 9 | ||
| 10 | ||
| 11 | Quick 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 | ||
| 979ba964 NI |
31 | * Sync files and re-run salt:: |
| 32 | ||
| 33 | vagrant rsync testvm && vagrant provision testvm | |
| 34 | ||
| 8de79ad0 NI |
35 | * Apply salt configuration (in an SSH session):: |
| 36 | ||
| 37 | sudo salt-call --local state.highstate | |
| 38 | ||
| 39 | * Apply a specfic .sls file:: | |
| 40 | ||
| 41 | sudo salt-call --local state.sls common.packages | |
| 42 | ||
| 43 | * List the current grains:: | |
| 44 | ||
| 45 | sudo salt-call --local grains.ls | |
| 46 | sudo salt-call --local grains.items | |
| 47 | ||
| cbf0e0a2 NI |
48 | * List the current pillar items:: |
| 49 | ||
| 50 | sudo salt-call --local pillar.items | |
| 51 | ||
| 8de79ad0 NI |
52 | |
| 53 | Random notes during the development of the project | |
| 54 | -------------------------------------------------- | |
| 55 | ||
| 56 | * Architecture: a test VM is installed with a fully functionnal mailing system. It is connected to a `gateway` VM which filters almost everything: | |
| 57 | ||
| 58 | - HTTP communications are forwarded (to allow installing packets) | |
| 59 | - emails are never forwarded but stored on the VM | |
| 60 | - every other TCP and UDP ports are filtered | |
| 61 |