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.
As blogged by Dave Cheney, cross-compilation to different platforms is now (in the latest Go 1.5 development version) as simple as setting two environment variables and running go build!
To let us laymen test this out easily, we have included an ansible role (aka "build script") for the latest Go 1.5
in this repo. To activate it, just open up the playbook.yml
file and uncomment the row - golang-1.5
, and instead comment out
the line saying - golang
, before running vagrant up docker
or vagrant up virtualbox
.
So, instead of looking like this:
roles:
- { role: dotfiles, sudo: false }
- { role: golang, sudo: false }
#- { role: golang-1.5, sudo: false }
- { role: youcompleteme, sudo: false } # Comment out this to save time!!
... it should look like this:
roles:
- { role: dotfiles, sudo: false }
#- { role: golang, sudo: false }
- { role: golang-1.5, sudo: false }
- { role: youcompleteme, sudo: false } # Comment out this to save time!!
Note: Please see the "known issues" below though, about messages about failed tests, when building!
(You might also consider commenting out the "YouCompleteMe" step to start with, if you want to play around with this quickly)
- Ubuntu 14.04 "trusty" LTS 64bit base image
- Go(lang) 1.4.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
- Valloric's YouCompleteMe for as-you-type completion.
- Git
- Tig - text mode interface to git
- gdb - the GNU debugger
- cgdb - Curses based user interface to gdb
- Vagrant
- Ansible
- VirtualBox (Not required if you use Docker as provider!)
- Docker (Not required if you use Virtualbox as provider!)
-
Install Virtualbox:
sudo apt-get install virtualbox
-
Install Docker:
sudo apt-get install docker.io
-
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)
-
Install Vagrant, by first downloadng the proper .deb file from vagrantup.com
-
... and then installing it with:
sudo dpkg -i <deb-file>
git clone git@github.com:samuell/devbox-golang
cd devbox-golang
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
With docker provider:
vagrant ssh docker
With VirtualBox provider:
vagrant ssh virtualbox
mkcd ~/code/go/src/github/<user>/<repo>
git init .
vim main.go
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>
-
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.