Changeset 13823 for main/waeup-ansible/README.rst

Timestamp:

10 Apr 2016, 12:04:54 (8 years ago)

Author:

uli

Message:

Add a Vagrantfile.

And tell something about it in README.

File:

• main/waeup-ansible/README.rst (modified) (1 diff)

main/waeup-ansible/README.rst

@@ -1 @@
-Playbooks for administrating WAeUP servers.
-===========================================
+=============================================
+ Playbooks for administrating WAeUP servers.
+=============================================
 
 These are materials to use with our servers.
+
+For starters: the tutorial given on
+
+  https://github.com/leucos/ansible-tuto
+
+is a really nice hands-on intro to `ansible`. Please read it!
+
+Vagrant
+=======
+
+In `Vagrantfile` we set up a vagrant environment which provides three
+hosts as virtualbox:
+
+  ``vh5.sample.org``, ``vh6.sample.org``, ``vh7.sample.org``
+
+running Ubuntu 14.04. ``vh5`` represents "virtual host 5" and should
+reflect h5.waeup.org. The same holds for ``vh6`` and ``vh7``
+accordingly.
+
+The three virtual hosts are for testing any upcoming ansible
+playbooks. They should be used before running playbooks on the real
+hosts!
+
+
+Initialize Vagrant Env
+----------------------
+
+You must have `vagrant` installed, if possible in a fairly recent
+version. I (uli) use `vagrant 1.8.1` (latest as time of writing).  As
+Ubuntu 14.04 is pretty outdated in that respect, I had to grab a .deb
+package from
+
+  https://www.vagrantup.com/downloads.html
+
+that could be installed with::
+
+ $ sudo dpkg -i vagrant_1.8.1_x86_64.deb
+
+
+When everything is in place, change into this directory and run::
+
+  $ vagrant up
+  Bringing machine 'vh5' up with 'virtualbox' provider...
+  Bringing machine 'vh6' up with 'virtualbox' provider...
+  Bringing machine 'vh7' up with 'virtualbox' provider...
+  ==> vh5: Importing base box 'ubuntu/trusty32'...
+  ...
+
+This will fetch Vagrant virtualbox images for trusty32, i.e. Ubuntu
+14.04 images, 32bit version (plays nice also on 64bit hosts).
+
+All three hosts provide ssh access via::
+
+  $ vagrant ssh vh0
+
+or equivalent commands. They have a user 'vagrant' installed, which
+can sudo without password.
+
+You can halt (all) the virtual hosts with::
+
+  $ vagrant halt