docker-pier 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4db1df031b3184db08b38589afed042f43c93f5c
+  data.tar.gz: 56f5f252bebdc7300fdf8d109b69827d08125dc3
+SHA512:
+  metadata.gz: 621f0d87acabf5d89435c3b5597edee4cdc73a1a61838f1250f8fb2da630941538de95f68a1a0470fe9e400906baa9c61209ba7947883a73e1b48f3a004122fb
+  data.tar.gz: eea7967dbb62ab38d06d9047981a6672ad91849770d70967e3504d425d3277e169cd1b70603784dbaf959ee5a48150b1adf0a6b39c0c2f9b2723d155cee8b9f0

data/.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

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

data/README.md

@@ -0,0 +1,46 @@
+# Pier
+
+Pier is an alternative Docker client, which uses the Ruby [docker-api](https://github.com/swipely/docker-api) gem to access the Docker Remote API. Pier is focused on the use-case of managing one or more clusters of machines which are entirely dedicated to running a Docker swarm.
+
+Pier uses [fog](http://fog.io/) for its instance management. For now, only the [fog-libvirt](https://github.com/fog/fog-libvirt) backend is supported.
+
+Pier assumes that each cluster has a cluster-manager endpoint, called a "pier." The pier is a running instance that must:
+
+* be accessible via SSH;
+* be a manager in your Docker swarm; and
+* have `easy-rsa` installed and set up to generate both server and client certificates.
+
+A pier need not be a member of the cluster itself. Pier does not manage the pier, only the cluster visible through the pier.
+
+By default, Pier also assumes that each pier is the _libvirt hypervisor_ for its cluster—i.e. that libvirt's endpoint is accessible as `qemu+ssh://[your-pier-endpoint]/system`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'docker-pier'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install docker-pier
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/tsutsu/docker-pier.
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "docker-pier"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+ENV['PIER'] ||= '//tsutsu@vizier.staging.meetwalter.co'
+
+include DockerPier
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docker-pier.gemspec

@@ -0,0 +1,36 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'docker-pier/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "docker-pier"
+  spec.version       = DockerPier::VERSION
+  spec.authors       = ["Levi Aul"]
+  spec.email         = ["levi@leviaul.com"]
+
+  spec.summary       = %q{An alternative Docker client for dedicated Docker Swarm clusters}
+  spec.homepage      = "https://github.com/tsutsu/docker-pier"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+
+  spec.add_runtime_dependency     "fog-libvirt", "~> 0.3.0"
+  spec.add_runtime_dependency     "docker-api", "~> 1.32", ">= 1.32.1"
+  spec.add_runtime_dependency     "net-ssh", "~> 3.2"
+  spec.add_runtime_dependency     "net-scp", "~> 1.2", ">= 1.2.1"
+  spec.add_runtime_dependency     "highline", "~> 1.7", ">= 1.7.8"
+  spec.add_runtime_dependency     "pry", "~> 0.10.4"
+  spec.add_runtime_dependency     "main", "~> 6.2", ">= 6.2.1"
+  spec.add_runtime_dependency     "sequel", "~> 4.39"
+  spec.add_runtime_dependency     "amalgalite", "~> 1.5"
+  spec.add_runtime_dependency     "color", "~> 1.8"
+  spec.add_runtime_dependency     "paint", "~> 1.0", ">= 1.0.1"
+end

data/exe/docker-pier

@@ -0,0 +1,197 @@
+#!/usr/bin/env ruby
+require "docker-pier"
+require "main"
+require "highline"
+
+Main do
+  db do
+    create_table(:clusters) do
+      primary_key :id
+      String :name, unique: true, null: false
+      String :pier_uri, null: false
+    end unless table_exists?(:clusters)
+  end
+
+  def run
+    $stderr.puts "use `#{File.basename($0)} --help` for usage"
+  end
+
+
+  mode 'list' do
+    def run
+      db[:clusters].each do |cluster|
+        puts "#{cluster[:name]}: #{cluster[:pier_uri]}"
+      end
+    end
+  end
+
+  mode 'detach' do
+    argument('name'){
+      description "a cluster nickname"
+      required
+    }
+
+    def run
+      cluster_name = params[:name].values.first
+      pier = db[:clusters].where(name: cluster_name).delete
+
+      in_use_cluster_name = ENV['DOCKER_MACHINE_NAME']
+      if cluster_name == in_use_cluster_name
+        puts <<~EOF
+          unset DOCKER_TLS_VERIFY
+          unset DOCKER_HOST
+          unset DOCKER_CERT_PATH
+          unset DOCKER_MACHINE_NAME
+        EOF
+      end
+    end
+  end
+
+  mode 'attach' do
+    argument('name'){
+      description "nickname for the new cluster"
+      required
+    }
+
+    argument('uri'){
+      description "URI of the cluster's pier"
+      required
+    }
+
+    def run
+      cluster_name = params[:name].values.first
+      pier_uri = URI.parse('//' + params[:uri].values.first + '/')
+
+      # test validity
+      pier = DockerPier::Pier.new(pier_uri, name: cluster_name)
+      pier.bootstrap!
+
+      pier.libvirt.get_node_info
+      Docker.info(pier.docker)
+      pier.ssh.exec! 'pwd'
+
+      db[:clusters].insert(nil, cluster_name, pier_uri.to_s)
+
+      puts <<~EOF
+        export DOCKER_TLS_VERIFY=1
+        export DOCKER_HOST=#{pier.resolved_docker_uri}
+        export DOCKER_CERT_PATH=#{pier.x509_dir}
+        export DOCKER_MACHINE_NAME=#{cluster_name}
+      EOF
+    end
+  end
+
+  mode 'on' do
+    argument('name'){
+      description "nickname of the cluster to switch to"
+      required
+    }
+
+    def run
+      cluster_name = params[:name].values.first
+      pier = db[:clusters].where(name: cluster_name).first
+      unless pier
+        $stderr.puts "unknown cluster '#{cluster_name}'"
+        return false
+      end
+
+      pier = DockerPier::Pier.new(pier[:pier_uri], name: pier[:name])
+
+      puts <<~EOF
+        export DOCKER_TLS_VERIFY=1
+        export DOCKER_HOST=#{pier.resolved_docker_uri}
+        export DOCKER_CERT_PATH=#{pier.x509_dir}
+        export DOCKER_MACHINE_NAME=#{cluster_name}
+      EOF
+    end
+  end
+
+  mode 'off' do
+    def run
+      puts <<~EOF
+        unset DOCKER_TLS_VERIFY
+        unset DOCKER_HOST
+        unset DOCKER_CERT_PATH
+        unset DOCKER_MACHINE_NAME
+      EOF
+    end
+  end
+
+
+  mode 'hook:install' do
+    def run
+      puts <<~EOF
+        pier ()
+        {
+          local subcommand="$1"
+          case "${subcommand}" in
+          on|off|attach|detach)
+            shift
+            eval "$(command docker-pier "${subcommand}" "$@")"
+            ;;
+          *)
+            command docker-pier "$@"
+            ;;
+          esac
+        }
+      EOF
+    end
+  end
+
+
+  mode 'nodes' do
+    def run
+      cluster_name = ENV['DOCKER_MACHINE_NAME']
+      pier = db[:clusters].where(name: cluster_name).first
+      unless pier
+        $stderr.puts "unknown cluster '#{cluster_name}'"
+        return false
+      end
+      pier = DockerPier::Pier.new(pier[:pier_uri], name: pier[:name])
+
+      pier.nodes.each do |node|
+        puts node.inspect
+      end
+    end
+  end
+
+  mode 'logs' do
+    def run
+      cluster_name = ENV['DOCKER_MACHINE_NAME']
+      pier = db[:clusters].where(name: cluster_name).first
+      unless pier
+        $stderr.puts "unknown cluster '#{cluster_name}'"
+        return false
+      end
+      pier = DockerPier::Pier.new(pier[:pier_uri], name: pier[:name])
+
+      handle_maxlen = 0
+      tty_width = HighLine::SystemExtensions.terminal_size[0]
+
+      pier.logs.stream! do |event|
+        next if event.lines.empty?
+
+        handle_ansi = event.task.name
+        handle_maxlen = [handle_maxlen, handle_ansi.length].max
+        handle_ansi = handle_ansi.rjust(handle_maxlen, ' ')
+        handle_ansi = Paint[handle_ansi, event.task.color]
+
+        time_ansi = Paint[event.time.strftime("%H:%M:%S"), :white]
+
+        ln1_prefix_ansi = "%s %s " % [handle_ansi, time_ansi]
+        lns_indent = ' ' * Paint.unpaint(ln1_prefix_ansi).length
+        lns_color = (event.type == :error) ? :red : :default
+
+        tty_remain = tty_width - lns_indent.length
+        lns = event.lines.dup
+        lns = lns.map{ |ln| ln.gsub(/(.{1,#{tty_remain}})/, "\\1\n").split("\n") }.flatten
+
+        puts ln1_prefix_ansi + Paint[lns.shift, lns_color]
+
+        lns.each do |ln|
+          puts lns_indent + Paint[ln, lns_color]
+        end
+      end
+    end
+  end
+end

data/lib/docker-pier.rb

@@ -0,0 +1,4 @@
+require 'docker-pier/version'
+require 'docker-pier/pier'
+require 'docker-pier/node'
+require 'docker-pier/log-stream'

data/lib/docker-pier/log-stream.rb

@@ -0,0 +1,94 @@
+require 'net/ssh'
+require 'shellwords'
+require 'json'
+require 'paint'
+require 'date'
+require 'ostruct'
+
+require 'docker-pier/log-stream/palette'
+
+class Pathname
+  def to_shell
+    Shellwords.escape(self.to_s)
+  end
+end
+
+class DockerPier::LogStream
+  def initialize(pier)
+    @pier = pier
+    @palette = DockerPier::LogStream::Palette.new
+    @task_colors = Hash.new{ |h,k| h[k] = @palette.draw! }
+  end
+
+  def path
+    @path ||= get_path!
+  end
+
+  def get_path!
+    logs_dir = Pathname.new '/var/log/fluentd'
+    logfile_link = logs_dir + 'docker.log'
+
+    # fluentd creates the symlink with an absolute path from inside a container,
+    # so the dir the link points to is wrong. We assume the logs dir instead.
+    logs_link_dest = Pathname.new(@pier.ssh.exec!("readlink #{logfile_link.to_shell}").chomp)
+    logs_dir + logs_link_dest.basename
+  end
+
+  def parse_log_ln(ln)
+    ts, fluent_source_id, event_json = ln.split(/\s+/, 3)
+
+    ts = DateTime.parse(ts)
+    event = JSON.parse(event_json)
+    event_type = (event.delete('source') == 'stderr') ? :error : :output
+
+    container_id = event.delete('container_name')[1..-1]
+    msg = event.delete('log')
+
+    if msg[0] == '{'
+      msg_parts = JSON.parse(msg)
+      msg_lns = msg_parts.delete('lines').map{ |ln| ln.chomp }
+      msg_parts = OpenStruct.new(msg_parts)
+    else
+      msg_lns = msg.split("\n")
+    end
+
+    service_parts = container_id.match(/^(\w+)\.(\d+)\.(\w+)$/)
+    service = service_parts ? [service_parts[1], service_parts[2].to_i] : nil
+
+    task_handle = service ? ("%s[%02d]" % service) : container_id
+    task_color = @task_colors[task_handle]
+
+    OpenStruct.new(
+      time: ts,
+      type: event_type,
+      service: service,
+      task: OpenStruct.new(name: task_handle, color: task_color),
+      location: [:some_node, container_id],
+      message: msg_parts,
+      lines: msg_lns
+    )
+  end
+
+  def stream!
+    ssh_session = @pier.ssh
+
+    channel = ssh_session.open_channel do |ch|
+  		ch.exec "tail -f #{self.path.to_shell}" do |ch, success|
+        raise "could not tail logs on remote" unless success
+
+        ch.on_data do |_, data|
+          data.split("\n").each do |ln|
+            event = parse_log_ln(ln)
+            yield(event)
+          end
+        end
+      end
+    end
+
+    int_pressed = false
+    trap("INT") { int_pressed = true }
+    ssh_session.loop(0.1) { not int_pressed }
+
+    ssh_session.shutdown!
+  end
+end

data/lib/docker-pier/log-stream/palette.rb

@@ -0,0 +1,164 @@
+class DockerPier::LogStream; end
+
+class DockerPier::LogStream::Palette
+  def initialize
+    @bag = []
+  end
+
+  def draw!
+    if @bag.empty?
+      i = rand(BASE_COLORS.length)
+      @bag = BASE_COLORS[i..-1] + BASE_COLORS[0...i]
+    end
+
+    @bag.shift
+  end
+
+  BASE_COLORS = [
+    [0, 238, 0],
+    [148, 0, 211],
+    [255, 0, 255],
+    [255, 0, 0],
+    [104, 34, 139],
+    [139, 26, 26],
+    [127, 255, 0],
+    [0, 191, 255],
+    [255, 0, 255],
+    [0, 205, 0],
+    [139, 28, 98],
+    [127, 255, 0],
+    [255, 0, 0],
+    [0, 191, 255],
+    [0, 255, 0],
+    [199, 21, 133],
+    [238, 0, 238],
+    [0, 255, 0],
+    [205, 0, 0],
+    [124, 252, 0],
+    [199, 21, 133],
+    [124, 252, 0],
+    [205, 16, 118],
+    [0, 191, 255],
+    [102, 205, 0],
+    [208, 32, 144],
+    [238, 0, 0],
+    [118, 238, 0],
+    [0, 0, 205],
+    [208, 32, 144],
+    [0, 0, 205],
+    [139, 34, 82],
+    [255, 165, 0],
+    [0, 178, 238],
+    [0, 0, 205],
+    [154, 205, 50],
+    [205, 0, 205],
+    [154, 205, 50],
+    [255, 69, 0],
+    [148, 0, 211],
+    [154, 205, 50],
+    [215, 7, 81],
+    [255, 165, 0],
+    [153, 50, 204],
+    [105, 139, 34],
+    [255, 69, 0],
+    [153, 50, 204],
+    [107, 142, 35],
+    [154, 50, 205],
+    [107, 142, 35],
+    [255, 69, 0],
+    [205, 41, 144],
+    [85, 107, 47],
+    [122, 55, 139],
+    [238, 173, 14],
+    [34, 139, 34],
+    [139, 35, 35],
+    [34, 139, 34],
+    [0, 0, 238],
+    [255, 140, 0],
+    [0, 255, 255],
+    [255, 140, 0],
+    [85, 107, 47],
+    [0, 255, 255],
+    [255, 127, 0],
+    [0, 245, 255],
+    [85, 26, 139],
+    [178, 34, 34],
+    [0, 0, 255],
+    [238, 64, 0],
+    [205, 50, 120],
+    [50, 205, 50],
+    [0, 0, 255],
+    [238, 154, 0],
+    [50, 205, 50],
+    [205, 38, 38],
+    [0, 154, 205],
+    [205, 55, 0],
+    [16, 78, 139],
+    [165, 42, 42],
+    [176, 48, 96],
+    [0, 255, 127],
+    [238, 118, 0],
+    [0, 238, 238],
+    [0, 255, 127],
+    [39, 64, 139],
+    [0, 255, 127],
+    [218, 165, 32],
+    [0, 229, 238],
+    [110, 139, 61],
+    [0, 250, 154],
+    [139, 58, 98],
+    [0, 250, 154],
+    [139, 54, 38],
+    [205, 149, 12],
+    [139, 71, 137],
+    [205, 155, 29],
+    [24, 116, 205],
+    [139, 69, 19],
+    [139, 69, 19],
+    [0, 238, 118],
+    [205, 133, 0],
+    [139, 69, 19],
+    [205, 102, 0],
+    [139, 58, 58],
+    [71, 60, 139],
+    [184, 134, 11],
+    [184, 134, 11],
+    [72, 61, 139],
+    [72, 61, 139],
+    [210, 105, 30],
+    [139, 62, 47],
+    [0, 206, 209],
+    [0, 206, 209],
+    [205, 102, 29],
+    [139, 105, 20],
+    [125, 38, 205],
+    [0, 205, 102],
+    [0, 205, 205],
+    [0, 197, 205],
+    [139, 71, 93],
+    [139, 71, 38],
+    [84, 139, 84],
+    [70, 130, 180],
+    [70, 130, 180],
+    [54, 100, 139],
+    [160, 82, 45],
+    [46, 139, 87],
+    [46, 139, 87],
+    [46, 139, 87],
+    [60, 179, 113],
+    [60, 179, 113],
+    [139, 76, 57],
+    [139, 90, 43],
+    [93, 71, 139],
+    [32, 178, 170],
+    [32, 178, 170],
+    [139, 87, 66],
+    [74, 112, 139],
+    [69, 139, 116],
+    [139, 115, 85],
+    [95, 158, 160],
+    [95, 158, 160],
+    [82, 139, 139],
+    [83, 134, 139]
+  ]
+end

data/lib/docker-pier/node.rb

@@ -0,0 +1,20 @@
+require 'docker-pier/version'
+require 'fog/libvirt'
+require 'docker/swarm'
+require 'json'
+
+class DockerPier::Node < SimpleDelegator
+	def initialize(docker_node, pier)
+		@docker_node = docker_node
+		@pier = pier
+		super @docker_node
+	end
+
+	def libvirt_node
+		@libvirt_node ||= (@pier.libvirt.servers.all(name: @docker_node.info['Description']['Hostname']).first rescue nil)
+	end
+
+	def inspect
+		"#<DockerPier::Node %s/%s>" % [@pier.name, @docker_node.info['Description']['Hostname']]
+	end
+end

data/lib/docker-pier/pier.rb

@@ -0,0 +1,102 @@
+require 'docker-pier/version'
+require 'docker'
+require 'docker/swarm'
+require 'fog/libvirt'
+require 'net/ssh'
+require 'net/scp'
+require 'resolv'
+require 'pathname'
+
+class DockerPier::Pier
+  def self.current
+    @current ||= self.new(ENV['PIER'])
+  end
+
+  def initialize(pier_uri, opts = {})
+    @name = opts.delete(:name) || ENV['DOCKER_MACHINE_NAME'] || Digest::SHA1.hexdigest(pier_uri)
+
+    pier_uri = URI.parse(pier_uri.to_s) unless pier_uri.kind_of?(URI)
+
+    @libvirt_uri = pier_uri.dup.tap do |uri|
+      uri.scheme = 'qemu+ssh'
+      uri.path = '/system'
+      uri.query = 'socket=/var/run/libvirt/libvirt-sock'
+    end
+
+    @docker_uri = pier_uri.dup.tap do |uri|
+      uri.scheme = 'tcp'
+      uri.user = nil
+      uri.port = 2376
+      uri.path = '/'
+    end
+
+    @ssh_uri = pier_uri.dup.tap do |uri|
+      uri.scheme = 'ssh'
+      uri.port = 22
+      uri.path = '/'
+    end
+  end
+
+  attr_reader :name
+  attr_reader :libvirt_uri
+  attr_reader :docker_uri
+  attr_reader :ssh_uri
+
+
+  def x509_dir
+    Pathname.new(ENV['HOME']) + '.docker-pier' + 'x509' + @name
+  end
+
+  def resolved_docker_uri
+    @docker_uri.dup.tap{ |u| u.host = Resolv.getaddress(u.host) }
+  end
+
+
+  def libvirt
+    @libvirt ||= Fog::Compute.new(provider: "Libvirt", libvirt_uri: @libvirt_uri.to_s)
+  end
+
+  def docker
+    @docker ||= Docker::Connection.new(self.resolved_docker_uri.to_s,
+      scheme: "https",
+      ssl_ca_file: (self.x509_dir + "ca.pem").to_s,
+      client_cert: (self.x509_dir + "cert.pem").to_s,
+      client_key: (self.x509_dir + "key.pem").to_s
+    )
+  end
+
+  def ssh
+    @ssh ||= Net::SSH.start(@ssh_uri.hostname, @ssh_uri.user, password: @ssh_uri.password)
+  end
+
+
+  def bootstrap!
+    own_hostname = `hostname -f`.chomp
+    remote_export_path = Pathname.new('/var/lib/private-x509/clients') + "#{own_hostname}.tar"
+
+    self.ssh.exec!(<<~EOF)
+      if [ ! -f '#{remote_export_path}' ]; then
+        /var/lib/private-x509/gen_bundle '#{own_hostname}'
+      fi
+    EOF
+
+    local_export_path = self.x509_dir + 'export.tar'
+
+    self.x509_dir.mkpath
+    Dir.chdir(self.x509_dir.to_s) do
+      self.ssh.scp.download! remote_export_path.to_s, local_export_path.to_s
+      system 'tar', '-x', '-f', local_export_path.to_s
+      local_export_path.unlink
+    end
+  end
+
+
+  def nodes
+    docker_nodes = Docker::Swarm::Node.all({}, self.docker)
+    docker_nodes.map{ |d| DockerPier::Node.new(d, self) }
+  end
+
+  def logs
+    DockerPier::LogStream.new(self)
+  end
+end

data/lib/docker-pier/version.rb

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

data/lib/docker/swarm.rb

@@ -0,0 +1,18 @@
+class Docker::Swarm; end
+
+require 'docker/swarm/node'
+require 'docker/swarm/service'
+require 'docker/swarm/task'
+
+# This class represents a Docker Swarm.
+class Docker::Swarm
+  include Docker::Base
+
+  class << self
+    def get(opts = {}, conn = Docker.connection)
+      swarm_json = conn.get("/swarm", opts)
+      hash = Docker::Util.parse_json(swarm_json) || {}
+      new(conn, hash)
+    end
+  end
+end

data/lib/docker/swarm/node.rb

@@ -0,0 +1,26 @@
+require 'json'
+
+# This class represents a Docker Swarm Node.
+class Docker::Swarm::Node
+  include Docker::Base
+
+  class << self
+    def get(id, opts = {}, conn = Docker.connection)
+      node_json = conn.get("/nodes/#{URI.encode(id)}", opts)
+      hash = Docker::Util.parse_json(node_json) || {}
+      new(conn, hash)
+    end
+
+    def by_name(node_name, opts = {}, conn = Docker.connection)
+      opts = opts.merge(filters: {"name" => [node_name]}.to_json)
+      hashes = Docker::Util.parse_json(conn.get('/nodes', opts)) || []
+      hash = hashes.first
+      new(conn, hash) if hash
+    end
+
+    def all(opts = {}, conn = Docker.connection)
+      hashes = Docker::Util.parse_json(conn.get('/nodes', opts)) || []
+      hashes.map { |hash| new(conn, hash) }
+    end
+  end
+end

data/lib/docker/swarm/service.rb

@@ -0,0 +1,17 @@
+# This class represents a Docker Swarm Service.
+class Docker::Swarm::Service
+  include Docker::Base
+
+  class << self
+    def get(id, opts = {}, conn = Docker.connection)
+      service_json = conn.get("/services/#{URI.encode(id)}", opts)
+      hash = Docker::Util.parse_json(service_json) || {}
+      new(conn, hash)
+    end
+
+    def all(opts = {}, conn = Docker.connection)
+      hashes = Docker::Util.parse_json(conn.get('/services', opts)) || []
+      hashes.map { |hash| new(conn, hash) }
+    end
+  end
+end

data/lib/docker/swarm/task.rb

@@ -0,0 +1,33 @@
+# This class represents a Docker Swarm Task.
+class Docker::Swarm::Task
+  include Docker::Base
+
+  def service
+    Docker::Service.get(self.info["ServiceID"])
+  end
+
+  def node
+    Docker::Node.get(self.info["NodeID"])
+  end
+
+  def state
+    self.info['Status']['State'].intern
+  end
+
+  def running?
+    self.state == :running
+  end
+
+  class << self
+    def get(id, opts = {}, conn = Docker.connection)
+      task_json = conn.get("/tasks/#{URI.encode(id)}", opts)
+      hash = Docker::Util.parse_json(task_json) || {}
+      new(conn, hash)
+    end
+
+    def all(opts = {}, conn = Docker.connection)
+      hashes = Docker::Util.parse_json(conn.get('/tasks', opts)) || []
+      hashes.map { |hash| new(conn, hash) }
+    end
+  end
+end

metadata

@@ -0,0 +1,274 @@
+--- !ruby/object:Gem::Specification
+name: docker-pier
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Levi Aul
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: fog-libvirt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.32'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.32.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.32'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.32.1
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: net-scp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.8
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.4
+- !ruby/object:Gem::Dependency
+  name: main
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.2.1
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.39'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.39'
+- !ruby/object:Gem::Dependency
+  name: amalgalite
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: color
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: paint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+description: 
+email:
+- levi@leviaul.com
+executables:
+- docker-pier
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docker-pier.gemspec
+- exe/docker-pier
+- lib/docker-pier.rb
+- lib/docker-pier/log-stream.rb
+- lib/docker-pier/log-stream/palette.rb
+- lib/docker-pier/node.rb
+- lib/docker-pier/pier.rb
+- lib/docker-pier/version.rb
+- lib/docker/swarm.rb
+- lib/docker/swarm/node.rb
+- lib/docker/swarm/service.rb
+- lib/docker/swarm/task.rb
+homepage: https://github.com/tsutsu/docker-pier
+licenses: []
+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.5.1
+signing_key: 
+specification_version: 4
+summary: An alternative Docker client for dedicated Docker Swarm clusters
+test_files: []