This is a Vagrant plugin adding support for Alpine Linux guests.
NOTE: The vagrant-alpine plugin requires Vagrant 1.7+
This plugin is now part of Vagrant core as of Vagrant 2.2.6. It is recommended that you uninstall the vagrant-alpine plugin if you are using Vagrant 2.2.6 or above.
apk update
and apk add --upgrade
to nfs client install$ vagrant plugin install vagrant-alpine
$ vagrant init maier/alpine-3.3.1-x86_64
$ vagrant up
or
$ vagrant init maier/alpine-3.2.3-x86_64
$ vagrant up
or
$ vagrant init maier/alpine-3.1.3-x86_64
$ vagrant up
The vagrant-alpine plugin does not offer any configuration options.
To work on the vagrant-alpine
plugin, clone this repository, and use
Bundler to get the dependencies:
$ gem install bundler -v '~> 1.7.0'
$ bundle install --path vendor/bundle
Once you have the dependencies, verify the unit tests pass with rake
:
$ bundle exec rake
If those pass, you're ready to start developing. You can test
the plugin without installing it into your Vagrant environment
by creating a Vagrantfile
in teh top level directory (it is gitignored).
There is an example supplied in this repository.
(cp Vagrantfile.example Vagrantfile
and edit.)
Use bundler to execute Vagrant:
$ bundle exec vagrant up
Alpine Linux boxes for testing are available on Atlas. Packer templates for building the boxes are in this GitHub repository.
Using VAGRANT_LOG=info
, Vagrant's --debug
switch, and vb.gui = true
were all very useful when originally developing this guest plugin.