mtncloud-cli 1.0.0

data/lib/mtncloud/cli/commands/security_package_types.rb

@@ -0,0 +1,32 @@
+require 'mtncloud/cli/cli_command'
+
+class MtnCloud::Cli::SecurityPackageTypesCommand
+  include MtnCloud::Cli::CliCommand
+  include MtnCloud::Cli::RestCommand
+
+  set_command_description "View security_package types"
+  set_command_name :'security-package-types'
+  register_subcommands :list, :get
+
+  # register_interfaces :security_package_types
+
+  protected
+
+  def security_package_type_list_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Code" => 'code',
+    }
+  end
+
+  def security_package_type_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Code" => 'code',
+    }
+  end
+
+end
+

data/lib/mtncloud/cli/commands/security_packages.rb

@@ -0,0 +1,84 @@
+require 'mtncloud/cli/cli_command'
+
+class MtnCloud::Cli::SecurityPackagesCommand
+  include MtnCloud::Cli::CliCommand
+  include MtnCloud::Cli::RestCommand
+
+  set_command_name :'security-packages'
+  set_command_description "View and manage security packages."
+  register_subcommands :list, :get, :add, :update, :remove
+
+  # RestCommand settings
+  register_interfaces :security_packages, :security_package_types
+  set_rest_has_type true
+  # set_rest_type :security_package_types
+
+  protected
+
+  def build_list_options(opts, options, params)
+    opts.on('-l', '--labels LABEL', String, "Filter by labels, can match any of the values") do |val|
+      add_query_parameter(params, 'labels', parse_labels(val))
+    end
+    opts.on('--all-labels LABEL', String, "Filter by labels, must match all of the values") do |val|
+      add_query_parameter(params, 'allLabels', parse_labels(val))
+    end
+    # build_standard_list_options(opts, options)
+    super
+  end
+
+  def security_package_list_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Labels" => lambda {|it| format_list(it['labels'], '', 3) rescue '' },
+      "Type" => lambda {|it| it['type'] ? it['type']['name'] : '' },
+      "Description" => 'description',
+    }
+  end
+
+  def security_package_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Labels" => lambda {|it| format_list(it['labels'], '', 3) rescue '' },
+      "Type" => lambda {|it| it['type'] ? it['type']['name'] : '' },
+      "Description" => 'description',
+      "Enabled" => lambda {|it| format_boolean(it['enabled']) },
+      # "Source" => 'sourceType',
+      "URL" => 'url',
+      "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+      "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+    }
+  end
+
+  def add_security_package_option_types()
+    [
+      {'shorthand' => '-t', 'fieldName' => 'type', 'fieldLabel' => 'Security Package Type', 'type' => 'select', 'optionSource' => lambda {|api_client, api_params| 
+        api_client.security_package_types.list({max:10000})['securityPackageTypes'].collect { |it| {"name" => it["name"], "value" => it["code"]} }
+      }, 'required' => true, 'defaultValue' => 'SCAP Package'},      
+      {'fieldName' => 'name', 'fieldLabel' => 'Name', 'type' => 'text', 'required' => true},
+      {'shorthand' => '-l', 'optionalValue' => true, 'fieldName' => 'labels', 'fieldLabel' => 'Labels', 'type' => 'text', 'required' => false, 'noPrompt' => true, 'processValue' => lambda {|val| parse_labels(val) }},
+      {'fieldName' => 'description', 'fieldLabel' => 'Description', 'type' => 'text', 'required' => false},
+      {'fieldName' => 'enabled', 'fieldLabel' => 'Enabled', 'type' => 'checkbox', 'required' => false, 'defaultValue' => true},
+      # {'code' => 'securityPackage.sourceType', 'fieldName' => 'sourceType', 'fieldLabel' => 'Source', 'type' => 'select', 'selectOptions' => [{'name'=>'url','value'=>'url'}], 'defaultValue' => 'url', 'required' => true},
+      # {'code' => 'securityPackage.sourceType', 'fieldContext' => 'file', 'fieldName' => 'sourceType', 'fieldLabel' => 'Source', 'type' => 'hidden', 'defaultValue' => 'url', 'required' => true},
+      {'fieldName' => 'url', 'fieldLabel' => 'URL', 'type' => 'text', 'required' => true, 'description' => "URL to download the security package zip file from"},
+      # {'fieldName' => 'file', 'fieldLabel' => 'File Content', 'type' => 'file-content', 'required' => true},
+    ]
+  end
+
+  def add_security_package_advanced_option_types()
+    []
+  end
+
+  def update_security_package_option_types()
+    option_types = add_security_package_option_types.collect {|it| it.delete('required'); it.delete('defaultValue'); it.delete('dependsOnCode'); it }
+    option_types.reject! {|it| it['fieldName'] == 'type' }
+    option_types
+  end
+
+  def update_security_package_advanced_option_types()
+    add_security_package_advanced_option_types().collect {|it| it.delete('required'); it.delete('defaultValue'); it.delete('dependsOnCode'); it }
+  end
+
+end

data/lib/mtncloud/cli/commands/security_scans.rb

@@ -0,0 +1,107 @@
+require 'mtncloud/cli/cli_command'
+
+class MtnCloud::Cli::SecurityScansCommand
+  include MtnCloud::Cli::CliCommand
+  include MtnCloud::Cli::RestCommand
+
+  set_command_name :'security-scans'
+  set_command_description "View and manage security scans."
+  register_subcommands :list, :get, :remove
+
+  # RestCommand settings
+  register_interfaces :security_scans, 
+                      :security_packages, :servers
+
+  # display argument as [id] since name is not supported
+  set_rest_has_name false
+  set_rest_arg "id"
+
+  protected
+
+  def build_list_options(opts, options, params)
+    opts.on('--security-package PACKAGE', String, "Filter by security package name or id") do |val|
+      options[:security_package] ||= []
+      options[:security_package] << val
+    end
+    opts.on('--server SERVER', String, "Filter by server name or id") do |val|
+      options[:server] ||= []
+      options[:server] << val
+    end
+    opts.on('--results', "Include the results object in the response under each security scan. This is a potentially very large object containing the raw results of the scan. Use with --json to see this data.") do
+      params['results'] = true
+    end
+    super
+  end
+
+  def parse_list_options!(args, options, params)
+    # parse --security-package
+    # todo: one liner with find_by_name_or_id!
+    if options[:security_package]
+      params['securityPackageId'] = options[:security_package].collect do |val|
+        record = find_by_name_or_id(:security_package, val)
+        if record.nil?
+          exit 1 #return 1, "Security Package not found by '#{val}'"
+        else 
+          record['id']
+        end
+      end
+    end
+    # parse --server
+    if options[:server]
+      params['serverId'] = options[:server].collect do |val|
+        record = find_by_name_or_id(:server, val)
+        if record.nil?
+          exit 1 # return 1, "Server not found by '#{val}'"
+        else
+          record['id']
+        end
+      end
+    end
+    super
+  end
+
+  def build_get_options(opts, options, params)
+    opts.on('--results', "Include the results object in the response under the security scan. This is a potentially very large object containing the raw results of the scan. Use with --json to see this data.") do
+      params['results'] = true
+    end
+    super
+  end
+
+  def security_scan_list_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Security Package" => lambda {|it| it['securityPackage']['name'] rescue '' },
+      "Type" => lambda {|it| it['securityPackage']['type']['name'] rescue '' },
+      "Server" => lambda {|it| it['server']['name'] rescue '' },
+      "Scan Date" => lambda {|it| format_local_dt(it['scanDate']) },
+      "Status" => lambda {|it| it['status'] },
+      "Score" => lambda {|it| it['scanScore'] },
+      "Results" => lambda {|it| format_security_scan_results_summary(it) },
+
+    }
+  end
+
+  def security_scan_column_definitions(options)
+    {
+      "ID" => 'id',
+      "Security Package" => lambda {|it| it['securityPackage']['name'] rescue '' },
+      "Type" => lambda {|it| it['securityPackage']['type']['name'] rescue '' },
+      "Server" => lambda {|it| it['server']['name'] rescue '' },
+      "Scan Date" => lambda {|it| format_local_dt(it['scanDate']) },
+      "Status" => lambda {|it| it['status'] },
+      "Score" => lambda {|it| it['scanScore'] },
+      "Results" => lambda {|it| format_security_scan_results_summary(it) },
+      "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+      "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+    }
+  end
+
+  def format_security_scan_results_summary(security_scan)
+    totals = []
+    totals << "Run: #{security_scan['runCount']}" # if security_scan['runCount'].to_i > 0
+    totals << "Pass: #{security_scan['passCount']}" if security_scan['passCount'].to_i > 0
+    totals << "Fail: #{security_scan['failCount']}" if security_scan['failCount'].to_i > 0
+    totals << "Warn: #{security_scan['runCount']}" if security_scan['otherCount'].to_i > 0
+    totals.join(", ")
+  end
+end

data/lib/mtncloud/cli/commands/self_service_command.rb

@@ -0,0 +1,17 @@
+require 'mtncloud/cli/cli_command'
+require 'mtncloud/cli/commands/catalog_item_types_command'
+
+class MtnCloud::Cli::SelfServiceCommand
+  include MtnCloud::Cli::CliCommand
+
+  set_command_name :'self-service'
+  set_command_description "Deprecated and replaced by catalog-item-types"
+
+  set_command_hidden
+  
+  def handle(args)
+  	print_error yellow,"[DEPRECATED] The command `self-service` is deprecated and replaced by `catalog-item-types`.",reset,"\n"
+  	MtnCloud::Cli::CatalogItemTypesCommand.new.handle(args)
+  end
+
+end

data/lib/mtncloud/cli/commands/server_devices_command.rb

@@ -0,0 +1,207 @@
+require 'mtncloud/cli/cli_command'
+
+class MtnCloud::Cli::ServerDevicesCommand
+  include MtnCloud::Cli::CliCommand
+  include MtnCloud::Cli::ProvisioningHelper
+  # include MtnCloud::Cli::OptionSourceHelper
+
+  set_command_hidden # hide and prefer `hosts list-devices, get-device, assign-device. for now
+
+  set_command_name :'host-devices'
+
+  register_subcommands :list, :assign, :attach, :detach
+
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @servers_interface = @api_client.servers
+    @server_devices_interface = @api_client.server_devices
+  end
+
+  def handle(args)
+    handle_subcommand(args)
+  end  
+
+  def list(args)
+    options = {}
+    params = {}
+    ref_ids = []
+    optparse = MtnCloud::Cli::OptionParser.new do |opts|
+      opts.banner = "Usage: #{prog_name} hosts [host] list-devices"
+      build_standard_list_options(opts, options)
+      opts.footer = <<-EOT
+List host devices.
+[host] is required. This is the id of the host.
+EOT
+    end
+    optparse.parse!(args)
+    connect(options)
+    verify_args!(args:args, optparse:optparse, count:1)
+    server_id = args[0] =~ /\A\d{1,}\Z/ ? args[0].to_i : find_server_by_name(args[0])['id']
+    @server_devices_interface.setopts(options)
+    if options[:dry_run]
+      print_dry_run @server_devices_interface.dry.list(server_id, params)
+      return
+    end
+    json_response = @server_devices_interface.list(server_id, params)
+    render_response(json_response, options, 'devices') do
+      server_devices = json_response['devices']
+      print_h1 "Host Devices: #{server_id}", parse_list_subtitles(options), options
+      if server_devices.empty?
+        print cyan,"No host devices found.",reset,"\n"
+      else
+        print as_pretty_table(server_devices, server_device_list_column_definitions.upcase_keys!, options)
+        print_results_pagination(json_response)
+      end
+      print reset,"\n"
+    end
+  end
+  
+
+  def assign(args)
+    options = {}
+    params = {}
+    optparse = MtnCloud::Cli::OptionParser.new do |opts|
+      opts.banner = "Usage: #{prog_name} hosts assign [host] [device] [target]"
+      build_standard_update_options(opts, options)
+      opts.footer = <<-EOT
+Assign a host device to a target server.
+[host] is required. This is the id of the host.
+[device] is required. This is the id of the device.
+[target] is required. This is the id of the target server.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:1, max:3)
+    connect(options)
+    server_id = args[0] =~ /\A\d{1,}\Z/ ? args[0].to_i : find_server_by_name(args[0])['id']
+    device_id = args[1] ? args[1].to_i : nil
+    if device_id.nil?
+      avail_devices = @server_devices_interface.list(server_id)['devices'].collect {|it| {'name' => it['name'], 'value' => it['id']}}
+      device_id = MtnCloud::Cli::OptionTypes.prompt([{'fieldName' => 'deviceId', 'fieldLabel' => 'Device', 'type' => 'select', 'selectOptions' => avail_devices, 'required' => true}], options[:options], @api_client)['deviceId']        
+    end
+    target_server_id = args[2] ? args[2].to_i : nil
+    parse_payload(options) do |payload|
+      if target_server_id.nil?
+        # avail_servers = @servers_interface.list({max:10000, 'parentId' => server_id})['servers'].collect {|it| {'name' => it['name'], 'value' => it['id']}}
+        # target_server_id = MtnCloud::Cli::OptionTypes.prompt([{'fieldName' => 'targetServerId', 'fieldLabel' => 'Target Server', 'type' => 'select', 'selectOptions' => avail_servers, 'required' => true}], options[:options], @api_client)['targetServerId']
+        target_server_id = MtnCloud::Cli::OptionTypes.prompt([{'fieldName' => 'targetServerId', 'fieldLabel' => 'Target Server', 'type' => 'select', 'optionSource' => 'hostVms', 'required' => true}], options[:options], @api_client, {'parentId' => server_id})['targetServerId']
+      end
+      payload['targetServerId'] = target_server_id
+    end
+    execute_api(@server_devices_interface, :assign, [server_id, device_id], options) do |json_response|
+      print_green_success "Assigned host device to target server"
+    end
+  end
+
+  def attach(args)
+    options = {}
+    params = {}
+    optparse = MtnCloud::Cli::OptionParser.new do |opts|
+      opts.banner = "Usage: #{prog_name} hosts attach [host] [device]"
+      build_standard_update_options(opts, options)
+      opts.footer = <<-EOT
+Attach a host device.
+[host] is required. This is the id of the host.
+[device] is required. This is the id of the device.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:1, max:3)
+    connect(options)
+    server_id = args[0] =~ /\A\d{1,}\Z/ ? args[0].to_i : find_server_by_name(args[0])['id']
+    device_id = args[1] ? args[1].to_i : nil
+    if device_id.nil?
+      avail_devices = @server_devices_interface.list(server_id)['devices'].collect {|it| {'name' => it['name'], 'value' => it['id']}}
+      device_id = MtnCloud::Cli::OptionTypes.prompt([{'fieldName' => 'deviceId', 'fieldLabel' => 'Device', 'type' => 'select', 'selectOptions' => avail_devices, 'required' => true}], options[:options], @api_client)['deviceId']        
+    end
+    parse_payload(options) do |payload|
+      
+    end
+    execute_api(@server_devices_interface, :attach, [server_id, device_id], options) do |json_response|
+      print_green_success "Attached host device"
+    end
+  end
+
+  def detach(args)
+    options = {}
+    params = {}
+    optparse = MtnCloud::Cli::OptionParser.new do |opts|
+      opts.banner = "Usage: #{prog_name} hosts detach [host] [device]"
+      build_standard_update_options(opts, options)
+      opts.footer = <<-EOT
+Detach a host device.
+[host] is required. This is the id of the host.
+[device] is required. This is the id of the device.
+EOT
+    end
+    optparse.parse!(args)
+    verify_args!(args:args, optparse:optparse, min:1, max:3)
+    connect(options)
+    server_id = args[0] =~ /\A\d{1,}\Z/ ? args[0].to_i : find_server_by_name(args[0])['id']
+    device_id = args[1] ? args[1].to_i : nil
+    if device_id.nil?
+      avail_devices = @server_devices_interface.list(server_id)['devices'].collect {|it| {'name' => it['name'], 'value' => it['id']}}
+      device_id = MtnCloud::Cli::OptionTypes.prompt([{'fieldName' => 'deviceId', 'fieldLabel' => 'Device', 'type' => 'select', 'selectOptions' => avail_devices, 'required' => true}], options[:options], @api_client)['deviceId']        
+    end
+    parse_payload(options) do |payload|
+      
+    end
+    execute_api(@server_devices_interface, :detach, [server_id, device_id], options) do |json_response|
+      print_green_success "Detached host device"
+    end
+  end
+
+  private
+
+  # helper methods
+
+  def server_device_list_column_definitions()
+    # {
+    #   "ID" => 'id',
+    #   "Name" => 'name',
+    #   "Ref" => lambda {|it| "#{it['refType']} #{it['refId']}" },
+    #   "Type" => lambda {|it| it['type']['name'] rescue '' },
+    #   "Status" => lambda {|it| format_server_device_status(it) },
+    #   "External ID" => 'externalId',
+    #   "Domain ID" => 'domainId',
+    #   "Bus" => 'bus',
+    #   "Slot" => 'slot',
+    #   "Device" => 'device',
+    #   "Vendor ID" => 'vendorId',
+    #   "Product ID" => 'productId',
+    #   "Function ID" => 'functionId',
+    #   "Unique ID" => 'uniqueId',
+    #   "IOMMU Group" => 'iommuGroup',
+    #   "IOMMU Device Count" => 'iommuDeviceCount',
+    # }
+    {
+      "ID" => 'id',
+      "Name" => 'name',
+      "Type" => lambda {|it| it['type']['name'] rescue '' },
+      "Bus" => 'bus',
+      "Slot" => 'slot',
+      "Status" => lambda {|it| format_server_device_status(it) },
+      "Assignee" => lambda {|it| "#{it['refType']} #{it['refId']}" },
+    }
+  end
+
+  def server_device_column_definitions()
+    server_device_list_column_definitions()
+  end
+
+  def format_server_device_status(server_device, return_color=cyan)
+    out = ""
+    status_string = server_device['status'].to_s.upcase
+    if status_string == 'ATTACHED' # || status_string == 'ASSIGNED'
+      out <<  "#{green}#{status_string.upcase}#{return_color}"
+    elsif status_string == "PENDING"
+      out <<  "#{yellow}#{status_string.upcase}#{return_color}"
+    elsif status_string
+      out <<  "#{cyan}#{status_string.upcase}#{return_color}"
+    else
+      out <<  ""
+    end
+    out
+  end
+  
+end