Notes about vagrant-salt usage
==============================

Documentation links
-------------------

* https://docs.saltstack.com/en/latest/topics/tutorials/quickstart.html
  Salt masterless quickstart


Quick commands
--------------

* Start a VM::

    vagrant up

* Start a VM using libvirt provider instead of VirtualBox::

    vagrant up --provider=libvirt

* SSH into a VM::

    vagrant ssh gateway
    vagrant ssh testvm

* Destroy a VM::

    vagrant destroy

* Sync files and re-run salt::

     vagrant rsync testvm && vagrant provision testvm

* Apply salt configuration (in an SSH session)::

    sudo salt-call --local state.highstate

* Apply a specfic .sls file::

    sudo salt-call --local state.sls common.packages

* List the current grains::

    sudo salt-call --local grains.ls
    sudo salt-call --local grains.items

* List the current pillar items::

    sudo salt-call --local pillar.items


Random notes during the development of the project
--------------------------------------------------

* Architecture: a test VM is installed with a fully functionnal mailing system.  It is connected to a `gateway` VM which filters almost everything:

    - HTTP communications are forwarded (to allow installing packets)
    - emails are never forwarded but stored on the VM
    - every other TCP and UDP ports are filtered