Oh-My-Vagrant: This is: Oh My Vagrant!
Status:
This project was always meant to be a useful tool for its author. Others found it helpful, and I was happy to share and help improve it. From my perspective, it's now mostly feature complete, and since I've been focusing most of my time on mgmt, there aren't any major planned changes coming. As a result please use, share and enjoy it, but development is going to be limited to what the community provides. We have other maintainers, so that I'm not a bottleneck on any patch reviews or merges! Happy hacking! -- purpleidea
Documentation:
Please see: DOCUMENTATION.md or PDF.
Questions:
Come join us in #vagrant on Freenode!
Installation:
Please read the INSTALL file for instructions on getting this installed.
Examples:
Please look in the examples/ folder for usage. If none exist, please contribute one!
Module specific notes:
- This was born as 'vagrant-puppet-docker-template'...
- I decided it could be more useful as a general project...
- I renamed it because the original name was dumb...
- The current name is obviously a nod to the success of the 'oh-my-zsh' project, although I'm actually a bash user :)
- It is an attempt to provide a general purpose environment to make it easier to get hacking on vagrant+puppet+docker things.
- There are still some unresolved issues, but it can be useful as reference, or as a starting point for a hacker to customize.
- There are a number of published articles about this environment:
- https://ttboj.wordpress.com/2014/09/03/introducing-oh-my-vagrant/
- https://ttboj.wordpress.com/2015/04/08/sharing-dev-environments-with-oh-my-vagrant/
- https://ttboj.wordpress.com/2015/04/20/docker-containers-in-oh-my-vagrant/
- https://ttboj.wordpress.com/2015/05/02/kubernetes-clusters-with-oh-my-vagrant/
- https://ttboj.wordpress.com/2015/06/12/a-super-privileged-puppet-container/
- https://ttboj.wordpress.com/2015/07/08/oh-my-vagrant-mainstream-mode-and-copr-rpms/
- https://ttboj.wordpress.com/2015/08/11/vagrant-and-oh-my-vagrant-on-rhel7/
- https://ghantoos.org/2015/12/20/how-to-setup-run-oh-my-vagrant-on-debian-with-libvirt-and-kvm/
- There are some screencasts available:
Dependencies:
- vagrant (available in Fedora 21+, Debian)
- vagrant-libvirt (available in Fedora 21+)
- in the meantime please test: https://copr.fedoraproject.org/coprs/jstribny/vagrant-f20/
- vagrant-hostmanager
- you need the feat/oh-my-vagrant patches for this to work properly
- to install them, run the script from: extras/patch-hostmanager.sh
- vagrant-reload
- for the "reboot" option to work
- puppetlabs-stdlib (optional, built-in)
- puppet-module-data (optional, puppet >= 3.0.0, built-in)
- my puppet-puppet module (optional, built-in)
- my puppet-yum module (optional, built-in)
- pandoc (for building a pdf of the documentation)
Note: If you are using VirtualBox as hypervisor, there is no need to depend on vagrant-libvirt.
Patches:
We'd love to have your patch! Please send it by email, or as a pull request.
Happy hacking!