vagrant-hyperkit 0.4.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f5ce45036bd7a7d3f65d972301650b4700baf1d2
+  data.tar.gz: 68a19a45835c28643262be39618916132eb7aa21
+SHA512:
+  metadata.gz: 3fa1b42098d6f408c4ca34408a25b2d527699cdbcc470d4326b2bc9b199a824477d81f9fc8f2a72334a1aebba668cf845fa6e9fc8880b362a31ed050f9dca004
+  data.tar.gz: 9f7865ae40d23bc5fef0e6ec5cf94bfa01c5a7c4b316f573fd00bed66824c4ccf4b8d8e93910bb15e5758e6f705b1ad9dc0315a23f22ebf057304b83cb63d4a8

data/.gitignore

@@ -0,0 +1,22 @@
+# OS-specific
+.DS_Store
+
+# editors
+*.swp
+
+# Bundler/Rubygems
+*.gem
+.bundle
+pkg/*
+tags
+Gemfile.lock
+
+# Vagrant
+.vagrant
+Vagrantfile
+example_box
+example.box
+
+# RVM files for gemset/ruby setting
+.ruby-*
+.rvmrc

data/.rspec

@@ -0,0 +1 @@
+--format doc --order random --color --fail-fast

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# 0.4.1 (December 10th, 2016)
+
+* Put the embedded version of xhyve-ruby first in the LOAD_PATH (Guy Pascarella)
+
+# 0.4.0 (December 10th, 2016)
+
+* Added qcow support to use with hyperkit
+* Fixed intermittent failures with certain MAC addresses
+
+# 0.3.0 (December 5th, 2016)
+
+* Added `kernel_command` option to set custom kernel parameters (Nuno Passaro)
+
+# 0.2.0 (July 23, 2016)
+
+* Added ability to set custom binary (to work with docker beta etc)
+
+# 0.1.1 (April 5, 2016)
+
+* Initial release.

data/Gemfile

@@ -0,0 +1,14 @@
+source "https://rubygems.org"
+
+group :plugins do
+  gemspec
+  gem "xhyve-ruby", :path => "vendor/xhyve-ruby"
+end
+
+group :development do
+  # We depend on Vagrant for development, but we don't add it as a
+  # gem dependency because we expect to be installed within the
+  # Vagrant environment itself using `vagrant plugin`.
+  gem "vagrant", :git => "https://github.com/mitchellh/vagrant.git"
+end
+

data/LICENSE

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+Copyright (c) 2016 Patrick Armstrong
+Copyright (c) 2014 Mitchell Hashimoto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,221 @@
+
+
+bundle install
+
+
+
+
+
+508  bundler build
+  509  bundle build
+  510  bundle gem vagrant-xhyve
+  511  ls -l
+  512  ls -ltr
+  513  find . -name '*gem' -print
+  514  bundle package
+  515  rake build
+  516  ls -l
+  517  df -h
+  518  rake build --trace
+  519  ruby --version
+  520  rake build --help
+  521  rake build -v
+  522  rake build --help
+  523  rake build -t
+  524  pwd
+  525  rake build
+  526  vagrant plugin list
+  527  pwd
+  528  rake build
+  529  rake build
+  530  ls -l
+  531  sudo rm Gemfile.lock 
+  532  rake build
+  533  pwd
+  534  sudo bundle install
+  535  rake build
+  536  ls -l
+  537  ls -l pkg/
+  538  vagrant plugin list
+  539  vagrant plugin --help
+  540  vagrant plugin uninstall vagrant-xhyve
+  541  vagrant plugin install pkg/vagrant-xhyve-0.4.2.gem 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+# Vagrant xhyve Provider
+
+[![Gem Version](https://badge.fury.io/rb/vagrant-xhyve.svg)](https://badge.fury.io/rb/vagrant-xhyve)
+
+This is a [Vagrant](http://www.vagrantup.com) plugin that adds an [xhyve](http://xhyve.org)
+provider to Vagrant.
+
+## Features
+
+* Basic features work
+* Can work with Hyperkit fork of Xhyve
+* qcow image support
+
+## Limitations
+
+You need to use sudo for most vagrant actions with the xhyve driver,
+due to the entitlements needed for xhyve to run without sudo. More details
+in the [xhyve github issue](https://github.com/mist64/xhyve/issues/60).
+
+## Usage
+
+Install using standard Vagrant plugin installation methods. After
+installing, `vagrant up` and specify the `xhyve` provider. An example is
+shown below.
+
+```
+$ vagrant plugin install vagrant-xhyve
+...
+$ sudo vagrant up --provider=xhyve
+...
+```
+
+Of course prior to doing this, you'll need to obtain an xhyve-compatible
+box file for Vagrant.
+
+## Quick Start
+
+After installing the plugin (instructions above), you can try an xhyve ubuntu
+linux example. This is similar to the example from the xhyve intro blog post.
+
+```
+$ mkdir xhyve-vagrant
+$ cd xhyve-vagrant
+$ vagrant init oldpatricka/ubuntu-14.04
+$ sudo vagrant up --provider xhyve
+...
+```
+
+This will start an Ubuntu Linux instance. you can log in with:
+
+```
+$ sudo vagrant ssh
+```
+
+## Box Format
+
+The vagrant-xhyve box format is pretty straightforward. See
+the [example_box/ directory](https://github.com/oldpatricka/vagrant-xhyve/tree/master/example_box).
+That directory also contains instructions on how to build a box.
+
+## Configuration
+
+This provider exposes quite a few provider-specific configuration options:
+
+* `memory` - The amount of memory to give the VM. This can just be a simple
+  integer for memory in MB or you can use the suffixed style, eg. 2G for two
+  Gigabytes
+* `cpus` - The number of CPUs to give the VM
+* `xhyve_binary` - use a custom xhyve version
+* kernel_command - send a custom kernel boot command
+
+These can be set like typical provider-specific configuration:
+
+```ruby
+Vagrant.configure("2") do |config|
+  # ... other stuff
+
+  config.vm.provider :xhyve do |xhyve|
+    xhyve.cpus = 2
+    xhyve.memory = "1G"
+    xhyve.xhyve_binary = "/Applications/Docker.app/Contents/MacOS/com.docker.hyperkit"
+    xhyve.kernel_command = "root=/dev/mapper/centos-root ro crashkernel=auto rd.lvm.lv=centos/root rd.lvm.lv=centos/swap acpi=off console=ttyS0 LANG=en_GB.UTF-8" # example for a CentOS installed in a LVM filesystem
+  end
+end
+```
+## Synced Folders
+
+There is minimal support for synced folders. Upon `vagrant up`,
+`vagrant reload`, and `vagrant provision`, the XHYVE provider will use
+`rsync` (if available) to uni-directionally sync the folder to
+the remote machine over SSH.
+
+## Using Docker's HyperKit Fork of Xhyve
+
+Docker has a very nice port of Xhyve called [HyperKit](https://github.com/docker/hyperkit). It has some interesting features like better stability and qcow support (which this provider can't use yet).
+
+If you want to try it out, either install hyperkit directly, or you can use the version bundled with [Docker for Mac](https://docs.docker.com/engine/installation/mac/). The path to the binary is `/Applications/Docker.app/Contents/MacOS/com.docker.hyperkit`. See the configuration section above for how to use this with the `xhyve_binary` option.
+
+## Questions
+
+Q. Should I use this for my work?
+
+A. Do you want to keep your job? I'm not even sure you should use this for toy
+projects.
+
+Q. Why?
+
+A. This project is powered by ignorance and good intentions.
+
+Q. Will I ever not have to use sudo or setuid root?
+
+A. There's a theory in that issue linked above that wrapping xhyve in an
+app store app would help. If that were the case, you could probably use the
+embedded binary with vagrant-xhyve. Another option is to use setuid root.
+
+Q. This sucks.
+
+A. That's not a question, but why don't you try out [another implementation](https://github.com/sirn/vagrant-xhyve). Looks pretty nice.
+
+## Acknowledgements
+
+This plugin was heavilly cribbed from the vagrant-aws and vagrant-virtualbox
+providers. So thanks for those.
+
+This also uses the nice [xhyve-ruby](https://github.com/dalehamel/xhyve-ruby)
+gem, by Dale Hamel.
+
+## Development
+
+To work on the `vagrant-xhyve` plugin, clone this repository out, and use
+[Bundler](http://gembundler.com) to get the dependencies:
+
+```
+$ 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 the plugin. You can test
+the plugin without installing it into your Vagrant environment by just
+creating a `Vagrantfile` in the top level of this directory (it is gitignored)
+and add the following line to your `Vagrantfile`
+```ruby
+Vagrant.require_plugin "vagrant-xhyve"
+```
+Use bundler to execute Vagrant:
+```
+$ bundle exec vagrant up --provider=xhyve
+```
+
+## Contributors
+
+* Patrick Armstrong
+* Nuno Passaro
+* Guy Pascarella

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rspec/core/rake_task'
+
+# Immediately sync all stdout so that tools like buildbot can
+# immediately load in the output.
+$stdout.sync = true
+$stderr.sync = true
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+# This installs the tasks that help with gem creation and
+# publishing.
+Bundler::GemHelper.install_tasks
+
+# Install the `spec` task so that we can run tests.
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--order defined"
+end
+# Default task is to run the unit tests
+task :default => :spec

data/lib/vagrant-hyperkit.rb

@@ -0,0 +1,22 @@
+require "pathname"
+
+require "vagrant-hyperkit/plugin"
+
+module VagrantPlugins
+  module HYPERKIT
+    lib_path = Pathname.new(File.expand_path("../vagrant-hyperkit", __FILE__))
+    autoload :Action, lib_path.join("action")
+    autoload :Errors, lib_path.join("errors")
+
+    # Put vagrant-xhyve-x.y.z/vendor/xhyve-ruby/lib on the LOAD_PATH before
+    # the auto-loaded xhyve-ruby-a.b.c
+    $LOAD_PATH.unshift(Pathname.new(File.expand_path("../../vendor/xhyve-ruby/lib", __FILE__)))
+
+    # This returns the path to the source of this plugin.
+    #
+    # @return [Pathname]
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path("../../", __FILE__))
+    end
+  end
+end

data/lib/vagrant-hyperkit/action.rb

@@ -0,0 +1,195 @@
+require "pathname"
+
+require "vagrant/action/builder"
+
+module VagrantPlugins
+  module HYPERKIT
+    module Action
+      # Include the built-in modules so we can use them as top-level things.
+      include Vagrant::Action::Builtin
+
+      def self.action_package
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            # Connect to AWS and then Create a package from the server instance
+            #b2.use ConnectAWS
+            b2.use PackageInstance
+          end
+        end
+      end
+
+      # This action is called to halt the remote machine.
+      def self.action_halt
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ReadState
+          b.use Call, IsCreated do |env, b2|
+            if env[:result]
+              b2.use Call, GracefulHalt, :stopped, :running do |env2, b3|
+                if !env2[:result]
+                  b3.use StopInstance
+                end
+              end
+            else
+              b2.use MessageNotCreated
+            end
+          end
+        end
+      end
+
+      # This action is called to terminate the remote machine.
+      def self.action_destroy
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use Call, DestroyConfirm do |env, b2|
+            if env[:result]
+              b2.use ConfigValidate
+              b2.use Call, IsCreated do |env2, b3|
+                if !env2[:result]
+                  b3.use MessageNotCreated
+                  next
+                end
+                b3.use TerminateInstance
+                #b3.use ProvisionerCleanup if defined?(ProvisionerCleanup)
+              end
+            else
+              b2.use MessageWillNotDestroy
+            end
+          end
+        end
+      end
+
+      # This action is called when `vagrant provision` is called.
+      def self.action_provision
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use Provision
+          end
+        end
+      end
+
+      # This action is called to read the SSH info of the machine. The
+      # resulting state is expected to be put into the `:machine_ssh_info`
+      # key.
+      def self.action_read_ssh_info
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ReadState
+          b.use ReadSSHInfo
+        end
+      end
+
+      # This action is called to read the state of the machine. The
+      # resulting state is expected to be put into the `:machine_state_id`
+      # key.
+      def self.action_read_state
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use ReadState
+        end
+      end
+
+      # This action is called to SSH into the machine.
+      def self.action_ssh
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use SSHExec
+          end
+        end
+      end
+
+      def self.action_ssh_run
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use SSHRun
+          end
+        end
+      end
+
+      def self.action_prepare_boot
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use Import
+          b.use Provision
+          b.use SyncedFolders
+        end
+      end
+
+      # This action is called to bring the box up from nothing.
+      def self.action_up
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use HandleBox
+          b.use ConfigValidate
+          b.use BoxCheckOutdated
+          b.use Call, IsCreated do |env1, b1|
+            if not env1[:result]
+              b1.use action_prepare_boot
+            end
+
+            b1.use Boot # launch a new instance
+          end
+        end
+      end
+
+      def self.action_reload
+        Vagrant::Action::Builder.new.tap do |b|
+          b.use ConfigValidate
+          b.use Call, IsCreated do |env, b2|
+            if !env[:result]
+              b2.use MessageNotCreated
+              next
+            end
+
+            b2.use action_halt
+            b2.use Call, WaitForState, :stopped, 120 do |env2, b3|
+              if env2[:result]
+                b3.use action_up
+              else
+                # TODO we couldn't reach :stopped, what now?
+              end
+            end
+          end
+        end
+      end
+
+      # The autoload farm
+      action_root = Pathname.new(File.expand_path("../action", __FILE__))
+      autoload :IsCreated, action_root.join("is_created")
+      autoload :IsStopped, action_root.join("is_stopped")
+      autoload :MessageAlreadyCreated, action_root.join("message_already_created")
+      autoload :MessageNotCreated, action_root.join("message_not_created")
+      autoload :MessageWillNotDestroy, action_root.join("message_will_not_destroy")
+      autoload :PackageInstance, action_root.join("package_instance")
+      autoload :ReadSSHInfo, action_root.join("read_ssh_info")
+      autoload :ReadState, action_root.join("read_state")
+      autoload :Import, action_root.join("import")
+      autoload :Boot, action_root.join("boot")
+      autoload :StartInstance, action_root.join("start_instance")
+      autoload :StopInstance, action_root.join("stop_instance")
+      autoload :TerminateInstance, action_root.join("terminate_instance")
+      autoload :TimedProvision, action_root.join("timed_provision") # some plugins now expect this action to exist
+      autoload :WaitForState, action_root.join("wait_for_state")
+    end
+  end
+end