machinery-tool 1.13.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f8e32d15586f31cf49aae783ee024ec80441361d
-  data.tar.gz: b25baa2048d9e5842f21813156e44b67ad833fd6
+  metadata.gz: 8b08cffd58243c0597dfd04d3eda40b7decf833a
+  data.tar.gz: 771159d8c4b48a44fb59d653ed0021af78f5210b
 SHA512:
-  metadata.gz: 113477103631ae51730ea31d2da454aaf867e5c1576a87c41e00941af2704c0ccaedc9ea734366d7ddf9a4814ee98d25592bf5f632d04c8f3d6e398b0b68e4a1
-  data.tar.gz: 1867b37cec854da010e00429704f02b179b5fd3cd32a6baf6e2b69ac0de827d094c74111ba42bb9463c8a151136319e933864419228d26ce30eb4279a0b962bf
+  metadata.gz: 1435204f235b9abbccd1815f16c8dcae31d226b94bbf84f34e642eb8c5c973cfaaf7ba0182eb20d606d253902e27a374477fb2d18df29ac3a33512cd5d0052ba
+  data.tar.gz: 9d2083f79fe8d6c32e65d6234638040c644f82b370285d648f721ebcd0290b912e524f8c94c90d9e56e2fd4a769bcd6a2b4afe89b36fd09585648205c924bbda

data/.git_revision

@@ -0,0 +1 @@
+9787fc1eff835522740423ff35c98b78205b31cb

data/NEWS

@@ -1,6 +1,16 @@
 # Machinery Release Notes
 
 
+## Version 1.14.0 - Tue Oct 06 21:26:12 CEST 2015 - thardeck@suse.de
+
+* The machinery-helper is now built during gem-installation on x86_64
+  machines if Go is available. The RPM package is still shipped with
+  a precompiled version.
+* Allow limiting the `list` command output to certain system descriptions
+  by passing them along as argument (gh#SUSE/machinery#1398)
+* Add `move` command to rename system descriptions (gh#SUSE/machinery#1397)
+* Add inspection of RPM based Docker containers
+
 ## Version 1.13.0 - Tue Sep 15 18:06:00 CEST 2015 - thardeck@suse.de
 
 * Fix: Show `Files extracted` status in `compare --html` when both

data/bin/machinery

@@ -20,9 +20,15 @@
 require_relative '../lib/machinery'
 
 begin
+  if Dir.exist?(File.join(Machinery::ROOT, ".git"))
+    Dir.chdir(File.join(Machinery::ROOT, "machinery-helper")) do
+      Cheetah.run("rake", "build")
+    end
+  end
+
   LocalSystem.validate_machinery_compatibility
   Machinery.initialize_logger(ENV["MACHINERY_LOG_FILE"] || Machinery::DEFAULT_LOG_FILE)
-  command_log = "Executing (Version #{Machinery::VERSION}) '#{$0} #{ARGV.join(" ")}'"
+  command_log = "Executing (Version #{Machinery::VERSION}) '#{$PROGRAM_NAME} #{ARGV.join(" ")}'"
   command_log += " (store: #{ENV["MACHINERY_DIR"]})" if ENV["MACHINERY_DIR"]
   Machinery.logger.info command_log
   Cli.run(ARGV)

data/lib/cli.rb

@@ -43,11 +43,17 @@ class Cli
   post do |global_options,command,options,args|
     if command.is_a?(GLI::Commands::Help) && !global_options[:version] && ARGV == ["help"]
 
+      Machinery::Ui.puts "\nFor more detailed information, open the man page by typing 'man " \
+        "machinery'.\nIf you are unable to find a solution within the man page visit our wiki " \
+        "page\nat https://github.com/SUSE/machinery/wiki"
+
       Machinery::Ui.puts "\nMachinery can show hints which guide through a typical workflow."
       if @config.hints
-        Machinery::Ui.puts "These hints can be switched off by '#{$0} config hints=off'."
+        Machinery::Ui.puts "These hints can be switched off by " \
+          "'#{Hint.program_name} config hints=off'."
       else
-        Machinery::Ui.puts "These hints can be switched on by '#{$0} config hints=on'."
+        Machinery::Ui.puts "These hints can be switched on by " \
+          "'#{Hint.program_name} config hints=on'."
       end
 
       Hint.print(:get_started)
@@ -91,7 +97,7 @@ class Cli
       OptionParser::MissingArgument, OptionParser::AmbiguousOption
       Machinery::Ui.error e.to_s + "\n\n"
       command = ARGV & @commands.keys.map(&:to_s)
-      Machinery::Ui.error "Run '#{$0} #{command.first} --help' for more information."
+      Machinery::Ui.error "Run '#{Hint.program_name} #{command.first} --help' for more information."
       exit 1
     when Machinery::Errors::MachineryError
       Machinery.logger.error(e.message)
@@ -398,6 +404,23 @@ class Cli
     end
   end
 
+  desc "Move system description"
+  long_desc <<-LONGDESC
+    Move a system description.
+
+    The system description name is changed to the provided name.
+  LONGDESC
+  arg "FROM_NAME"
+  arg "TO_NAME"
+  command "move" do |c|
+    c.action do |_global_options, _options, args|
+      from = shift_arg(args, "FROM_NAME")
+      to = shift_arg(args, "TO_NAME")
+      task = MoveTask.new
+      task.move(system_description_store, from, to)
+    end
+  end
+
 
   desc "Deploy image to OpenStack cloud"
   long_desc <<-LONGDESC
@@ -487,18 +510,7 @@ class Cli
     end
   end
 
-  desc "Inspect running system"
-  long_desc <<-LONGDESC
-    Inspect running system and generate system descripton from inspected data.
-
-    Multiple scopes can be passed as comma-separated list. If no specific scopes
-    are given, all scopes are inspected.
-
-    Available scopes: #{AVAILABLE_SCOPE_LIST}
-  LONGDESC
-  arg "HOSTNAME"
-  command "inspect" do |c|
-    supports_filtering(c)
+  def self.define_inspect_command_options(c)
     c.flag [:name, :n], type: String, required: false, arg_name: "NAME",
       desc: "Store system description under the specified name"
     c.flag [:scope, :s], type: String, required: false,
@@ -523,49 +535,71 @@ class Cli
       desc: "Print inspection result"
     c.switch :verbose, required: false, negatable: false,
       desc: "Display the filters which are used during inspection"
+  end
 
-    c.action do |global_options,options,args|
-      host = shift_arg(args, "HOSTNAME")
-      inspector_task = InspectTask.new
-      scope_list = process_scope_option(options[:scope], options["exclude-scope"])
-      name = options[:name] || host
+  def self.parse_inspect_command_options(host, options)
+    scope_list = process_scope_option(options[:scope], options["exclude-scope"])
+    name = options[:name] || host
 
 
-      if !scope_list.empty?
-        inspected_scopes = " for #{Machinery::Ui.internal_scope_list_to_string(scope_list)}"
-      end
-      Machinery::Ui.puts "Inspecting #{host}#{inspected_scopes}..."
+    if !scope_list.empty?
+      inspected_scopes = " for #{Machinery::Ui.internal_scope_list_to_string(scope_list)}"
+    end
+    Machinery::Ui.puts "Inspecting #{host}#{inspected_scopes}..."
 
-      inspect_options = {}
-      if options["show"]
-        inspect_options[:show] = true
-      end
-      if options["verbose"]
-        inspect_options[:verbose] = true
-      end
-      if options["extract-files"] || options["extract-changed-config-files"]
-        inspect_options[:extract_changed_config_files] = true
-      end
-      if options["extract-files"] || options["extract-changed-managed-files"]
-        inspect_options[:extract_changed_managed_files] = true
-      end
-      if options["extract-files"] || options["extract-unmanaged-files"]
-        inspect_options[:extract_unmanaged_files] = true
-      end
-      inspect_options[:remote_user] = options["remote-user"]
+    inspect_options = {}
+    if options["show"]
+      inspect_options[:show] = true
+    end
+    if options["verbose"]
+      inspect_options[:verbose] = true
+    end
+    if options["extract-files"] || options["extract-changed-config-files"]
+      inspect_options[:extract_changed_config_files] = true
+    end
+    if options["extract-files"] || options["extract-changed-managed-files"]
+      inspect_options[:extract_changed_managed_files] = true
+    end
+    if options["extract-files"] || options["extract-unmanaged-files"]
+      inspect_options[:extract_unmanaged_files] = true
+    end
 
-      filter = FilterOptionParser.parse("inspect", options)
+    filter = FilterOptionParser.parse("inspect", options)
 
-      if options["verbose"] && !filter.empty?
-        Machinery::Ui.puts "\nThe following filters are applied during inspection:"
-        Machinery::Ui.puts filter.to_array.join("\n") + "\n\n"
-      else
-        show_filter_note(scope_list, filter)
-      end
+    if options["verbose"] && !filter.empty?
+      Machinery::Ui.puts "\nThe following filters are applied during inspection:"
+      Machinery::Ui.puts filter.to_array.join("\n") + "\n\n"
+    else
+      show_filter_note(scope_list, filter)
+    end
+
+    [name, scope_list, inspect_options, filter]
+  end
+
+  desc "Inspect running system"
+  long_desc <<-LONGDESC
+    Inspect running system and generate system descripton from inspected data.
+
+    Multiple scopes can be passed as comma-separated list. If no specific scopes
+    are given, all scopes are inspected.
+
+    Available scopes: #{AVAILABLE_SCOPE_LIST}
+  LONGDESC
+  arg "HOSTNAME"
+  command "inspect" do |c|
+    supports_filtering(c)
+    define_inspect_command_options(c)
+
+    c.action do |_global_options, options, args|
+      host = shift_arg(args, "HOSTNAME")
+      system = System.for(host, options["remote-user"])
+      inspector_task = InspectTask.new
+
+      name, scope_list, inspect_options, filter = parse_inspect_command_options(host, options)
 
       inspector_task.inspect_system(
         system_description_store,
-        host,
+        system,
         name,
         CurrentUser.new,
         scope_list,
@@ -581,15 +615,64 @@ class Cli
     end
   end
 
+  desc "Inspect container image"
+  long_desc <<-LONGDESC
+    Inspect container image and generate system descripton from inspected data.
+
+    Multiple scopes can be passed as comma-separated list. If no specific scopes
+    are given, all scopes are inspected.
+
+    Available scopes: #{AVAILABLE_SCOPE_LIST}
+  LONGDESC
+  arg "IMAGENAME"
+  command "inspect-container" do |c|
+    supports_filtering(c)
+    define_inspect_command_options(c)
+    c.switch ["docker", :d], required: true, negatable: false,
+      desc: "Inspect a docker container"
+
+    c.action do |_global_options, options, args|
+      image = shift_arg(args, "IMAGENAME")
+      system = DockerSystem.new(image)
+      inspector_task = InspectTask.new
+
+      name, scope_list, inspect_options, filter = parse_inspect_command_options(image, options)
+
+      begin
+        system.start
+        inspector_task.inspect_system(
+          system_description_store,
+          system,
+          name,
+          CurrentUser.new,
+          scope_list,
+          filter,
+          inspect_options
+        )
+      ensure
+        system.stop
+      end
 
 
+      Hint.print(:show_data, name: name)
+
+      if !options["extract-files"] || Inspector.all_scopes.count != scope_list.count
+        Hint.print(:do_complete_inspection, name: name, docker_container: image)
+      end
+    end
+  end
+
   desc "List system descriptions"
   long_desc <<-LONGDESC
-    List system descriptions and their stored scopes.
+    List all system descriptions and their stored scopes, when no NAME parameter is specified.
+
+    List only the specified system descriptions and its stored scopes, when NAME parameter is given.
 
     The date of modification for each scope can be shown with the verbose
     option.
   LONGDESC
+  arg "NAME", [:multiple, :optional]
+
   command "list" do |c|
     c.switch :verbose, required: false, negatable: false,
       desc: "Display additional information about origin of scopes"
@@ -598,7 +681,7 @@ class Cli
 
     c.action do |global_options,options,args|
       task = ListTask.new
-      task.list(system_description_store, options)
+      task.list(system_description_store, args, options)
     end
   end
 
@@ -787,7 +870,8 @@ class Cli
       task.config(key, value)
 
       if key == "hints" && (value == "false" || value == "off")
-        Machinery::Ui.puts "Hints can be switched on again by '#{$0} config hints=on'."
+        Machinery::Ui.puts "Hints can be switched on again by " \
+          "'#{Hint.program_name} config hints=on'."
       end
     end
   end

data/lib/compare_task.rb

@@ -27,7 +27,7 @@ class CompareTask
   end
 
   def render_html_comparison(description1, description2, scopes, options)
-    LocalSystem.validate_existence_of_package("xdg-utils")
+    LocalSystem.validate_existence_of_command("xdg-open", "xdg-utils")
 
     url = "http://#{options[:ip]}:#{options[:port]}/compare/" \
       "#{CGI.escape(description1.name)}/#{CGI.escape(description2.name)}"

data/lib/constants.rb

@@ -21,5 +21,5 @@ module Machinery
   DEFAULT_LOG_FILE = File.join(DEFAULT_CONFIG_DIR, "machinery.log")
   DEFAULT_CONFIG_FILE = File.join(DEFAULT_CONFIG_DIR, "machinery.config")
   IMAGE_META_DATA_FILE = "machinery.meta"
-  REMOTE_HELPERS_PATH = "/root"
+  HELPER_REMOTE_PATH = "/root"
 end

data/lib/docker_system.rb

@@ -0,0 +1,135 @@
+# Copyright (c) 2013-2015 SUSE LLC
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of version 3 of the GNU General Public License as
+# published by the Free Software Foundation.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.   See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, contact SUSE LLC.
+#
+# To contact SUSE about this file by physical or electronic mail,
+# you may find current contact information at www.suse.com
+
+class DockerSystem < System
+  attr_accessor :image
+
+  def type
+    "docker"
+  end
+
+  def initialize(image)
+    @image = image
+
+    validate_image_name(image)
+  end
+
+  def start
+    @container = LoggedCheetah.run("docker", "run", "-id", @image, "bash", stdout: :capture).chomp
+  rescue Cheetah::ExecutionFailed => e
+    raise Machinery::Errors::MachineryError, "Container could not be started." \
+      " The error message was:\n" + e.stderr
+  end
+
+  def stop
+    LoggedCheetah.run("docker", "rm", "-f", @container) if @container
+  end
+
+  def run_command(*args)
+    Machinery.logger.info("Running '#{args}'")
+    LoggedCheetah.run("docker", "exec", "--user=root", "-i", @container, *args)
+  end
+
+  def check_retrieve_files_dependencies
+    # Files are retrieved using the `docker cp` command, so there are no additional dependencies
+  end
+
+  def check_create_archive_dependencies
+    # Archives are created using the machinery-helper binary, so there are no additional
+    # dependencies
+  end
+
+  # Reads a file from the System. Returns nil if it does not exist.
+  def read_file(file)
+    run_command("cat", file, stdout: :capture)
+  rescue Cheetah::ExecutionFailed => e
+    if e.status.exitstatus == 1
+      # File not found, return nil
+      return
+    else
+      raise
+    end
+  end
+
+  # Removes a file from the System
+  def remove_file(file)
+    run_command("rm", file)
+  rescue => e
+    raise Machinery::Errors::RemoveFileFailed.new(
+      "Could not remove file '#{file}'.\nError: #{e}"
+    )
+  end
+
+  # Copies a file to the system
+  def inject_file(source, destination)
+    LoggedCheetah.run("docker", "cp", source, "#{@container}:#{destination}")
+  end
+
+  # Retrieves files specified in file_list from the container
+  def retrieve_files(file_list, destination)
+    file_list.each do |file|
+      destination_path = File.join(destination, file)
+      FileUtils.mkdir_p(File.dirname(destination_path), mode: 0700)
+
+      LoggedCheetah.run("docker", "cp", "#{@container}:#{file}", "#{destination_path}")
+      LoggedCheetah.run("chmod", "go-rwx", destination_path)
+    end
+  end
+
+  # Retrieves files specified in file_list from the container and creates an archive.
+  def create_archive(file_list, archive, exclude = [])
+    created = !File.exists?(archive)
+    out = File.open(archive, "w")
+    begin
+      run_command(
+        File.join(
+          Machinery::HELPER_REMOTE_PATH, "machinery-helper"
+        ), "tar", "--create", "--gzip", "--null", "--files-from=-",
+        *exclude.flat_map { |f| ["--exclude", f] },
+        stdout: out,
+        stdin: Array(file_list).join("\0"),
+        stderr: STDERR
+      )
+    rescue Cheetah::ExecutionFailed => e
+      if e.status.exitstatus == 1
+        # The tarball has been created successfully but some files were changed
+        # on disk while being archived, so we just log the warning and go on
+        Machinery.logger.info e.stderr
+      else
+        raise
+      end
+    end
+    out.close
+    File.chmod(0600, archive) if created
+  end
+
+  def requires_root?
+    false
+  end
+
+  private
+
+  def validate_image_name(image)
+    images = LoggedCheetah.run("docker", "images", stdout: :capture).split("\n")
+
+    if !images.find { |i| i.start_with?("#{image} ") || i.index(" #{image} ") }
+      raise Machinery::Errors::InspectionFailed.new(
+        "Unknown docker image: '#{image}'"
+      )
+    end
+  end
+end

data/lib/exceptions.rb

@@ -48,7 +48,7 @@ module Machinery
       def to_s
         "The system description '#{@name}' has an incompatible data " \
         "format and can not be read.\n" \
-        "Try '#{$0} upgrade-format #{name}' to upgrade it to the current version.\n"
+        "Try '#{Hint.program_name} upgrade-format #{name}' to upgrade it to the current version.\n"
       end
     end
 
@@ -65,7 +65,7 @@ module Machinery
         end.compact.first || "<HOSTNAME>"
         formatted_scopes = Machinery::Ui.internal_scope_list_to_string(@scopes)
 
-        cmd = "#{$0} inspect --extract-files --scope=#{formatted_scopes.delete(" ")}"
+        cmd = "#{Hint.program_name} inspect --extract-files --scope=#{formatted_scopes.delete(" ")}"
         cmd += " --name='#{@description.name}'" if hostname != @description.name
         cmd += " #{hostname}"
 
@@ -139,5 +139,6 @@ module Machinery
     class InjectFileFailed < MachineryError; end
     class UnexpectedInputData < MachineryError; end
     class ComposeServiceLink < MachineryError; end
+    class UnsupportedHelperVersion < MachineryError; end
   end
 end

data/lib/filter.rb

@@ -72,7 +72,7 @@ class Filter
   def self.from_default_definition(command)
     filter = Filter.new
 
-    default_filters_file = File.join(Machinery::ROOT, "helpers/default_filters.json")
+    default_filters_file = File.join(Machinery::ROOT, "filters", "default_filters.json")
     if File.exists?(default_filters_file)
       default_filters = JSON.parse(File.read(default_filters_file))
       if default_filters[command]

data/lib/hint.rb

@@ -62,8 +62,14 @@ class Hint
     end
 
     def do_complete_inspection(options)
-      "To do a full inspection containing all scopes and to extract files run:\n" \
-       "#{program_name} inspect #{options[:host]} --name #{options[:name]} --extract-files"
+      if options[:host]
+        "To do a full inspection containing all scopes and to extract files run:\n" \
+         "#{program_name} inspect #{options[:host]} --name #{options[:name]} --extract-files"
+      elsif options[:docker_container]
+        "To do a full inspection containing all scopes and to extract files run:\n" \
+         "#{program_name} inspect-container --docker #{options[:docker_container]} " \
+         "--name #{options[:name]} --extract-files"
+      end
     end
 
     def upgrade_system_description(_options)

data/lib/inspect_task.rb

@@ -14,10 +14,8 @@
 #
 # To contact SUSE about this file by physical or electronic mail,
 # you may find current contact information at www.suse.com
-
 class InspectTask
-  def inspect_system(store, host, name, current_user, scopes, filter, options = {})
-    system = System.for(host, options[:remote_user])
+  def inspect_system(store, system, name, current_user, scopes, filter, options = {})
     check_root(system, current_user)
 
     description, failed_inspections = build_description(store, name, system,
@@ -67,6 +65,8 @@ class InspectTask
     timestring = Time.now.utc.iso8601
     if system.class == LocalSystem
       host = "localhost"
+    elsif system.class == DockerSystem
+      host = system.image
     else
       host = system.host
     end

data/lib/kiwi_config.rb

@@ -234,8 +234,8 @@ EOF
   end
 
   def apply_packages(xml)
-    build_filter = YAML.load_file(File.join(
-      Machinery::ROOT, "helpers", "filter-packages-for-build.yaml")
+    build_filter = YAML.load_file(
+      File.join(Machinery::ROOT, "filters", "filter-packages-for-build.yaml")
     )
     filter = build_filter[@system_description.os.canonical_name] || []
 

data/lib/list_task.rb

@@ -16,13 +16,17 @@
 # you may find current contact information at www.suse.com
 
 class ListTask
-  def list(store, options = {})
-    descriptions = store.list
+  def list(store, system_descriptions, options = {})
+    if system_descriptions.empty?
+      descriptions = store.list
+    else
+      descriptions = system_descriptions.sort
+    end
     has_incompatible_version = false
 
     descriptions.each do |name|
       begin
-        description = SystemDescription.load(name, store, skip_validation: true)
+        system_description = SystemDescription.load(name, store, skip_validation: true)
       rescue Machinery::Errors::SystemDescriptionIncompatible => e
         if !e.format_version
           show_error("#{name}: incompatible format version. Can not be upgraded.\n", options)
@@ -35,9 +39,12 @@ class ListTask
             "Please upgrade Machinery to the latest version.", options)
         end
         next
+      rescue Machinery::Errors::SystemDescriptionNotFound
+        show_error("#{name}: Couldn't find a system description with the name '#{name}'.", options)
+        next
       rescue Machinery::Errors::SystemDescriptionValidationFailed
         show_error("#{name}: This description is broken. Use " \
-          "`#{$0} validate #{name}` to see the error message.", options)
+          "`#{Hint.program_name} validate #{name}` to see the error message.", options)
         next
       rescue Machinery::Errors::SystemDescriptionError
         show_error("#{name}: This description is broken.", options)
@@ -49,10 +56,10 @@ class ListTask
       else
         scopes = []
 
-        description.scopes.each do |scope|
+        system_description.scopes.each do |scope|
           entry = Machinery::Ui.internal_scope_list_to_string(scope)
           if SystemDescription::EXTRACTABLE_SCOPES.include?(scope)
-            if description.scope_extracted?(scope)
+            if system_description.scope_extracted?(scope)
               entry += " (extracted)"
             else
               entry += " (not extracted)"
@@ -60,7 +67,7 @@ class ListTask
           end
 
           if options[:verbose]
-            meta = description[scope].meta
+            meta = system_description[scope].meta
             if meta
               time = Time.parse(meta.modified).getlocal
               date = time.strftime "%Y-%m-%d %H:%M:%S"

data/lib/local_system.rb

@@ -67,6 +67,16 @@ You can install it by running `zypper install #{missing_packages.join(" ")}`.
       end
     end
 
+    def validate_existence_of_command(command, package)
+      Cheetah.run("which", command)
+    rescue Cheetah::ExecutionFailed
+      output = <<-EOF
+You need the command '#{command}' from package '#{package}'.
+You can install it by running `zypper install #{package}`.
+      EOF
+      raise(Machinery::Errors::MissingRequirement.new(output))
+    end
+
     def validate_machinery_compatibility
       return if !Machinery::Config.new.perform_support_check || os.can_run_machinery?
 
@@ -86,7 +96,7 @@ EOF
       if !os.can_build?(system_description.os)
         message = "Building '#{system_description.os.display_name}' is " \
           "not supported on this distribution.\n" \
-          "Check the 'BUILD SUPPORT MATRIX' by running `#{$0} build --help` for " \
+          "Check the 'BUILD SUPPORT MATRIX' by running `#{Hint.program_name} build --help` for " \
           "further information which build targets are supported.\n" \
           "You are only able to build the architecture you are running " \
           "(#{LocalSystem.os.architecture})."
@@ -95,8 +105,12 @@ EOF
       end
     end
 
+    def matches_architecture?(arch)
+      os.architecture == arch
+    end
+
     def validate_architecture(arch)
-      if os.architecture != arch
+      if !matches_architecture?(arch)
         raise(Machinery::Errors::UnsupportedArchitecture.new(
           "This operation is not supported on architecture '#{os.architecture}'."
         ))
@@ -104,6 +118,10 @@ EOF
     end
   end
 
+  def type
+    "local"
+  end
+
   def requires_root?
     true
   end