/vagrant-guests-clearlinux

A plugin that adds Clear Linux guest support to Vagrant

Primary LanguageRubyApache License 2.0Apache-2.0

Plugin that adds Clear Linux guest support to Vagrant

Gem Version

Once it gets feature complete and rock solid, and time and resources permit, work will start in order to get this plugin merged into upstream.

Currently the plugin exposes the following guest capabilities to Vagrant:

Beyond adding proper Clear Linux guest support to Vagrant this plugin also comes bundled two additional provisioners:

  • a simple provisioner that enable basics swupd operations straight from the Vagrantfile:

    • adding one or more bundles

      config.vm.provision :bundle_add, bundles: 'wireshark'
      # alternatively ... functionally equivalent to above
      # config.vm.provision :bundle_add do |p|
      #  p.bundles = 'wireshark'
      # end
    • removing one or more bundles

      # assuming it was installed already ...
      config.vm.provision :bundle_remove, bundles: [ 'wireshark', 'nmap' ]
      # alternatively ... functionally equivalent to above
      # config.vm.provision :bundle_remove do |p|
      #  p.bundles = ['wireshark', 'nmap']
      # end
  • a provisioner to set the desired timezone

    Given that the available ClearLinux boxes ship with a default timezone set unlikely to suit everyone (Author's one Portugal aka Europe/Lisbon) here's how to programatically your own straight from the Vagrantfile:

    config.vm.provision :set_timezone, timezone: 'Asia/Dili'

    Vagrant loading will abort if the provided timezone is invalid

Compatible Vagrant boxes

The Clear Linux Vagrant boxes come bundled with this plugin and, in most conditions, should install it automatically.

For additional information about them please visit their documentation.

Manual Maintenance

Manual Installation

❯❯❯ vagrant plugin install vagrant-guests-clearlinux

Manual Upgrading

❯❯❯ vagrant plugin update vagrant-guests-clearlinux

Development

To build, install or modify the plugin directly from this repository:

NOTE: commands bellow assume you have a working docker environment.

❯❯❯ make build
❯❯❯ make local-install VERSION=...

where VERSION is whatever is being set in lib/vagrant-guests-clearlinux/version.rb

You can run RSpec with:

❯❯❯ bundle install
❯❯❯ bundle exec rake

Feedback

Bug Reports and Feature Suggestions and Pull Requests. You're welcome!

Acknowledgments

This was developed, initially, inspired in works of Fabio Rapposelli on vagrant-guests-photon and Alex Sorkin on vagrant-guests-innovitable.