66 lines
2.3 KiB
Ruby
66 lines
2.3 KiB
Ruby
module Vagrant
|
|
# Represents a "box," which is simply a packaged vagrant environment.
|
|
# Boxes are simply `tar` files which contain an exported VirtualBox
|
|
# virtual machine, at the least. They are created with `vagrant package`
|
|
# and may contain additional files if specified by the creator. This
|
|
# class serves to help manage these boxes, although most of the logic
|
|
# is kicked out to middlewares.
|
|
class Box
|
|
# The name of the box.
|
|
attr_accessor :name
|
|
|
|
# The URI for a new box. This is not available for existing boxes.
|
|
attr_accessor :uri
|
|
|
|
# The directory where this box is stored
|
|
attr_reader :directory
|
|
|
|
# Creates a new box instance. Given an optional `name` parameter,
|
|
# newly created instance will have that name, otherwise it defaults
|
|
# to `nil`.
|
|
#
|
|
# **Note:** This method does not actually _create_ the box, but merely
|
|
# returns a new, abstract representation of it. To add a box, see {#add}.
|
|
def initialize(name, directory)
|
|
@name = name
|
|
@directory = directory
|
|
end
|
|
|
|
# Returns path to the OVF file of the box. The OVF file is an open
|
|
# virtual machine file which contains specifications of the exported
|
|
# virtual machine this box contains.
|
|
#
|
|
# This will only be valid once the box is imported.
|
|
#
|
|
# @return [String]
|
|
def ovf_file
|
|
directory.join(env.config.vm.box_ovf)
|
|
end
|
|
|
|
# Begins the process of adding a box to the vagrant installation. This
|
|
# method requires that `name` and `uri` be set. The logic of this method
|
|
# is kicked out to the `box_add` registered middleware.
|
|
def add
|
|
raise Errors::BoxAlreadyExists, :name => name if File.directory?(directory)
|
|
env.actions.run(:box_add, { "box" => self, "validate" => false })
|
|
end
|
|
|
|
# Begins the process of destroying this box. This cannot be undone!
|
|
def destroy
|
|
env.actions.run(:box_remove, { "box" => self, "validate" => false })
|
|
end
|
|
|
|
# Begins sequence to repackage this box.
|
|
def repackage(options=nil)
|
|
env.actions.run(:box_repackage, { "box" => self, "validate" => false }.merge(options || {}))
|
|
end
|
|
|
|
# Implemented for comparison with other boxes. Comparison is implemented
|
|
# by simply comparing name.
|
|
def <=>(other)
|
|
return super if !other.is_a?(self.class)
|
|
name <=> other.name
|
|
end
|
|
end
|
|
end
|