ecs-solo 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c078f359d1c062293eca0caeb456d4f1ceb68c632fcc2cda74aab06cf967da3b
+  data.tar.gz: 4fc23a43f739db124d9aa470bc19bebe713979894e3eed467c5336e68a0b5d5c
+SHA512:
+  metadata.gz: 1d84bb9d91991e3427b7b1d97d798545bbfa30bada05bbd3205fc819c3d948c2188e535c0b89bd10b9a8de89279a1f4dee916e065d43881b401b2bf9f6e834b8
+  data.tar.gz: 74bf6a982800c9db88fb0f6225a56569ff11ebd35bced9b0e4a9e187353daf1ef6fbe6fd5fc4dfba6b17a3c19afa23a2638c343102ac1cadb5ac6baa20b54844

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
+
+## [0.1.0]
+- Initial release.

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+# Specify your gem dependencies in ecs_solo.gemspec
+gemspec
+
+gem "codeclimate-test-reporter", group: :test, require: nil

data/Gemfile.lock

@@ -0,0 +1,89 @@
+PATH
+  remote: .
+  specs:
+    ecs-solo (0.1.0)
+      activesupport
+      aws-sdk-cloudformation
+      aws-sdk-ecs
+      memoist
+      rainbow
+      thor
+      zeitwerk
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (6.0.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+      zeitwerk (~> 2.2)
+    aws-eventstream (1.0.3)
+    aws-partitions (1.278.0)
+    aws-sdk-cloudformation (1.30.0)
+      aws-sdk-core (~> 3, >= 3.71.0)
+      aws-sigv4 (~> 1.1)
+    aws-sdk-core (3.90.1)
+      aws-eventstream (~> 1.0, >= 1.0.2)
+      aws-partitions (~> 1, >= 1.239.0)
+      aws-sigv4 (~> 1.1)
+      jmespath (~> 1.0)
+    aws-sdk-ecs (1.57.0)
+      aws-sdk-core (~> 3, >= 3.71.0)
+      aws-sigv4 (~> 1.1)
+    aws-sigv4 (1.1.1)
+      aws-eventstream (~> 1.0, >= 1.0.2)
+    byebug (11.1.1)
+    cli_markdown (0.1.0)
+    codeclimate-test-reporter (1.0.9)
+      simplecov (<= 0.13)
+    concurrent-ruby (1.1.6)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    i18n (1.8.2)
+      concurrent-ruby (~> 1.0)
+    jmespath (1.4.0)
+    json (2.3.0)
+    memoist (0.16.2)
+    minitest (5.14.0)
+    rainbow (3.0.0)
+    rake (13.0.1)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    simplecov (0.13.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    thor (1.0.1)
+    thread_safe (0.3.6)
+    tzinfo (1.2.6)
+      thread_safe (~> 0.1)
+    zeitwerk (2.2.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  byebug
+  cli_markdown
+  codeclimate-test-reporter
+  ecs-solo!
+  rake
+  rspec
+
+BUNDLED WITH
+   2.1.4

data/Guardfile

@@ -0,0 +1,19 @@
+guard "bundler", cmd: "bundle" do
+  watch("Gemfile")
+  watch(/^.+\.gemspec/)
+end
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end

data/README.md

@@ -0,0 +1,42 @@
+# ecs-solo
+
+Deploy Docker image from ECS service to the current instance.  This is useful if you want to deploy the current running ECS docker image onto an EC2 instance outside of ECS purview. It can also be useful to run the Docker container locally and exam it.
+
+## Usage
+
+You may have to login to pull from the Docker regsitry first. Here's an example ECR login command:
+
+    eval $(aws ecr get-login --no-include-email --region us-west-2)
+
+There are 2 forms that the `ecs-solo deploy` understands:
+
+    ecs-solo deploy STACK_NAME # CloudFormation template AWS::ECS::Service resource
+    ecs-solo deploy ECS_SERVICE --cluster development
+
+* When passed the CloudFormation stack name, the ECS Cluster and Cluster is automatically infer. The cluster option is not needed and not used at all.
+* When passed the ECS Service, the --cluster optional will probably be needed since the ECS service may not be running in the default development cluster.
+
+## Override command
+
+You can override the default command in the Dockerfile with the `-c` option.
+
+    ecs-solo deploy demo-web-development -c bin/loop.sh
+
+## Example
+
+Here's an example with output:
+
+    $ ecs-solo deploy demo-web-development
+    Finding Docker image associated with service
+    Found task definition with Docker image
+    => docker ps -a -f name=ecs-demo-web-web --format '{{.Names}}' | grep ecs-demo-web-web
+    => docker run --name ecs-demo-web-web -d 112233445566.dkr.ecr.us-west-2.amazonaws.com/demo/sinatra:ufo-2020-02-28T20-11-55-f6ef0e0
+    d39bc08598bb133c36690b1bfe2c321c1fc219d3e8526174cb9b8e281f161f24
+    $ docker ps
+    CONTAINER ID        IMAGE                                                                                       COMMAND             CREATED             STATUS              PORTS               NAMES
+    d39bc08598bb        112233445566.dkr.ecr.us-west-2.amazonaws.com/demo/sinatra:ufo-2020-02-28T20-11-55-f6ef0e0   "bin/web"           3 seconds ago       Up 2 seconds        8080/tcp            ecs-demo-web-web
+    $
+
+## Installation
+
+    gem install ecs-solo

data/Rakefile

@@ -0,0 +1,14 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+task default: :spec
+
+RSpec::Core::RakeTask.new
+
+require_relative "lib/ecs_solo"
+require "cli_markdown"
+desc "Generates cli reference docs as markdown"
+task :docs do
+  mkdir_p "docs/_includes"
+  CliMarkdown::Creator.create_all(cli_class: EcsSolo::CLI, cli_name: "ecs_solo")
+end

data/ecs-solo.gemspec

@@ -0,0 +1,45 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "ecs_solo/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "ecs-solo"
+  spec.version       = EcsSolo::VERSION
+  spec.authors       = ["Tung Nguyen"]
+  spec.email         = ["tongueroo@gmail.com"]
+  spec.summary       = "Deploy Docker image from ECS service to current instance"
+  spec.homepage      = "https://github.com/tongueroo/ecs-solo"
+  spec.license       = "MIT"
+
+  spec.files         = Dir.glob("**/*")
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activesupport"
+  spec.add_dependency "aws-sdk-cloudformation"
+  spec.add_dependency "aws-sdk-ecs"
+  spec.add_dependency "memoist"
+  spec.add_dependency "rainbow"
+  spec.add_dependency "thor"
+  spec.add_dependency "zeitwerk"
+
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "byebug"
+  spec.add_development_dependency "cli_markdown"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    # spec.metadata["allowed_push_host"] = ""
+    spec.metadata["homepage_uri"] = spec.homepage
+    spec.metadata["source_code_uri"] = "https://github.com/tongueroo/ecs-deploy"
+    spec.metadata["changelog_uri"] = "https://github.com/tongueroo/ecs-deploy/blob/master/CHANGELOG.md"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+end

data/exe/ecs-solo

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# Trap ^C
+Signal.trap("INT") {
+  puts "\nCtrl-C detected. Exiting..."
+  sleep 0.1
+  exit
+}
+
+$:.unshift(File.expand_path("../../lib", __FILE__))
+require "ecs_solo"
+require "ecs_solo/cli"
+
+EcsSolo::CLI.start(ARGV)

data/lib/ecs-solo.rb

@@ -0,0 +1 @@
+require_relative "ecs_solo"

data/lib/ecs_solo.rb

@@ -0,0 +1,11 @@
+$:.unshift(File.expand_path("../", __FILE__))
+require "ecs_solo/version"
+require "memoist"
+require "rainbow/ext/string"
+
+require "ecs_solo/autoloader"
+EcsSolo::Autoloader.setup
+
+module EcsSolo
+  class Error < StandardError; end
+end

data/lib/ecs_solo/abstract_base.rb

@@ -0,0 +1,10 @@
+module EcsSolo
+  class AbstractBase
+    include AwsServices
+    extend Memoist
+
+    def initialize(options={})
+      @options = options
+    end
+  end
+end

data/lib/ecs_solo/autoloader.rb

@@ -0,0 +1,22 @@
+require "zeitwerk"
+
+module EcsSolo
+  class Autoloader
+    class Inflector < Zeitwerk::Inflector
+      def camelize(basename, _abspath)
+        map = { cli: "CLI", version: "VERSION" }
+        map[basename.to_sym] || super
+      end
+    end
+
+    class << self
+      def setup
+        loader = Zeitwerk::Loader.new
+        loader.inflector = Inflector.new
+        loader.push_dir(File.dirname(__dir__)) # lib
+        loader.ignore("#{File.dirname(__dir__)}/ecs-solo.rb")
+        loader.setup
+      end
+    end
+  end
+end

data/lib/ecs_solo/aws_services.rb

@@ -0,0 +1,18 @@
+require "aws-sdk-cloudformation"
+require "aws-sdk-ecs"
+
+module EcsSolo
+  module AwsServices
+    extend Memoist
+
+    def cloudformation
+      Aws::CloudFormation::Client.new
+    end
+    memoize :cloudformation
+
+    def ecs
+      Aws::ECS::Client.new
+    end
+    memoize :ecs
+  end
+end

data/lib/ecs_solo/cli.rb

@@ -0,0 +1,32 @@
+module EcsSolo
+  class CLI < Command
+    class_option :verbose, type: :boolean
+    class_option :noop, type: :boolean
+
+    desc "deploy IDENTIFIER", "Deploys Docker image associated with ECS service"
+    long_desc Help.text(:deploy)
+    option :cluster, default: "development", desc: "ECS Cluster"
+    option :force_new, type: :boolean, desc: "Force new container if container name is already in use"
+    option :command, aliases: :c, desc: "Command to use as part of docker run. Overrides default in the Dockerfile"
+    def deploy(identifier)
+      Deploy.new(options.merge(identifier: identifier)).run
+    end
+
+    desc "completion *PARAMS", "Prints words for auto-completion."
+    long_desc Help.text(:completion)
+    def completion(*params)
+      Completer.new(CLI, *params).run
+    end
+
+    desc "completion_script", "Generates a script that can be eval to setup auto-completion."
+    long_desc Help.text(:completion_script)
+    def completion_script
+      Completer::Script.generate
+    end
+
+    desc "version", "prints version"
+    def version
+      puts VERSION
+    end
+  end
+end

data/lib/ecs_solo/command.rb

@@ -0,0 +1,89 @@
+require "thor"
+
+# Override thor's long_desc identation behavior
+# https://github.com/erikhuda/thor/issues/398
+class Thor
+  module Shell
+    class Basic
+      def print_wrapped(message, options = {})
+        message = "\n#{message}" unless message[0] == "\n"
+        stdout.puts message
+      end
+    end
+  end
+end
+
+module EcsSolo
+  class Command < Thor
+    class << self
+      def dispatch(m, args, options, config)
+        # Allow calling for help via:
+        #   ecs_solo command help
+        #   ecs_solo command -h
+        #   ecs_solo command --help
+        #   ecs_solo command -D
+        #
+        # as well thor's normal way:
+        #
+        #   ecs_solo help command
+        help_flags = Thor::HELP_MAPPINGS + ["help"]
+        if args.length > 1 && !(args & help_flags).empty?
+          args -= help_flags
+          args.insert(-2, "help")
+        end
+
+        #   ecs_solo version
+        #   ecs_solo --version
+        #   ecs_solo -v
+        version_flags = ["--version", "-v"]
+        if args.length == 1 && !(args & version_flags).empty?
+          args = ["version"]
+        end
+
+        super
+      end
+
+      # Override command_help to include the description at the top of the
+      # long_description.
+      def command_help(shell, command_name)
+        meth = normalize_command_name(command_name)
+        command = all_commands[meth]
+        alter_command_description(command)
+        super
+      end
+
+      def alter_command_description(command)
+        return unless command
+
+        # Add description to beginning of long_description
+        long_desc = if command.long_description
+            "#{command.description}\n\n#{command.long_description}"
+          else
+            command.description
+          end
+
+        # add reference url to end of the long_description
+        unless website.empty?
+          full_command = [command.ancestor_name, command.name].compact.join('-')
+          url = "#{website}/reference/ecs_solo-#{full_command}"
+          long_desc += "\n\nHelp also available at: #{url}"
+        end
+
+        command.long_description = long_desc
+      end
+      private :alter_command_description
+
+      # meant to be overriden
+      def website
+        ""
+      end
+
+      # https://github.com/erikhuda/thor/issues/244
+      # Deprecation warning: Thor exit with status 0 on errors. To keep this behavior, you must define `exit_on_failure?` in `Lono::CLI`
+      # You can silence deprecations warning by setting the environment variable THOR_SILENCE_DEPRECATION.
+      def exit_on_failure?
+        true
+      end
+    end
+  end
+end

data/lib/ecs_solo/completer.rb

@@ -0,0 +1,159 @@
+=begin
+Code Explanation:
+
+There are 3 types of things to auto-complete:
+
+  1. command: the command itself
+  2. parameters: command parameters.
+  3. options: command options
+
+Here's an example:
+
+  mycli hello name --from me
+
+  * command: hello
+  * parameters: name
+  * option: --from
+
+When command parameters are done processing, the remaining completion words will be options.  We can tell that the command params are completed based on the method arity.
+
+## Arity
+
+For example, say you had a method for a CLI command with the following form:
+
+  ufo scale service count --cluster development
+
+It's equivalent ruby method:
+
+  scale(service, count) = has an arity of 2
+
+So typing:
+
+  ufo scale service count [TAB] # there are 3 parameters including the "scale" command according to Thor's CLI processing.
+
+So the completion should only show options, something like this:
+
+  --noop --verbose --cluster
+
+## Splat Arguments
+
+When the ruby method has a splat argument, it's arity is negative.  Here are some example methods and their arities.
+
+   ship(service) = 1
+   scale(service, count) = 2
+   ships(*services) = -1
+   foo(example, *rest) = -2
+
+Fortunately, negative and positive arity values are processed the same way. So we take simply take the absolute value of the arity and process it the same.
+
+Here are some test cases, hit TAB after typing the command:
+
+  ecs_solo completion
+  ecs_solo completion hello
+  ecs_solo completion hello name
+  ecs_solo completion hello name --
+  ecs_solo completion hello name --noop
+
+  ecs_solo completion
+  ecs_solo completion sub:goodbye
+  ecs_solo completion sub:goodbye name
+
+## Subcommands and Thor::Group Registered Commands
+
+Sometimes the commands are not simple thor commands but are subcommands or Thor::Group commands. A good specific example is the ufo tool.
+
+  * regular command: ufo ship
+  * subcommand: ufo docker
+  * Thor::Group command: ufo init
+
+Auto-completion accounts for each of these type of commands.
+=end
+module EcsSolo
+  class Completer
+    def initialize(command_class, *params)
+      @params = params
+      @current_command = @params[0]
+      @command_class = command_class # CLI initiall
+    end
+
+    def run
+      if subcommand?(@current_command)
+        subcommand_class = @command_class.subcommand_classes[@current_command]
+        @params.shift # destructive
+        Completer.new(subcommand_class, *@params).run # recursively use subcommand
+        return
+      end
+
+      # full command has been found!
+      unless found?(@current_command)
+        puts all_commands
+        return
+      end
+
+      # will only get to here if command aws found (above)
+      arity = @command_class.instance_method(@current_command).arity.abs
+      if @params.size > arity or thor_group_command?
+        puts options_completion
+      else
+        puts params_completion
+      end
+    end
+
+    def subcommand?(command)
+      @command_class.subcommands.include?(command)
+    end
+
+    # hacky way to detect that command is a registered Thor::Group command
+    def thor_group_command?
+      command_params(raw=true) == [[:rest, :args]]
+    end
+
+    def found?(command)
+      public_methods = @command_class.public_instance_methods(false)
+      command && public_methods.include?(command.to_sym)
+    end
+
+    # all top-level commands
+    def all_commands
+      commands = @command_class.all_commands.reject do |k,v|
+        v.is_a?(Thor::HiddenCommand)
+      end
+      commands.keys
+    end
+
+    def command_params(raw=false)
+      params = @command_class.instance_method(@current_command).parameters
+      # Example:
+      # >> Sub.instance_method(:goodbye).parameters
+      # => [[:req, :name]]
+      # >>
+      raw ? params : params.map!(&:last)
+    end
+
+    def params_completion
+      offset = @params.size - 1
+      offset_params = command_params[offset..-1]
+      command_params[offset..-1].first
+    end
+
+    def options_completion
+      used = ARGV.select { |a| a.include?('--') } # so we can remove used options
+
+      method_options = @command_class.all_commands[@current_command].options.keys
+      class_options = @command_class.class_options.keys
+
+      all_options = method_options + class_options + ['help']
+
+      all_options.map! { |o| "--#{o.to_s.gsub('_','-')}" }
+      filtered_options = all_options - used
+      filtered_options.uniq
+    end
+
+    # Useful for debugging. Using puts messes up completion.
+    def log(msg)
+      File.open("/tmp/complete.log", "a") do |file|
+        file.puts(msg)
+      end
+    end
+  end
+end

data/lib/ecs_solo/completer/script.rb

@@ -0,0 +1,6 @@
+class EcsSolo::Completer::Script
+  def self.generate
+    bash_script = File.expand_path("script.sh", File.dirname(__FILE__))
+    puts "source #{bash_script}"
+  end
+end

data/lib/ecs_solo/completer/script.sh

@@ -0,0 +1,10 @@
+_ecs_solo() {
+  COMPREPLY=()
+  local word="${COMP_WORDS[COMP_CWORD]}"
+  local words=("${COMP_WORDS[@]}")
+  unset words[0]
+  local completion=$(ecs_solo completion ${words[@]})
+  COMPREPLY=( $(compgen -W "$completion" -- "$word") )
+}
+
+complete -F _ecs_solo ecs_solo

data/lib/ecs_solo/deploy.rb

@@ -0,0 +1,73 @@
+module EcsSolo
+  class Deploy < AbstractBase
+    def initialize(options={})
+      super
+      @identifier = options[:identifier] # ECS Service or CloudFormation Stack
+      @cluster = options[:cluster]
+      @command = options[:command]
+    end
+
+    def run
+      task_definition = find_task_definition
+      unless task_definition
+        puts "Unable to task definition associated with service #{@service.color(:green)} in the cluster #{@cluster.color(:green)}"
+        exit 1
+      end
+
+      @docker = Docker.new(@options.merge(task_definition: task_definition))
+      @docker.execute
+    end
+
+    def find_task_definition
+      puts "Finding Docker image associated with service #{@service}"
+      service = find_service
+      return unless service
+
+      task_definition = service.task_definition
+      resp = ecs.describe_task_definition(task_definition: task_definition)
+      puts "Found task definition with Docker image"
+      resp.task_definition
+    end
+
+    def find_service
+      ecs_service_arn = cloudformation_ecs_service_arn(@identifier)
+      if ecs_service_arn
+        # IE: arn:aws:ecs:us-west-2:112233445566:service/development/demo-web-development-Ecs-179L598PRC44
+        @cluster = ecs_service_arn.split('/')[1] # override @cluster
+        ecs_service(ecs_service_arn)
+      else
+        ecs_service(@identifier)
+      end
+    end
+
+    def cloudformation_ecs_service_arn(stack_name)
+      resp = cloudformation.describe_stack_resources(stack_name: stack_name)
+      resource = resp.stack_resources.find { |r| r.resource_type == "AWS::ECS::Service" }
+      resource.physical_resource_id # IE: arn:aws:ecs:us-west-2:112233445566:service/development/demo-web-development-Ecs-179L598PRC44
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      if e.message.include?("does not exist")
+        return
+      else
+        raise(e)
+      end
+    end
+
+    def ecs_service(service)
+      begin
+        resp = ecs.describe_services(services: [service], cluster: @cluster)
+      rescue Aws::ECS::Errors::ClusterNotFoundException => e
+        puts "#{e.class}: #{e.message}"
+        puts "WARN: #{@cluster.color(:green)} not found."
+        return
+      end
+
+      resp.services.first
+    end
+
+  private
+    def docker
+      Docker.new
+    end
+    memoize :docker
+  end
+end

data/lib/ecs_solo/docker.rb

@@ -0,0 +1,74 @@
+module EcsSolo
+  class Docker
+    def initialize(options={})
+      @options = options
+      @task_definition = options[:task_definition] # describe_task_definition resp.task_definition
+      @command = options[:command] # will be array
+    end
+
+    def execute
+      unless in_use?
+        run
+        return
+      end
+
+      if @options[:force_new]
+        puts "INFO: Forcing new container"
+        stop
+        rm
+        run
+      else
+        puts "WARN: container name is already in use".color(:yellow)
+        puts "If you want to force a new container, use the --force-new option."
+      end
+    end
+
+    def run
+      sh "docker run --name #{name} -d #{image} #{@command}"
+    end
+
+    def in_use?
+      sh "docker ps -a -f name=#{name} --format '{{.Names}}' | grep #{name}"
+    end
+
+    def stop
+      sh "docker stop #{name}"
+    end
+
+    def rm
+      sh "docker rm #{name}"
+    end
+
+    def pull
+      sh "docker pull #{image}"
+    end
+
+    # Almost resembles the name ecs-agent generates.
+    # Unsure how about the random looking id at the end though. Example:
+    #
+    #     ecs-demo-web-217-web-86a0bcbac2b7d1b92d00
+    #
+    # So not including that.
+    #
+    # Also not including revision to make this script simpler. So final result:
+    #
+    #    ecs-demo-web-web
+    #
+    def name
+      "ecs-#{@task_definition.family}-#{container_definition.name}"
+    end
+
+    def image
+      container_definition.image
+    end
+
+    def container_definition
+      @task_definition.container_definitions.first
+    end
+
+    def sh(command)
+      puts "=> #{command}"
+      system(command)
+    end
+  end
+end

data/lib/ecs_solo/help.rb

@@ -0,0 +1,9 @@
+module EcsSolo::Help
+  class << self
+    def text(namespaced_command)
+      path = namespaced_command.to_s.gsub(':','/')
+      path = File.expand_path("../help/#{path}.md", __FILE__)
+      IO.read(path) if File.exist?(path)
+    end
+  end
+end

data/lib/ecs_solo/help/completion.md

@@ -0,0 +1,20 @@
+## Examples
+
+    ecs_solo completion
+
+Prints words for TAB auto-completion.
+
+    ecs_solo completion
+    ecs_solo completion hello
+    ecs_solo completion hello name
+
+To enable, TAB auto-completion add the following to your profile:
+
+    eval $(ecs_solo completion_script)
+
+Auto-completion example usage:
+
+    ecs_solo [TAB]
+    ecs_solo hello [TAB]
+    ecs_solo hello name [TAB]
+    ecs_solo hello name --[TAB]

data/lib/ecs_solo/help/completion_script.md

@@ -0,0 +1,3 @@
+To use, add the following to your `~/.bashrc` or `~/.profile`
+
+    eval $(ecs_solo completion_script)

data/lib/ecs_solo/help/deploy.md

@@ -0,0 +1,12 @@
+## Examples
+
+    ecs-solo deploy IDENTIFIER
+    ecs-solo deploy IDENTIFIER --cluster development
+
+The `IDENTIFIER` can be either a:
+
+1. CloudFormation stack name that has an `AWS::ECS::Service` resource. The ECS Service and its Cluster is inferred from the stack.
+2. ECS Service, the `--cluster` optional will probably be needed since the ECS service may not be running in the default development cluster.
+
+    ecs-solo deploy CFN_STACK
+    ecs-solo deploy ECS_SERVICE --cluster development

data/lib/ecs_solo/version.rb

@@ -0,0 +1,3 @@
+module EcsSolo
+  VERSION = "0.1.0"
+end

data/spec/cli_spec.rb

@@ -0,0 +1,26 @@
+describe EcsSolo::CLI do
+  before(:all) do
+    @args = "--from Tung"
+  end
+
+  describe "ecs_solo" do
+    it "hello" do
+      out = execute("exe/ecs_solo hello world #{@args}")
+      expect(out).to include("from: Tung\nHello world")
+    end
+
+    commands = {
+      "hell" => "hello",
+      "hello" => "name",
+      "hello -" =>  "--from",
+      "hello name" => "--from",
+      "hello name --" => "--from",
+    }
+    commands.each do |command, expected_word|
+      it "completion #{command}" do
+        out = execute("exe/ecs_solo completion #{command}")
+        expect(out).to include(expected_word) # only checking for one word for simplicity
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,29 @@
+ENV["BACKEND_ADMIN_TEST"] = "1"
+
+# CodeClimate test coverage: https://docs.codeclimate.com/docs/configuring-test-coverage
+# require 'simplecov'
+# SimpleCov.start
+
+require "pp"
+require "byebug"
+root = File.expand_path("../", File.dirname(__FILE__))
+require "#{root}/lib/ecs_solo"
+
+module Helper
+  def execute(cmd)
+    puts "Running: #{cmd}" if show_command?
+    out = `#{cmd}`
+    puts out if show_command?
+    out
+  end
+
+  # Added SHOW_COMMAND because DEBUG is also used by other libraries like
+  # bundler and it shows its internal debugging logging also.
+  def show_command?
+    ENV['DEBUG'] || ENV['SHOW_COMMAND']
+  end
+end
+
+RSpec.configure do |c|
+  c.include Helper
+end

metadata

@@ -0,0 +1,246 @@
+--- !ruby/object:Gem::Specification
+name: ecs-solo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tung Nguyen
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-02-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-cloudformation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-ecs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: memoist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cli_markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- tongueroo@gmail.com
+executables:
+- ecs-solo
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- Guardfile
+- README.md
+- Rakefile
+- ecs-solo.gemspec
+- exe/ecs-solo
+- lib/ecs-solo.rb
+- lib/ecs_solo.rb
+- lib/ecs_solo/abstract_base.rb
+- lib/ecs_solo/autoloader.rb
+- lib/ecs_solo/aws_services.rb
+- lib/ecs_solo/cli.rb
+- lib/ecs_solo/command.rb
+- lib/ecs_solo/completer.rb
+- lib/ecs_solo/completer/script.rb
+- lib/ecs_solo/completer/script.sh
+- lib/ecs_solo/deploy.rb
+- lib/ecs_solo/docker.rb
+- lib/ecs_solo/help.rb
+- lib/ecs_solo/help/completion.md
+- lib/ecs_solo/help/completion_script.md
+- lib/ecs_solo/help/deploy.md
+- lib/ecs_solo/version.rb
+- pkg/ecs-solo-0.1.0.gem
+- pkg/solo-0.1.0.gem
+- spec/cli_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/tongueroo/ecs-solo
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/tongueroo/ecs-solo
+  source_code_uri: https://github.com/tongueroo/ecs-deploy
+  changelog_uri: https://github.com/tongueroo/ecs-deploy/blob/master/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: Deploy Docker image from ECS service to current instance
+test_files:
+- spec/cli_spec.rb
+- spec/spec_helper.rb