/Vaprobash

Vagrant Provisioning Bash Scripts

Primary LanguageShell

This repository

This repository contains next set of changes, that probably are not going to end up in the original repo for various reasons:

  • WINDOWS FRIENDLY (7/10, 8 should work too)
  • By default, calculates the amount of available memory and CPU cores and gives half to the VM, does not create swap. Any of these can be specified manualy and will be respected.
  • By default forwards web (80) and mysql (3306) ports into VM (easy to edit) for easy access and ability to configure IDE SQL auto complete and validation.
  • Detects if host machine is Windows and does not enable NFS and cachefilesd if that's the case (avoiding critical errors during provisioning).
  • Cachefilesd is a package, so it can be disabled if needed (by default it is enabled in case non-windows host machine).
  • Enabled NAT related VM options by default - fixes issues with ethernet, we use Ubuntu boxes by default after all.
  • If hostmanager vagrant plugin is installed, makes hostname same as VM name.
  • Has ability to specify any number of additional hosts (provides phpmyadmin.hostname and xhprof.hostname by default, if relevant packages are enabled), avoids hostname by making additional host as sub domains of the main hostname.
  • Has phpMyAdmin package (avaliable at phpmyadmin.hostname)
  • Has xhprof profiler for PHP package (avaliable at xhprof.hostname)
  • Has a different file name for project-specific provisioning script, better reflecting what it represents.
  • Removed apache-mpm-prefork installation, as it has issues with installation.
  • PHP: configures logs (/var/log/php), timezone (whatever is set in the Vagrantfile) and error reporting levels (E_ALL) out of the box. Also installs xdebug.

Install vagrant-hostmanager to get husle-free hostname management, I do not work without, and expect hosts to be managed by the plugin. vagrant-share is a good idea too

$ vagrant plugin install vagrant-hostmanager vagrant-share

Feel free to contribute ideas and changes that make your life easier, my fork is not intended to be too generalized and aims at out-of-the-box ease of use. Still, you have to give the ability to change the default for people, so hardcoded values should be avoided.

Vaprobash

Va​grant Pro​visioning Bash Scripts

View the site and extended docs.

Build Status

Goal

The goal of this project is to create easy to use bash scripts in order to provision a Vagrant server.

  1. This targets Ubuntu LTS releases, currently 14.04.*
  2. This project will give users various popular options such as LAMP, LEMP
  3. This project will attempt some modularity. For example, users might choose to install a Vim setup, or not.

Some further assumptions and self-imposed restrictions. If you find yourself needing or wanting the following, then other provisioning tool would better suited (Chef, Puppet, Ansible).

  • If other OSes need to be used (CentOS, Redhat, Arch, etc).
  • If dependency management becomes complex. For example, installing Laravel depends on Composer. Setting a document root for a project will change depending on Nginx or Apache. Currently, these dependencies are accounted for, but more advanced dependencies will likely not be.

Dependencies

  • Vagrant 1.5.0+
    • Use vagrant -v to check your version
  • Vitualbox or VMWare Fusion

Instructions

First, Copy the Vagrantfile from this repo. You may wish to use curl or wget to do this instead of cloning the repository.

# curl
$ curl -L http://bit.ly/vaprobash > Vagrantfile

# wget
$ wget -O Vagrantfile http://bit.ly/vaprobash

The bit.ly link will always point to the master branch version of the Vagrantfile.

Second, edit the Vagrantfile and uncomment which scripts you'd like to run. You can uncomment them by removing the # character before the config.vm.provision line.

You can indeed have multiple provisioning scripts when provisioning Vagrant.

Third and finally, run:

$ vagrant up

Screencast

Here's a quickstart screencast!

Vaprobash Quickstart

Windows Users:

By default, NFS won't work on Windows. I suggest deleting the NFS block so Vagrant defaults back to its default file sync behavior.

However, you can also try the "vagrant-winnfsd" plugin. Just run vagrant plugin install vagrant-winnfsd to try it out!

Vagrant version 1.5 will have more file sharing options to explore as well!

Docs

View the site and extended docs.

What You Can Install

  • Base Packages
    • Base Items (Git and more!)
    • PHP (php-fpm)
    • Vim
    • PHP MsSQL (ability to connect to SQL Server)
    • Screen
    • Docker
  • Web Servers
    • Apache
    • HHVM
    • Nginx
  • Databases
    • Couchbase
    • CouchDB
    • MariaDB
    • MongoDB
    • MySQL
    • Neo4J
    • PostgreSQL
    • SQLite
  • In-Memory Stores
    • Memcached
    • Redis
  • Search
    • ElasticSearch and ElasticHQ
  • Utility
    • Beanstalkd
    • Supervisord
    • Kibana
  • Additional Languages
    • NodeJS via NVM
    • Ruby via RVM
  • Frameworks / Tooling
    • Composer
    • Laravel
    • Symfony
    • PHPUnit
    • MailCatcher
    • Ansible
    • Android

The Vagrantfile

The vagrant file does three things you should take note of:

  1. Gives the virtual machine a static IP address of 192.168.22.10. This IP address is again hard-coded (for now) into the LAMP, LEMP and Laravel/Symfony installers. This static IP allows us to use xip.io for the virtual host setups while avoiding having to edit our computers' hosts file.
  2. Uses NFS instead of the default file syncing. NFS is reportedly faster than the default syncing for large files. If, however, you experience issues with the files actually syncing between your host and virtual machine, you can change this to the default syncing by deleting the lines setting up NFS:
config.vm.synced_folder ".", "/vagrant",
          id: "core",
          :nfs => true,
          :mount_options => ['nolock,vers=3,udp,noatime']
  1. Offers an option to prevent the virtual machine from losing internet connection when running on Ubuntu. If your virtual machine can't access the internet, you can solve this problem by uncommenting the two lines below:
  #vb.customize ["modifyvm", :id, "--natdnshostresolver1", "on"]
  #vb.customize ["modifyvm", :id, "--natdnsproxy1", "on"]

Don't forget to reload your Vagrantfile running vagrant reload --no-provision, in case your virtual machine already exists.

Connecting to MySQL from Sequel Pro:

Change your IP address as needed. The default IP address is now 192.168.22.10

sequel pro vaprobash

Contribute!

Do it! Any new install or improvement on existing ones are welcome! Please see the contributing doc.