morpheus-cli 2.11.0 → 2.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 943b71ed0cd1182919d30c80a340e4dddd348469
-  data.tar.gz: 5240605a00d07cfae6f73cc53789ad456ba99713
+  metadata.gz: 7a9c598b82ebbf8eea995f58a454bf8a52defef0
+  data.tar.gz: 6a81fff1ddc710ca3d56488670586caf7844ab93
 SHA512:
-  metadata.gz: 03b911517a40f1254ebb91e14d69d840038c80df028966b0cd23035b0fbc54eff8e22aa6bfa75cbc70584b26c858290c2e905b8115a1b7312066a3431fb56305
-  data.tar.gz: 93de8368cae2dd82312741584dc4d688fc9dc5a6defadccdcede1f58254a92765f65739d43d82e300c72547fb0dfb630eda587bac858537262c6a0e7ce90b783
+  metadata.gz: 5821cf3be29b11830eab7cf6e87f15ebb3f0e783d3d49664c5dbd6b824e775e6546b2da09a52983edf1dfd60058c51f40c9ae3cd591ea61fb5fb730b2766da6a
+  data.tar.gz: 356f77e67812b6f8b63e85f3c1a95c0206e5a5f456c912a65aae311f0040ad1eea4fae2d77d840a85be1a03bbc342db0b1097dfa07eb623ef1bb71e699b21786

data/lib/morpheus/api/api_client.rb

@@ -64,6 +64,10 @@ class Morpheus::APIClient
     Morpheus::InstancesInterface.new(@access_token, @refresh_token, @expires_at, @base_url)
   end
 
+  def containers
+    Morpheus::ContainersInterface.new(@access_token, @refresh_token, @expires_at, @base_url)
+  end
+
   def instance_types
     Morpheus::InstanceTypesInterface.new(@access_token, @refresh_token, @expires_at, @base_url)
   end

data/lib/morpheus/api/containers_interface.rb

@@ -0,0 +1,128 @@
+require 'morpheus/api/api_client'
+
+# Containers API interface.
+# All of the PUT methods support passing an array of IDs.
+class Morpheus::ContainersInterface < Morpheus::APIClient
+  def initialize(access_token, refresh_token,expires_at = nil, base_url=nil) 
+    @access_token = access_token
+    @refresh_token = refresh_token
+    @base_url = base_url
+    @expires_at = expires_at
+  end
+
+  # not used atm.. index api needs some work, we should implement it 
+  # so it just paginates all containers. 
+  # right now you can to pass params as {:ids => [1,2,3]}
+  def list(params={})
+    url = "#{@base_url}/api/containers"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def get(container_id)
+    url = "#{@base_url}/api/containers/#{container_id}"
+    headers = { :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def stop(container_id, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/stop"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/stop"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def start(container_id, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/start"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/start"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def restart(container_id, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/restart"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/restart"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def suspend(container_id, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/suspend"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/suspend"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def eject(container_id, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/eject"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/eject"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def available_actions(container_id)
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/actions"
+      params = {ids: container_id}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/actions"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def action(container_id, action_code, payload={})
+    url, params = "", {}
+    if container_id.is_a?(Array)
+      url = "#{@base_url}/api/containers/action"
+      params = {ids: container_id, code: action_code}
+    else
+      url = "#{@base_url}/api/containers/#{container_id}/action"
+      params = {code: action_code}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+end

data/lib/morpheus/api/instances_interface.rb

@@ -103,6 +103,34 @@ class Morpheus::InstancesInterface < Morpheus::APIClient
     execute(opts)
   end
 
+  def available_actions(id)
+    url, params = "", {}
+    if id.is_a?(Array)
+      url = "#{@base_url}/api/instances/actions"
+      params = {ids: id}
+    else
+      url = "#{@base_url}/api/instances/#{id}/actions"
+      params = {}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def action(id, action_code, payload={})
+    url, params = "", {}
+    if id.is_a?(Array)
+      url = "#{@base_url}/api/instances/action"
+      params = {ids: id, code: action_code}
+    else
+      url = "#{@base_url}/api/instances/#{id}/action"
+      params = {code: action_code}
+    end
+    headers = { :params => params, :authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
   def volumes(id)
     url = "#{@base_url}/api/instances/#{id}/volumes"
     headers = { :params => {},:authorization => "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
@@ -188,4 +216,39 @@ class Morpheus::InstancesInterface < Morpheus::APIClient
     execute(opts)
   end
 
+  def containers(instance_id, params={})
+    url = "#{@base_url}/api/instances/#{instance_id}/containers"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def threshold(id, params={})
+    url = "#{@base_url}/api/instances/#{id}/threshold"
+    headers = { params: params, authorization: "Bearer #{@access_token}" }
+    opts = {method: :get, url: url, headers: headers}
+    execute(opts)
+  end
+
+  def update_threshold(id, payload)
+    url = "#{@base_url}/api/instances/#{id}/threshold"
+    headers = {authorization: "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def update_load_balancer(id, payload)
+    url = "#{@base_url}/api/instances/#{id}/load-balancer"
+    headers = {authorization: "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :put, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
+  def remove_load_balancer(id, payload={})
+    url = "#{@base_url}/api/instances/#{id}/load-balancer"
+    headers = {authorization: "Bearer #{@access_token}", 'Content-Type' => 'application/json' }
+    opts = {method: :delete, url: url, headers: headers, payload: payload.to_json}
+    execute(opts)
+  end
+
 end

data/lib/morpheus/cli.rb

@@ -69,6 +69,7 @@ module Morpheus
       load 'morpheus/cli/workflows.rb'
       load 'morpheus/cli/deployments.rb'
       load 'morpheus/cli/instances.rb'
+      load 'morpheus/cli/containers_command.rb'
       load 'morpheus/cli/apps.rb'
       load 'morpheus/cli/app_templates.rb'
       load 'morpheus/cli/deploys.rb'

data/lib/morpheus/cli/cli_command.rb

@@ -128,7 +128,8 @@ module Morpheus
 
           description = "#{option_type['fieldLabel']}#{option_type['fieldAddOn'] ? ('(' + option_type['fieldAddOn'] + ') ') : '' }#{!option_type['required'] ? ' (optional)' : ''}#{option_type['defaultValue'] ? ' Default: '+option_type['defaultValue'].to_s : ''}"
           if option_type['description']
-            description << "\n                                     #{option_type['description']}"
+            # description << "\n                                     #{option_type['description']}"
+            description << " - #{option_type['description']}"
           end
           if option_type['helpBlock']
             description << "\n                                     #{option_type['helpBlock']}"
@@ -141,7 +142,18 @@ module Morpheus
           #   description = "(Required) #{description}"
           # end
           
-          opts.on("--#{full_field_name} VALUE", String, description) do |val|
+          value_label = "VALUE"
+          if option_type['placeHolder']
+            value_label = option_type['placeHolder']
+          elsif option_type['type'] == 'checkbox'
+            value_label = 'on|off' # or.. true|false
+          elsif option_type['type'] == 'number'
+            value_label = 'NUMBER'
+          # elsif option_type['type'] == 'select'
+          #   value_label = 'SELECT'
+          # elsif option['type'] == 'select'
+          end
+          opts.on("--#{full_field_name} #{value_label}", String, description) do |val|
             cur_namespace = custom_options
             field_namespace.each do |ns|
               next if ns.empty?
@@ -519,7 +531,7 @@ module Morpheus
             if ::Morpheus::Cli::Remote.appliances.empty?
               raise_command_error "You have no appliances configured. See the `remote add` command."
             else
-              raise_command_error "Remote appliance not found by the name '#{appliance_name}'"
+              raise_command_error "Remote appliance not found by the name '#{options[:remote]}'"
             end
           end
         else

data/lib/morpheus/cli/containers_command.rb

@@ -0,0 +1,519 @@
+require 'io/console'
+require 'rest_client'
+require 'optparse'
+require 'filesize'
+require 'table_print'
+require 'morpheus/cli/cli_command'
+require 'morpheus/cli/mixins/provisioning_helper'
+require 'morpheus/cli/option_types'
+
+class Morpheus::Cli::ContainersCommand
+  include Morpheus::Cli::CliCommand
+  include Morpheus::Cli::ProvisioningHelper
+
+  set_command_name :containers
+
+  register_subcommands :get, :stop, :start, :restart, :suspend, :eject, :action, :actions
+
+  def connect(opts)
+    @api_client = establish_remote_appliance_connection(opts)
+    @containers_interface = @api_client.containers
+  end
+  
+  def handle(args)
+    handle_subcommand(args)
+  end
+
+  def get(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[name]")
+      opts.on( nil, '--actions', "Display Available Actions" ) do
+        options[:include_available_actions] = true
+      end
+      build_common_options(opts, options, [:json, :yaml, :csv, :fields, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    return run_command_for_each_arg(id_list) do |arg|
+      _get(arg, options)
+    end
+  end
+
+  def _get(arg, options)
+    begin
+      if options[:dry_run]
+        print_dry_run @containers_interface.dry.get(arg.to_i)
+        return
+      end
+      #container = find_container_by_id(arg)
+      #return 1 if container.nil?
+      json_response = @containers_interface.get(arg.to_i)
+      if options[:json]
+        if options[:include_fields]
+          json_response = {"container" => filter_data(json_response["container"], options[:include_fields]) }
+        end
+        puts as_json(json_response, options)
+        return 0
+      elsif options[:yaml]
+        if options[:include_fields]
+          json_response = {"container" => filter_data(json_response["container"], options[:include_fields]) }
+        end
+        puts as_yaml(json_response, options)
+        return 0
+      end
+
+      if options[:csv]
+        puts records_as_csv([json_response['container']], options)
+        return 0
+      end
+      container = json_response['container']
+      # stats = json_response['stats'] || {}
+      stats = container['stats'] || {}
+      
+      # load_balancers = stats = json_response['loadBalancers'] || {}
+
+      # todo: show as 'VM' instead of 'Container' maybe..err
+      # may need to fetch instance by id too..
+      # ${[null,'docker'].contains(instance?.layout?.provisionType?.code) ? 'CONTAINERS' : 'VMs'}
+
+      print_h1 "Container Details"
+      print cyan
+      description_cols = {
+        "ID" => 'id',
+        #"Name" => 'name',
+        "Name" => lambda {|it| it['server'] ? it['server']['name'] : '(no server)' }, # there is a server.displayName too?
+        "Type" => lambda {|it| it['containerType'] ? it['containerType']['name'] : '' },
+        "Plan" => lambda {|it| it['plan'] ? it['plan']['name'] : '' },
+        "Instance" => lambda {|it| it['instance'] ? it['instance']['name'] : '' },
+        "Cloud" => lambda {|it| it['cloud'] ? it['cloud']['name'] : '' },
+        "Location" => lambda {|it| format_container_connection_string(it) },
+        # "Description" => 'description',
+        # "Group" => lambda {|it| it['group'] ? it['group']['name'] : '' },
+        # "Cloud" => lambda {|it| it['cloud'] ? it['cloud']['name'] : '' },
+        # "Type" => lambda {|it| it['instanceType']['name'] },
+        # "Plan" => lambda {|it| it['plan'] ? it['plan']['name'] : '' },
+        # "Environment" => 'instanceContext',
+        # "Nodes" => lambda {|it| it['containers'] ? it['containers'].count : 0 },
+        # "Connection" => lambda {|it| format_container_connection_string(it) },
+        #"Account" => lambda {|it| it['account'] ? it['account']['name'] : '' },
+        "Created" => lambda {|it| format_local_dt(it['dateCreated']) },
+        "Updated" => lambda {|it| format_local_dt(it['lastUpdated']) },
+        "Status" => lambda {|it| format_container_status(it) }
+      }
+      print_description_list(description_cols, container)
+
+      if (stats)
+        print_h2 "Container Usage"
+        print_stats_usage(stats)
+      end
+
+      if options[:include_available_actions]
+        if (container["availableActions"])
+          print_h2 "Available Actions"
+          print as_pretty_table(container["availableActions"], [:id, :name])
+          print reset, "\n"
+        else
+          print "#{yellow}No available actions#{reset}\n\n"
+        end
+      end
+
+      print reset, "\n"
+
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      return 1 # , e
+    end
+  end
+
+
+  def stop(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to stop #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+    return run_command_for_each_arg(id_list) do |arg|
+      _stop(arg, options)
+    end
+  end
+
+  def _stop(container_id, options)
+    container = find_container_by_id(container_id) # could skip this since only id is supported
+    return 1 if container.nil?
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.stop(container['id'])
+      return 0
+    end
+    json_response = @containers_interface.stop(container['id'])
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      print green, "Stopping container #{container['id']}", reset, "\n"
+    end
+    return 0
+  end
+
+  def start(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to start #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+    return run_command_for_each_arg(id_list) do |arg|
+      _start(arg, options)
+    end
+  end
+
+  def _start(container_id, options)
+    container = find_container_by_id(container_id) # could skip this since only id is supported
+    return 1 if container.nil?
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.start(container['id'])
+      return 0
+    end
+    json_response = @containers_interface.start(container['id'])
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      print green, "Starting container #{container['id']}", reset, "\n"
+    end
+    return 0
+  end
+
+  def restart(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to restart #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+    return run_command_for_each_arg(id_list) do |arg|
+      _restart(arg, options)
+    end
+  end
+
+  def _restart(container_id, options)
+    container = find_container_by_id(container_id) # could skip this since only id is supported
+    return 1 if container.nil?
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.restart(container['id'])
+      return 0
+    end
+    json_response = @containers_interface.restart(container['id'])
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      print green, "Restarting container #{container['id']}", reset, "\n"
+    end
+    return 0
+  end
+
+  def suspend(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to suspend #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+    return run_command_for_each_arg(id_list) do |arg|
+      _suspend(arg, options)
+    end
+  end
+
+  def _suspend(container_id, options)
+    container = find_container_by_id(container_id) # could skip this since only id is supported
+    return 1 if container.nil?
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.suspend(container['id'])
+      return 0
+    end
+    json_response = @containers_interface.suspend(container['id'])
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      print green, "Suspending container #{container['id']}", reset, "\n"
+    end
+    return 0
+  end
+
+  def eject(args)
+    options = {}
+    optparse = OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts_error "[id] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to eject #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+    return run_command_for_each_arg(id_list) do |arg|
+      _eject(arg, options)
+    end
+  end
+
+  def _eject(container_id, options)
+    container = find_container_by_id(container_id) # could skip this since only id is supported
+    return 1 if container.nil?
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.eject(container['id'])
+      return 0
+    end
+    json_response = @containers_interface.eject(container['id'])
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      print green, "Ejecting container #{container['id']}", reset, "\n"
+    end
+    return 0
+  end
+
+  def actions(args)
+    options = {}
+    optparse = Morpheus::Cli::OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list]")
+      opts.footer = "This outputs the list of the actions available to specified container(s)."
+      build_common_options(opts, options, [:json, :dry_run, :remote])
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      puts optparse
+      exit 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    containers = []
+    id_list.each do |container_id|
+      container = find_container_by_id(container_id)
+      if container.nil?
+        # return 1
+      else
+        containers << container
+      end
+    end
+    if containers.size != id_list.size
+      #puts_error "containers not found"
+      return 1
+    end
+    container_ids = containers.collect {|container| container["id"] }
+    begin
+      # container = find_container_by_name_or_id(args[0])
+      if options[:dry_run]
+        print_dry_run @containers_interface.dry.available_actions(container_ids)
+        return 0
+      end
+      json_response = @containers_interface.available_actions(container_ids)
+      if options[:json]
+        puts as_json(json_response, options)
+      else
+        title = "Container Actions: #{anded_list(id_list)}"
+        print_h1 title
+        available_actions = json_response["actions"]
+        if (available_actions && available_actions.size > 0)
+          print as_pretty_table(available_actions, [:name, :code])
+          print reset, "\n"
+        else
+          if container_ids.size > 1
+            print "#{yellow}The specified containers have no available actions in common.#{reset}\n\n"
+          else
+            print "#{yellow}No available actions#{reset}\n\n"
+          end
+        end
+      end
+      return 0
+    rescue RestClient::Exception => e
+      print_rest_exception(e, options)
+      exit 1
+    end
+  end
+
+  def action(args)
+    options = {}
+    action_id = nil
+    optparse = Morpheus::Cli::OptionParser.new do|opts|
+      opts.banner = subcommand_usage("[id list] -a CODE")
+      opts.on('-a', '--action CODE', "Container Action CODE to execute") do |val|
+        action_id = val.to_s
+      end
+      build_common_options(opts, options, [:auto_confirm, :json, :dry_run, :quiet, :remote])
+      opts.footer = "Execute an action for a container or containers"
+    end
+    optparse.parse!(args)
+    if args.count < 1
+      print_error Morpheus::Terminal.angry_prompt
+      puts_error "[id list] argument is required"
+      puts_error optparse
+      return 1
+    end
+    connect(options)
+    id_list = parse_id_list(args)
+    containers = []
+    id_list.each do |container_id|
+      container = find_container_by_id(container_id)
+      if container.nil?
+        # return 1
+      else
+        containers << container
+      end
+    end
+    if containers.size != id_list.size
+      #puts_error "containers not found"
+      return 1
+    end
+    container_ids = containers.collect {|container| container["id"] }
+
+    # figure out what action to run
+    # assume that the action is available for all the containers..
+    available_actions = containers.first['availableActions']
+    if available_actions.empty?
+      print_red_alert "Container #{container['id']} has no available actions"
+      if container_ids.size > 1
+        print_red_alert "The specified containers have no available actions in common"
+      else
+        print_red_alert "The specified container has no available actions"
+      end
+      return 1
+    end
+    container_action = nil
+    if action_id.nil?
+      available_actions_dropdown = available_actions.collect {|act| {'name' => act["name"], 'value' => act["code"]} } # already sorted
+      v_prompt = Morpheus::Cli::OptionTypes.prompt([{'fieldName' => 'code', 'type' => 'select', 'fieldLabel' => 'Container Action', 'selectOptions' => available_actions_dropdown, 'required' => true, 'description' => 'Choose the container action to execute'}], options[:options])
+      action_id = v_prompt['code']
+      container_action = available_actions.find {|act| act['code'].to_s == action_id.to_s }
+    else
+      container_action = available_actions.find {|act| act['code'].to_s == action_id.to_s || act['name'].to_s.downcase == action_id.to_s.downcase }
+      action_id = container_action["code"] if container_action
+    end
+    if !container_action
+      # for testing bogus actions..
+      # container_action = {"id" => action_id, "name" => "Unknown"}
+      raise_command_error "Container Action '#{action_id}' not found."
+    end
+
+    action_display_name = "#{container_action['name']} [#{container_action['code']}]"
+    unless options[:yes] || ::Morpheus::Cli::OptionTypes::confirm("Are you sure you would like to perform action #{action_display_name} on #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}?", options)
+      return 9, "aborted command"
+    end
+
+    # return run_command_for_each_arg(containers) do |arg|
+    #   _action(arg, action_id, options)
+    # end
+    if options[:dry_run]
+      print_dry_run @containers_interface.dry.action(container_ids, action_id)
+      return 0
+    end
+    json_response = @containers_interface.action(container_ids, action_id)
+    # just assume json_response["success"] == true,  it always is with 200 OK
+    if options[:json]
+      puts as_json(json_response, options)
+    elsif !options[:quiet]
+      # containers.each do |container|
+      #   print green, "Action #{action_display_name} performed on container #{container['id']}", reset, "\n"
+      # end
+      print green, "Action #{action_display_name} performed on #{id_list.size == 1 ? 'container' : 'containers'} #{anded_list(id_list)}", reset, "\n"
+    end
+    return 0
+  end
+
+private
+
+  def find_container_by_id(id)
+    begin
+      json_response = @containers_interface.get(id.to_i)
+      return json_response['container']
+    rescue RestClient::Exception => e
+      if e.response && e.response.code == 404
+        print_red_alert "Container not found by id #{id}"
+        return nil
+      else
+        raise e
+      end
+    end
+  end
+
+  def format_container_status(container, return_color=cyan)
+    out = ""
+    status_string = container['status'].to_s
+    if status_string == 'running'
+      out << "#{green}#{status_string.upcase}#{return_color}"
+    elsif status_string == 'stopped' or status_string == 'failed'
+      out << "#{red}#{status_string.upcase}#{return_color}"
+    elsif status_string == 'unknown'
+      out << "#{white}#{status_string.upcase}#{return_color}"
+    else
+      out << "#{yellow}#{status_string.upcase}#{return_color}"
+    end
+    out
+  end
+
+  def format_container_connection_string(container)
+    if !container['ports'].nil? && container['ports'].empty? == false
+      connection_string = "#{container['ip']}:#{container['ports'][0]['external']}"
+    else
+      # eh? more logic needed here i think, see taglib morph:containerLocationMenu
+      connection_string = "#{container['ip']}"
+    end
+  end
+
+end