vx-lib-container 0.5.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 52d219b00f697bccf0ae07cdfe83c6e84f94dd36
+  data.tar.gz: d8430e648a7a68d15a2c179873780dccbc4eef21
+SHA512:
+  metadata.gz: e6c1297d7736988de5b7bd18a9afe3417b8ff4844444114979acb3f2c3f5d1e48f44d465945c1169209ded9c3e1a6ca8f199b30f4eee09cf1e3d5563327e832a
+  data.tar.gz: 12f41995d3d5299b78b5de63ab131aefd6b9907d867e313893387a3131cfd67c9fa1d56786653b4c75db834e43df44bc82aafba307d020f3241c83ae6bee5cb9

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+vendor/ruby
+.vagrant

data/.rspec

@@ -0,0 +1,3 @@
+--color
+-f d
+--order=rand

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 2.0.0
+  - 2.1.0
+
+script: "rake travis"

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in vx-container_connector.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,276 @@
+Copyright (c) 2013 Dmitry Galinsky
+
+The GNU General Public License, Version 2, June 1991 (GPLv2)
+============================================================
+
+> Copyright (C) 1989, 1991 Free Software Foundation, Inc.
+> 59 Temple Place, Suite 330
+> Boston, MA  02111-1307 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license
+document, but changing it is not allowed.
+
+
+Preamble
+--------
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to
+guarantee your freedom to share and change free software--to make sure the
+software is free for all its users. This General Public License applies to most
+of the Free Software Foundation's software and to any other program whose
+authors commit to using it. (Some other Free Software Foundation software is
+covered by the GNU Library General Public License instead.) You can apply it to
+your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our
+General Public Licenses are designed to make sure that you have the freedom to
+distribute copies of free software (and charge for this service if you wish),
+that you receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you know you can
+do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny
+you these rights or to ask you to surrender the rights. These restrictions
+translate to certain responsibilities for you if you distribute copies of the
+software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a
+fee, you must give the recipients all the rights that you have. You must make
+sure that they, too, receive or can get the source code. And you must show them
+these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2) offer
+you this license which gives you legal permission to copy, distribute and/or
+modify the software.
+
+Also, for each author's protection and ours, we want to make certain that
+everyone understands that there is no warranty for this free software. If the
+software is modified by someone else and passed on, we want its recipients to
+know that what they have is not the original, so that any problems introduced by
+others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We wish
+to avoid the danger that redistributors of a free program will individually
+obtain patent licenses, in effect making the program proprietary. To prevent
+this, we have made it clear that any patent must be licensed for everyone's free
+use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification
+follow.
+
+
+Terms And Conditions For Copying, Distribution And Modification
+---------------------------------------------------------------
+0.  This License applies to any program or other work which contains a notice
+    placed by the copyright holder saying it may be distributed under the terms
+    of this General Public License. The "Program", below, refers to any such
+    program or work, and a "work based on the Program" means either the Program
+    or any derivative work under copyright law: that is to say, a work
+    containing the Program or a portion of it, either verbatim or with
+    modifications and/or translated into another language. (Hereinafter,
+    translation is included without limitation in the term "modification".)
+    Each licensee is addressed as "you".
+
+    Activities other than copying, distribution and modification are not
+    covered by this License; they are outside its scope. The act of running the
+    Program is not restricted, and the output from the Program is covered only
+    if its contents constitute a work based on the Program (independent of
+    having been made by running the Program). Whether that is true depends on
+    what the Program does.
+
+1.  You may copy and distribute verbatim copies of the Program's source code as
+    you receive it, in any medium, provided that you conspicuously and
+    appropriately publish on each copy an appropriate copyright notice and
+    disclaimer of warranty; keep intact all the notices that refer to this
+    License and to the absence of any warranty; and give any other recipients
+    of the Program a copy of this License along with the Program.
+
+    You may charge a fee for the physical act of transferring a copy, and you
+    may at your option offer warranty protection in exchange for a fee.
+
+2.  You may modify your copy or copies of the Program or any portion of it,
+    thus forming a work based on the Program, and copy and distribute such
+    modifications or work under the terms of Section 1 above, provided that you
+    also meet all of these conditions:
+
+    a)  You must cause the modified files to carry prominent notices stating
+        that you changed the files and the date of any change.
+
+    b)  You must cause any work that you distribute or publish, that in whole
+        or in part contains or is derived from the Program or any part thereof,
+        to be licensed as a whole at no charge to all third parties under the
+        terms of this License.
+
+    c)  If the modified program normally reads commands interactively when run,
+        you must cause it, when started running for such interactive use in the
+        most ordinary way, to print or display an announcement including an
+        appropriate copyright notice and a notice that there is no warranty (or
+        else, saying that you provide a warranty) and that users may
+        redistribute the program under these conditions, and telling the user
+        how to view a copy of this License. (Exception: if the Program itself
+        is interactive but does not normally print such an announcement, your
+        work based on the Program is not required to print an announcement.)
+
+    These requirements apply to the modified work as a whole. If identifiable
+    sections of that work are not derived from the Program, and can be
+    reasonably considered independent and separate works in themselves, then
+    this License, and its terms, do not apply to those sections when you
+    distribute them as separate works. But when you distribute the same
+    sections as part of a whole which is a work based on the Program, the
+    distribution of the whole must be on the terms of this License, whose
+    permissions for other licensees extend to the entire whole, and thus to
+    each and every part regardless of who wrote it.
+
+    Thus, it is not the intent of this section to claim rights or contest your
+    rights to work written entirely by you; rather, the intent is to exercise
+    the right to control the distribution of derivative or collective works
+    based on the Program.
+
+    In addition, mere aggregation of another work not based on the Program with
+    the Program (or with a work based on the Program) on a volume of a storage
+    or distribution medium does not bring the other work under the scope of
+    this License.
+
+3.  You may copy and distribute the Program (or a work based on it, under
+    Section 2) in object code or executable form under the terms of Sections 1
+    and 2 above provided that you also do one of the following:
+
+    a)  Accompany it with the complete corresponding machine-readable source
+        code, which must be distributed under the terms of Sections 1 and 2
+        above on a medium customarily used for software interchange; or,
+
+    b)  Accompany it with a written offer, valid for at least three years, to
+        give any third party, for a charge no more than your cost of physically
+        performing source distribution, a complete machine-readable copy of the
+        corresponding source code, to be distributed under the terms of
+        Sections 1 and 2 above on a medium customarily used for software
+        interchange; or,
+
+    c)  Accompany it with the information you received as to the offer to
+        distribute corresponding source code. (This alternative is allowed only
+        for noncommercial distribution and only if you received the program in
+        object code or executable form with such an offer, in accord with
+        Subsection b above.)
+
+    The source code for a work means the preferred form of the work for making
+    modifications to it. For an executable work, complete source code means all
+    the source code for all modules it contains, plus any associated interface
+    definition files, plus the scripts used to control compilation and
+    installation of the executable. However, as a special exception, the source
+    code distributed need not include anything that is normally distributed (in
+    either source or binary form) with the major components (compiler, kernel,
+    and so on) of the operating system on which the executable runs, unless
+    that component itself accompanies the executable.
+
+    If distribution of executable or object code is made by offering access to
+    copy from a designated place, then offering equivalent access to copy the
+    source code from the same place counts as distribution of the source code,
+    even though third parties are not compelled to copy the source along with
+    the object code.
+
+4.  You may not copy, modify, sublicense, or distribute the Program except as
+    expressly provided under this License. Any attempt otherwise to copy,
+    modify, sublicense or distribute the Program is void, and will
+    automatically terminate your rights under this License. However, parties
+    who have received copies, or rights, from you under this License will not
+    have their licenses terminated so long as such parties remain in full
+    compliance.
+
+5.  You are not required to accept this License, since you have not signed it.
+    However, nothing else grants you permission to modify or distribute the
+    Program or its derivative works. These actions are prohibited by law if you
+    do not accept this License. Therefore, by modifying or distributing the
+    Program (or any work based on the Program), you indicate your acceptance of
+    this License to do so, and all its terms and conditions for copying,
+    distributing or modifying the Program or works based on it.
+
+6.  Each time you redistribute the Program (or any work based on the Program),
+    the recipient automatically receives a license from the original licensor
+    to copy, distribute or modify the Program subject to these terms and
+    conditions. You may not impose any further restrictions on the recipients'
+    exercise of the rights granted herein. You are not responsible for
+    enforcing compliance by third parties to this License.
+
+7.  If, as a consequence of a court judgment or allegation of patent
+    infringement or for any other reason (not limited to patent issues),
+    conditions are imposed on you (whether by court order, agreement or
+    otherwise) that contradict the conditions of this License, they do not
+    excuse you from the conditions of this License. If you cannot distribute so
+    as to satisfy simultaneously your obligations under this License and any
+    other pertinent obligations, then as a consequence you may not distribute
+    the Program at all. For example, if a patent license would not permit
+    royalty-free redistribution of the Program by all those who receive copies
+    directly or indirectly through you, then the only way you could satisfy
+    both it and this License would be to refrain entirely from distribution of
+    the Program.
+
+    If any portion of this section is held invalid or unenforceable under any
+    particular circumstance, the balance of the section is intended to apply
+    and the section as a whole is intended to apply in other circumstances.
+
+    It is not the purpose of this section to induce you to infringe any patents
+    or other property right claims or to contest validity of any such claims;
+    this section has the sole purpose of protecting the integrity of the free
+    software distribution system, which is implemented by public license
+    practices. Many people have made generous contributions to the wide range
+    of software distributed through that system in reliance on consistent
+    application of that system; it is up to the author/donor to decide if he or
+    she is willing to distribute software through any other system and a
+    licensee cannot impose that choice.
+
+    This section is intended to make thoroughly clear what is believed to be a
+    consequence of the rest of this License.
+
+8.  If the distribution and/or use of the Program is restricted in certain
+    countries either by patents or by copyrighted interfaces, the original
+    copyright holder who places the Program under this License may add an
+    explicit geographical distribution limitation excluding those countries, so
+    that distribution is permitted only in or among countries not thus excluded.
+    In such case, this License incorporates the limitation as if written in
+    the body of this License.
+
+9.  The Free Software Foundation may publish revised and/or new versions of the
+    General Public License from time to time. Such new versions will be similar
+    in spirit to the present version, but may differ in detail to address new
+    problems or concerns.
+
+    Each version is given a distinguishing version number. If the Program
+    specifies a version number of this License which applies to it and "any
+    later version", you have the option of following the terms and conditions
+    either of that version or of any later version published by the Free
+    Software Foundation. If the Program does not specify a version number of
+    this License, you may choose any version ever published by the Free
+    Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs
+    whose distribution conditions are different, write to the author to ask for
+    permission. For software which is copyrighted by the Free Software
+    Foundation, write to the Free Software Foundation; we sometimes make
+    exceptions for this. Our decision will be guided by the two goals of
+    preserving the free status of all derivatives of our free software and of
+    promoting the sharing and reuse of software generally.
+
+
+No Warranty
+-----------
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR
+    THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
+    OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+    PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+    OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO
+    THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
+    PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
+    CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
+    ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE
+    THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+    GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+    USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+    DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+    PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+    EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+    SUCH DAMAGES.

data/Rakefile

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'bundler'
+Bundler.require
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+desc "run travis build"
+task :travis do
+  exec "bundle exec rake SPEC_OPTS='--format documentation -t ~docker --order=rand'"
+end
+
+namespace :remote do
+  desc "run box"
+  task :up do
+    exec "vagrant up --provider=rackspace"
+  end
+
+  desc "destroy box"
+  task :down do
+    exec "vagrant destroy -f"
+  end
+
+  desc "run spec on rackspace box"
+  task :spec do
+    1
+  end
+end
+

data/Vagrantfile

@@ -0,0 +1,28 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+  config.vm.box = "dummy"
+
+  config.ssh.private_key_path = "~/.ssh/id_rsa"
+  config.ssh.pty = true
+
+  config.vm.provider :rackspace do |rs|
+    rs.username          = ENV['SDK_USERNAME']
+    rs.api_key           = ENV['SDK_TOKEN']
+    rs.flavor            = /4 GB/
+    rs.image             = /Ubuntu 14.04/
+    rs.rackspace_region  = ENV['SDK_REGION']
+    rs.key_name          = ENV['SDK_KEYNAME']
+    rs.server_name       = 'vx.lib.container.build'
+  end
+
+  script = <<SCRIPT
+/vagrant/scripts/box_up.sh
+SCRIPT
+
+  config.vm.provision "shell", inline: script
+end

data/lib/vx/lib/container/docker/spawner.rb

@@ -0,0 +1,24 @@
+require 'vx/lib/shell'
+
+module Vx ; module Lib ; module Container ;
+
+  class Docker
+
+    Spawner = Struct.new(:container, :ssh) do
+
+      include Lib::Shell
+      include Lib::Container::Upload
+
+      def exec(script, &logger)
+        sh(:ssh, ssh).exec upload(script, "~/build.sh", mode: '0755', &logger)
+        sh(:ssh, ssh).exec("~/build.sh", &logger)
+      end
+
+      def id
+        container.id
+      end
+
+    end
+  end
+
+end ; end ; end

data/lib/vx/lib/container/docker.rb

@@ -0,0 +1,102 @@
+require 'docker'
+require 'excon'
+require 'timeout'
+require 'net/ssh'
+require 'vx/lib/shell'
+
+module Vx
+  module Lib
+    module Container
+
+      class Docker
+
+        autoload :Spawner, File.expand_path("../docker/spawner", __FILE__)
+
+        include Lib::Shell
+        include Lib::Container::Retriable
+        include Lib::Container::Instrument
+
+        attr_reader :user, :password, :init, :image, :remote_dir, :memory, :memory_swap
+
+        def initialize(options = {})
+          @user        = options[:user]        || "vexor"
+          @password    = options[:password]    || "vexor"
+          @init        = options[:init]        || %w{ /sbin/my_init }
+          @image       = options[:image]       || "vexor/trusty:2.0.1"
+          @memory      = options[:memory].to_i
+          @memory_swap = options[:memory_swap].to_i
+        end
+
+        def start(&block)
+          start_container do |container|
+            open_ssh_session(container, &block)
+          end
+        end
+
+        def create_container_options
+          @create_container_options ||= {
+            'Cmd'        => init,
+            'Image'      => image,
+            'Memory'     => memory,
+            'MemorySwap' => memory_swap
+          }
+        end
+
+        private
+
+          def open_ssh_session(container)
+            host = container.json['NetworkSettings']['IPAddress']
+
+            ssh_options = {
+              password:      password,
+              port:          22,
+              paranoid:      false,
+              forward_agent: false,
+              timeout:       3,
+            }
+
+            instrumentation = {
+              container_type: "docker",
+              container:      container.json,
+              ssh_options:    ssh_options.merge(host: host, user: user)
+            }
+
+            ssh = with_retries ::Net::SSH::AuthenticationFailed, ::Errno::ECONNREFUSED, ::Errno::ETIMEDOUT, ::Timeout::Error, limit: 5, sleep: 3 do
+              instrument("start_ssh_session", instrumentation) do
+                ::Net::SSH.start host, user, ssh_options
+              end
+            end
+
+            re = yield Spawner.new(container, ssh)
+            ssh.shutdown!
+            re
+          end
+
+          def start_container(&block)
+            container = instrument("create", container_type: "docker", container_options: create_container_options) do
+              ::Docker::Container.create create_container_options
+            end
+
+            instrumentation = {
+              container_type: "docker",
+              container:      container.json
+            }
+
+            instrument("start", instrumentation) do
+              container.start
+            end
+
+            begin
+              yield container
+            ensure
+              instrument("kill", instrumentation) do
+                container.kill
+                container.remove
+              end
+            end
+          end
+
+      end
+    end
+  end
+end

data/lib/vx/lib/container/errors.rb

@@ -0,0 +1,7 @@
+module Vx
+  module Lib
+    module Container
+      class NotFoundConnector < ::StandardError ; end
+    end
+  end
+end

data/lib/vx/lib/container/local/spawner.rb

@@ -0,0 +1,28 @@
+require 'vx/lib/shell'
+require 'stringio'
+
+module Vx
+  module Lib
+    module Container
+
+      class Local
+        Spawner = Struct.new(:work_dir) do
+          include Lib::Shell
+          include Lib::Container::Upload
+
+          def exec(script, &logger)
+            Dir.chdir work_dir do
+              sh.exec upload(script, "~/build.sh", mode: '0755')
+              sh.exec("~/build.sh", &logger)
+            end
+          end
+
+          def id
+            work_dir
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/vx/lib/container/local.rb

@@ -0,0 +1,43 @@
+require 'tempfile'
+require 'fileutils'
+
+module Vx ; module Lib ; module Container ;
+
+  class Local
+
+    include Lib::Container::Instrument
+
+    autoload :Spawner, File.expand_path("../local/spawner", __FILE__)
+
+    attr_reader :work_dir
+
+    def initialize(options = {})
+      @work_dir = options[:work_dir] || default_work_dir
+      @work_dir = File.expand_path(@work_dir)
+    end
+
+    def start(&block)
+      instrument( "create", container_type: 'local', container: { work_dir: work_dir }) do
+        FileUtils.rm_rf(work_dir)
+        FileUtils.mkdir_p(work_dir)
+      end
+
+      begin
+        spawner = Spawner.new(work_dir)
+        yield spawner
+      ensure
+        instrument( "kill", container_type: 'local', container: { work_dir: work_dir }) do
+          FileUtils.mkdir_p(work_dir)
+        end
+      end
+    end
+
+    private
+
+    def default_work_dir
+      "#{::Dir.tmpdir}/vx_lib_container_#{::Process.pid}"
+    end
+
+  end
+
+end ; end ; end

data/lib/vx/lib/container/mixin/instrument.rb

@@ -0,0 +1,23 @@
+module Vx
+  module Lib
+    module Container
+      module Instrument
+
+        def instrument(name, payload, &block)
+          name = "#{name}.container.lib.vx"
+
+          if ENV['DEBUG']
+            $stdout.puts " --> #{name}: #{payload}"
+          end
+
+          if inst = Container.instrumenter
+            inst.instrument(name, payload, &block)
+          else
+            yield if block_given?
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/vx/lib/container/mixin/retriable.rb

@@ -0,0 +1,42 @@
+module Vx
+  module Lib
+    module Container
+      module Retriable
+        # This will catch any exception and retry twice (three tries total):
+        #   with_retries { ... }
+        #
+        # This will catch any exception and retry four times (five tries total):
+        #   with_retries(:limit => 5) { ... }
+        #
+        # This will catch a specific exception and retry once (two tries total):
+        #   with_retries(Some::Error, :limit => 2) { ... }
+        #
+        # You can also sleep inbetween tries. This is helpful if you're hoping
+        # that some external service recovers from its issues.
+        #   with_retries(Service::Error, :sleep => 1) { ... }
+        #
+        def with_retries(*args, &block)
+          options = args.last.is_a?(Hash) ? args.pop : {}
+          exceptions = args
+
+          options[:limit] ||= 3
+          options[:sleep] ||= 0
+          exceptions = [Exception] if exceptions.empty?
+
+          retried = 0
+          begin
+            yield
+          rescue *exceptions => e
+            if retried + 1 < options[:limit]
+              retried += 1
+              sleep options[:sleep]
+              retry
+            else
+              raise e
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vx/lib/container/mixin/upload.rb

@@ -0,0 +1,13 @@
+require 'base64'
+
+module Vx ; module Lib ; module Container
+
+  module Upload
+    def upload(content, path, options = {})
+      mode = options[:mode] || '0600'
+      encoded = ::Base64.encode64(content).gsub("\n", '')
+      "( echo #{encoded} | base64 --decode ) > #{path} ; chmod #{mode} #{path}"
+    end
+  end
+
+end ; end ; end

data/lib/vx/lib/container/version.rb

@@ -0,0 +1,7 @@
+module Vx
+  module Lib
+    module Container
+      VERSION = "0.5.7"
+    end
+  end
+end

data/lib/vx/lib/container.rb

@@ -0,0 +1,32 @@
+require File.expand_path("../container/version", __FILE__)
+require File.expand_path("../container/errors",  __FILE__)
+
+module Vx
+  module Lib
+    module Container
+
+      autoload :Local,      File.expand_path("../container/local",            __FILE__)
+      autoload :Docker,     File.expand_path("../container/docker",           __FILE__)
+      autoload :Retriable,  File.expand_path("../container/mixin/retriable",  __FILE__)
+      autoload :Instrument, File.expand_path("../container/mixin/instrument", __FILE__)
+      autoload :Upload,     File.expand_path("../container/mixin/upload",     __FILE__)
+
+      extend self
+
+      attr_accessor :instrumenter
+
+      def lookup(name, options = {})
+        case name.to_sym
+        when :docker
+          Container::Docker.new options
+        when :local
+          Container::Local.new options
+        else
+          raise NotFoundConnector.new("No available connector for #{name.inspect} found")
+        end
+      end
+
+    end
+
+  end
+end

data/scripts/box_up.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+
+set -e
+set -x
+
+cd /root
+
+apt-get update -y
+apt-get install software-properties-common -y
+add-apt-repository ppa:brightbox/ruby-ng-experimental -y
+apt-get update -y
+apt-get install ruby2.1 -y
+gem install bundler --no-ri --no-rdoc
+
+curl -sSL https://get.docker.com/ | sh
+
+curl -o insecure_key -fSL https://github.com/phusion/baseimage-docker/raw/master/image/insecure_key
+chmod 600 insecure_key
+
+docker pull phusion/baseimage:0.9.15

data/spec/lib/container_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Vx::Lib::Container do
+  it { should be }
+
+  context "lookup" do
+    it "should return local connector" do
+      expect(described_class.lookup(:local)).to be_an_instance_of(Vx::Lib::Container::Local)
+    end
+
+    it "should return docker connector" do
+      expect(described_class.lookup(:docker)).to be_an_instance_of(Vx::Lib::Container::Docker)
+    end
+  end
+end

data/spec/lib/docker_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+describe Vx::Lib::Container::Docker do
+  let(:conn) { described_class.new }
+
+  it { should be }
+
+  context "user" do
+    subject { conn.user }
+
+    it "by default should eq 'vexor'" do
+      expect(subject).to eq 'vexor'
+    end
+
+    it "when passed via options should be" do
+      expect(described_class.new(user: "user").user).to eq 'user'
+    end
+  end
+
+  context "password" do
+    subject { conn.password }
+
+    it "by default should eq 'vexor'" do
+      expect(subject).to eq 'vexor'
+    end
+
+    it "when passed via options should be" do
+      expect(described_class.new(password: "pass").password).to eq 'pass'
+    end
+  end
+
+  context "image" do
+    subject { conn.image }
+
+    it "when passed via options should be" do
+      expect(described_class.new(image: "image").image).to eq 'image'
+    end
+  end
+
+  context "init" do
+    subject { conn.init }
+
+    it "by default should be" do
+      expect(subject).to eq ["/sbin/my_init"]
+    end
+
+    it "when passed via options should be" do
+      expect(described_class.new(init: "init").init).to eq 'init'
+    end
+  end
+
+  context "start container", docker: true do
+
+    let(:conn) { described_class.new }
+
+    it 'should be successfuly' do
+      rs = nil
+      conn.start do |sh|
+        rs = sh.id
+      end
+      expect(rs).to_not be_empty
+    end
+
+    it 'should be successfuly with memory limit' do
+      gb = 1024 * 1024 * 1024
+      conn = described_class.new memory: gb, memory_swap: 2 * gb
+      rs = nil
+      conn.start do |sh|
+        rs = sh.id
+      end
+
+      expect(rs).to_not be_empty
+    end
+
+    context "and spawn script" do
+      it "successfuly" do
+        rs   = ""
+        code = nil
+
+        conn.start do |sh|
+          code = sh.exec("pwd") do |out|
+            rs << out
+          end
+        end
+
+        expect(rs).to eq "/home/vexor\r\n"
+        expect(code).to eq 0
+      end
+
+      it "failed" do
+        code = nil
+        rs   = ""
+        conn.start do |sh|
+          code = sh.exec('ls /notexists ; exit') do |out|
+            rs << out
+          end
+        end
+
+        expect([1,2]).to be_include(code)
+        expect(rs).to match(/No such file or directory/)
+      end
+    end
+  end
+
+end

data/spec/lib/local_spec.rb

@@ -0,0 +1,64 @@
+require 'spec_helper'
+
+describe Vx::Lib::Container::Local do
+  let(:conn) { described_class.new }
+  subject { conn }
+
+  it { should be }
+
+  context "work_dir" do
+    it "by default should be inside Dir.tmpdir" do
+      expect(conn.work_dir).to eq("#{Dir.tmpdir}/vx_lib_container_#{Process.pid}")
+    end
+
+    it "when passed via options, should be" do
+      expect(described_class.new(work_dir: "/tmp").work_dir).to eq '/tmp'
+    end
+  end
+
+  context "start container" do
+
+    it "spawner id should eq local" do
+      rs = nil
+      conn.start do |sh|
+        rs = sh.id
+      end
+      expect(rs).to be
+    end
+
+    context "and spawn script" do
+      it "successfuly" do
+        rs   = ""
+        code = nil
+
+        conn.start do |sh|
+          code = sh.exec("pwd") do |out|
+            rs << out
+          end
+        end
+
+        dir = "#{Dir.tmpdir}/vx_lib_container_#{Process.pid}\n"
+        if RUBY_PLATFORM =~ /darwin/
+          dir.gsub!(/^\/var/, '/private/var')
+        end
+
+        expect(rs).to eq dir
+        expect(code).to eq 0
+      end
+
+      it "failed" do
+        code = nil
+        rs   = ""
+        conn.start do |sh|
+          code = sh.exec('ls /notexists') do |out|
+            rs << out
+          end
+        end
+
+        expect(rs).to match(/No such file or directory/)
+        expect([1,2]).to be_include(code)
+      end
+    end
+  end
+
+end

data/spec/lib/mixin/retriable_spec.rb

@@ -0,0 +1,32 @@
+require 'spec_helper'
+
+class TestRetriable
+  include Vx::Lib::Container::Retriable
+
+  class Error < Exception ; end
+end
+
+describe Vx::Lib::Container::Retriable do
+  let(:proxy) { TestRetriable.new }
+
+  it "should rescue 2 times" do
+    expect(test_retriable(2)).to eq :pass
+  end
+
+  it "should fail on 3 attempt" do
+    expect {
+      test_retriable(3)
+    }.to raise_error(TestRetriable::Error, "0")
+  end
+
+  def test_retriable(n)
+    proxy.with_retries(TestRetriable::Error, limit: 3, sleep: 0.1) do
+      if n != 0
+        n -= 1
+        raise TestRetriable::Error.new(n.to_s)
+      end
+      :pass
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+Bundler.require(:test)
+
+#ENV['VX_ENV']     = 'test'
+#ENV['DOCKER_URL'] = "tcp://localhost:2375"
+
+require File.expand_path '../../lib/vx/lib/container', __FILE__
+require 'rspec/autorun'
+
+Dir[File.expand_path("../..", __FILE__) + "/spec/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+end

data/vx-lib-container.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'vx/lib/container/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "vx-lib-container"
+  spec.version       = Vx::Lib::Container::VERSION
+  spec.authors       = ["Dmitry Galinsky"]
+  spec.email         = ["dima.exe@gmail.com"]
+  spec.description   = %q{ description }
+  spec.summary       = %q{ summary }
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'docker-api',   '= 1.16.1'
+  spec.add_runtime_dependency 'vx-lib-shell', '= 0.1.3'
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

metadata

@@ -0,0 +1,143 @@
+--- !ruby/object:Gem::Specification
+name: vx-lib-container
+version: !ruby/object:Gem::Version
+  version: 0.5.7
+platform: ruby
+authors:
+- Dmitry Galinsky
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.16.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.16.1
+- !ruby/object:Gem::Dependency
+  name: vx-lib-shell
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: " description "
+email:
+- dima.exe@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- Rakefile
+- Vagrantfile
+- lib/vx/lib/container.rb
+- lib/vx/lib/container/docker.rb
+- lib/vx/lib/container/docker/spawner.rb
+- lib/vx/lib/container/errors.rb
+- lib/vx/lib/container/local.rb
+- lib/vx/lib/container/local/spawner.rb
+- lib/vx/lib/container/mixin/instrument.rb
+- lib/vx/lib/container/mixin/retriable.rb
+- lib/vx/lib/container/mixin/upload.rb
+- lib/vx/lib/container/version.rb
+- scripts/box_up.sh
+- spec/lib/container_spec.rb
+- spec/lib/docker_spec.rb
+- spec/lib/local_spec.rb
+- spec/lib/mixin/retriable_spec.rb
+- spec/spec_helper.rb
+- vx-lib-container.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+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: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: summary
+test_files:
+- spec/lib/container_spec.rb
+- spec/lib/docker_spec.rb
+- spec/lib/local_spec.rb
+- spec/lib/mixin/retriable_spec.rb
+- spec/spec_helper.rb