DevBox-Golong

Vagrant box backed by Docker or Virtualbox, with Ansible provisioning

A Vagrant box (Virtualbox or Docker as providers) with Ansible provisioning for setting up a Vim-based Golang development environment.

Note: There are currently problems with the docker version of the script, so please use the virtualbox version until this is solved!

Ingredients

• Ubuntu 16.04 "xenial" LTS 64bit base image
• Go(lang) 1.6.2
• Vim
• Fatih's vim-go plugin, providing syntax highlight, gocode integration for autocompletion, and more.
  • See the vim-go README for more info on how you can easily enable additional included features.
• GoCode Go completion engine
• Git
• Tig - text mode interface to git
• gdb - the GNU debugger
• cgdb - Curses based user interface to gdb

Optional ingredients

Uncomment roles in playbook.yml to enable these.

• Valloric's YouCompleteMe for as-you-type completion (NB: Requires uncommenting the YouCompleteMe role in playbook.yml!)).
• Apache Mesos - An open source computer cluster manager. (UI on localhost:5050).

Prerequisites

• Vagrant
• Ansible
• VirtualBox (Not required if you use Docker as provider!)
• Docker (Not required if you use Virtualbox as provider!)

Installing the requirements in Ubuntu (tested with 14.04)

1. Install Virtualbox:

   sudo apt-get install virtualbox
   

2. Install Docker:

   sudo apt-get install docker.io
   

3. Install a recent version of ansible:

   sudo apt-get install ansible/trusty-backports
   

   (if you ubuntu version is "trusty", otherwise, replace it with your appropriate version)

4. Install Vagrant, by first downloadng the proper .deb file from vagrantup.com

5. ... and then installing it with:

   sudo dpkg -i <deb-file>
   

Setup and Usage

Clone the github repository:

git clone [email protected]:samuell/devbox-golang
cd devbox-golang

Bring up the VM

With docker provider (Expect it to take at least ~8m):

vagrant up docker

With VirtualBox provider (Expect it to take at least ~20m):

vagrant up virtualbox

Log in to the VM

With docker provider:

vagrant ssh docker

With VirtualBox provider:

vagrant ssh virtualbox

Create a repository for uploading to github:

mkcd ~/code/go/src/github/<user>/<repo>
git init .

Now, start coding!

vim main.go

A tip on how you can upload your existing git ssh keys to the new vm:

With the following command you can get the info you need to run scp against the machine:

vagrant ssh-config [docker | virtualbox]

Note the hostname and port number (and identity file, if you with), and run, for example:

scp -i <identity-file-path> -P <portno> \
	~/.ssh/id_rsa_<whateveryounamedit> \
	vagrant@<hostname>:/home/vagrant/.ssh/

Then, sometimes, in order to get the new key activated in your shell after logging in to the vm, you might need to do:

ssh-agent bash -l
ssh-add ~/.ssh/id_rsa_<whateveryounamedit>

• Autocompletion will happen automatically
• If you have turned off the YouCompleteMe role, you will get autocompletion with <C-x><C-o>

Known issues

• GDB Breakpoints don't take, unless you follow the advice given here. That is, in short, do this on your Host machine, if you run Ubuntu:

  sudo apt-get install apparmor-utils
  sudo echo 'aa-complain /etc/apparmor.d/docker' >> /etc/rc.local
  sudo aa-complain /etc/apparmor.d/docker
  

  The problem seems to be that ptrace is not given access to the process otherwise.

• There are some really red message from the docker daemon when running vagrant halt. Everything seems to work as expected though (including the shutdown)

• There are some red message on vagrant up, but they are nothing serious, and can be ignored for now.

• When building Go 1.5 dev, the build will end with a lot of error messages, but that is from the tests after the build. The build itself seems to work, largely.

References

• Vagrant & Ansible Quickstart Tutorial