rory-deploy 1.8.4.1

data/spec/docker_server_group_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+require 'centurion/docker_server'
+require 'centurion/docker_server_group'
+
+describe Centurion::DockerServerGroup do
+  let(:docker_path) { 'docker' }
+  let(:group) { Centurion::DockerServerGroup.new(['host1', 'host2'], docker_path) }
+
+  it 'takes a hostlist and instantiates DockerServers' do
+    expect(group.hosts.length).to equal(2)
+    expect(group.hosts.first).to be_a(Centurion::DockerServer)
+    expect(group.hosts.last).to be_a(Centurion::DockerServer)
+  end
+
+  it 'implements Enumerable' do
+    expect(group.methods).to be_a_kind_of(Enumerable)
+  end
+
+  it 'prints a friendly message to stderr when iterating' do
+    expect(group).to receive(:info).with(/Connecting to Docker on host[0-9]/).twice
+
+    group.each { |host| }
+  end
+
+  it 'can run parallel operations' do
+    item = double('item', dummy_method: true)
+    expect(item).to receive(:dummy_method).twice
+
+    expect { group.each_in_parallel { |host| item.dummy_method } }.not_to raise_error
+  end
+end

data/spec/docker_server_spec.rb

@@ -0,0 +1,92 @@
+require 'spec_helper'
+require 'centurion/docker_server'
+
+describe Centurion::DockerServer do
+  let(:host)   { 'host1' }
+  let(:docker_path) { 'docker' }
+  let(:server) { Centurion::DockerServer.new(host, docker_path) }
+  let(:container) {
+     {
+       'Command' => '/bin/bash',
+       'Created' => 1414797234,
+       'Id'      => '28970c706db0f69716af43527ed926acbd82581e1cef5e4e6ff152fce1b79972',
+       'Image'   => 'centurion-test:latest',
+       'Names'   => ['/centurion-783aac48378283'],
+       'Ports'   => [{'PrivatePort'=>80, 'Type'=>'tcp', 'IP'=>'0.0.0.0', 'PublicPort'=>23235}],
+       'Status'  => 'Up 3 days'
+     }
+  }
+  let(:ps)     { [ container, {}, nil ] }
+
+  it 'knows its hostname' do
+    expect(server.hostname).to eq('host1')
+  end
+
+  it 'knows its port' do
+    expect(server.port).to eq('2375')
+  end
+
+  describe 'when host includes a port' do
+    let(:host) { 'host2:4321' }
+    it 'knows that port' do
+      expect(server.port).to eq('4321')
+    end
+  end
+
+  { docker_via_api: [:create_container, :inspect_container, :inspect_image,
+                     :ps, :start_container, :stop_container],
+    docker_via_cli: [:pull, :tail] }.each do |delegate, methods|
+    methods.each do |method|
+      it "delegates '#{method}' to #{delegate}" do
+        dummy_result = double
+        dummy_delegate = double(method => dummy_result)
+        allow(server).to receive(delegate).and_return(dummy_delegate)
+        expect(dummy_delegate).to receive(method)
+        expect(server.send(method)).to be(dummy_result)
+      end
+    end
+  end
+
+  it 'returns tags associated with an image' do
+    image_names = %w[target:latest target:production other:latest]
+    allow(server).to receive(:ps).and_return(image_names.map {|name| { 'Image' => name } })
+    expect(server.current_tags_for('target')).to eq(%w[latest production])
+  end
+
+  context 'finding containers' do
+    before do
+      allow(server).to receive(:ps).and_return(ps)
+    end
+
+    it 'finds containers by port' do
+      expect(server.find_containers_by_public_port(23235, 'tcp')).to eq([container])
+    end
+
+    it 'only returns correct matches by port' do
+      expect(server.find_containers_by_public_port(1234, 'tcp')).to be_empty
+    end
+
+    it 'finds containers by name' do
+      expect(server.find_containers_by_name('centurion')).to eq([container])
+    end
+
+    it 'only returns correct matches by name' do
+      expect(server.find_containers_by_name('fbomb')).to be_empty
+    end
+  end
+
+  context 'finding old containers' do
+    it 'finds stopped containers for the given service name' do
+      inspected_containers =
+        [
+            {"Id" => "123", "Names" => ["/centurion-1234567890abcd"], "Status" => "Exit 0"},
+            {"Id" => "456", "Names" => ["/centurion-2234567890abcd"], "Status" => "Running blah blah"},
+            {"Id" => "789", "Names" => ["/centurion-3234567890abcd"], "Status" => "Exited 1 mins ago"},
+            {"Id" => "918", "Names" => ["/fbomb-3234567890abcd"], "Status" => "Exited 1 mins ago"},
+        ]
+      allow(server).to receive(:ps).and_return(inspected_containers)
+
+      expect(server.old_containers_for_name('centurion').map { |c| c['Id'] }).to eq(["123", "789"])
+    end
+  end
+end

data/spec/docker_via_api_spec.rb

@@ -0,0 +1,246 @@
+require 'spec_helper'
+require 'centurion/docker_via_api'
+
+describe Centurion::DockerViaApi do
+  let(:hostname) { 'example.com' }
+  let(:port) { '2375' }
+  let(:api_version) { '1.12' }
+  let(:json_string) { '[{ "Hello": "World" }]' }
+  let(:json_value) { JSON.load(json_string) }
+
+  context 'without TLS certificates' do
+    let(:excon_uri) { "http://#{hostname}:#{port}/" }
+    let(:api) { Centurion::DockerViaApi.new(hostname, port) }
+
+    it 'lists processes' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/containers/json", {}).
+                       and_return(double(body: json_string, status: 200))
+      expect(api.ps).to eq(json_value)
+    end
+
+    it 'lists all processes' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/containers/json?all=1", {}).
+                       and_return(double(body: json_string, status: 200))
+      expect(api.ps(all: true)).to eq(json_value)
+    end
+
+    it 'creates a container' do
+      configuration_as_json = double
+      configuration = double(to_json: configuration_as_json)
+      expect(Excon).to receive(:post).
+                           with(excon_uri + "v1.12" + "/containers/create",
+                                query: nil,
+                                body: configuration_as_json,
+                                headers: {'Content-Type' => 'application/json'}).
+                           and_return(double(body: json_string, status: 201))
+      api.create_container(configuration)
+    end
+
+    it 'creates a container with a name' do
+      configuration_as_json = double
+      configuration = double(to_json: configuration_as_json)
+      expect(Excon).to receive(:post).
+                           with(excon_uri + "v1.12" + "/containers/create",
+                                query: { name: match(/^app1-[a-f0-9]+$/) },
+                                body: configuration_as_json,
+                                headers: {'Content-Type' => 'application/json'}).
+                           and_return(double(body: json_string, status: 201))
+      api.create_container(configuration, 'app1')
+    end
+
+    it 'starts a container' do
+      configuration_as_json = double
+      configuration = double(to_json: configuration_as_json)
+      expect(Excon).to receive(:post).
+                           with(excon_uri + "v1.12" + "/containers/12345/start",
+                                body: configuration_as_json,
+                                headers: {'Content-Type' => 'application/json'}).
+                           and_return(double(body: json_string, status: 204))
+      api.start_container('12345', configuration)
+    end
+
+    it 'stops a container' do
+      expect(Excon).to receive(:post).
+                       with(excon_uri + "v1.12" + "/containers/12345/stop?t=300", {}).
+                       and_return(double(status: 204))
+      api.stop_container('12345', 300)
+    end
+
+    it 'stops a container with a custom timeout' do
+      expect(Excon).to receive(:post).
+                       with(excon_uri + "v1.12" + "/containers/12345/stop?t=30", {}).
+                       and_return(double(status: 204))
+      api.stop_container('12345')
+    end
+
+    it 'restarts a container' do
+      expect(Excon).to receive(:post).
+                          with(excon_uri + "v1.12" + "/containers/12345/restart?t=30", {}).
+                          and_return(double(body: json_string, status: 204))
+      api.restart_container('12345')
+    end
+
+    it 'restarts a container with a custom timeout' do
+      expect(Excon).to receive(:post).
+                          with(excon_uri + "v1.12" + "/containers/12345/restart?t=300", {}).
+                          and_return(double(body: json_string, status: 204))
+      api.restart_container('12345', 300)
+    end
+
+    it 'inspects a container' do
+      expect(Excon).to receive(:get).
+                           with(excon_uri + "v1.12" + "/containers/12345/json", {}).
+                           and_return(double(body: json_string, status: 200))
+      expect(api.inspect_container('12345')).to eq(json_value)
+    end
+
+    it 'removes a container' do
+      expect(Excon).to receive(:delete).
+                           with(excon_uri + "v1.12" + "/containers/12345", {}).
+                           and_return(double(status: 204))
+      expect(api.remove_container('12345')).to eq(true)
+    end
+
+    it 'inspects an image' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/images/foo:bar/json",
+                            headers: {'Accept' => 'application/json'}).
+                       and_return(double(body: json_string, status: 200))
+      expect(api.inspect_image('foo', 'bar')).to eq(json_value)
+    end
+
+  end
+
+  context 'with TLS certificates' do
+    let(:excon_uri) { "https://#{hostname}:#{port}/" }
+    let(:tls_args)  { { tls: true, tlscacert: '/certs/ca.pem',
+                       tlscert: '/certs/cert.pem', tlskey: '/certs/key.pem' } }
+    let(:api)       { Centurion::DockerViaApi.new(hostname, port, tls_args) }
+
+    it 'lists processes' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/containers/json",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                       and_return(double(body: json_string, status: 200))
+      expect(api.ps).to eq(json_value)
+    end
+
+    it 'lists all processes' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/containers/json?all=1",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                       and_return(double(body: json_string, status: 200))
+      expect(api.ps(all: true)).to eq(json_value)
+    end
+
+    it 'inspects an image' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/images/foo:bar/json",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem',
+                            headers: {'Accept' => 'application/json'}).
+                       and_return(double(body: json_string, status: 200))
+      expect(api.inspect_image('foo', 'bar')).to eq(json_value)
+    end
+
+    it 'creates a container' do
+      configuration_as_json = double
+      configuration = double(to_json: configuration_as_json)
+      expect(Excon).to receive(:post).
+                           with(excon_uri + "v1.12" + "/containers/create",
+                                client_cert: '/certs/cert.pem',
+                                client_key: '/certs/key.pem',
+                                query: nil,
+                                body: configuration_as_json,
+                                headers: {'Content-Type' => 'application/json'}).
+                           and_return(double(body: json_string, status: 201))
+      api.create_container(configuration)
+    end
+
+    it 'starts a container' do
+      configuration_as_json = double
+      configuration = double(to_json: configuration_as_json)
+      expect(Excon).to receive(:post).
+                           with(excon_uri + "v1.12" + "/containers/12345/start",
+                                client_cert: '/certs/cert.pem',
+                                client_key: '/certs/key.pem',
+                                body: configuration_as_json,
+                                headers: {'Content-Type' => 'application/json'}).
+                           and_return(double(body: json_string, status: 204))
+      api.start_container('12345', configuration)
+    end
+
+    it 'stops a container' do
+      expect(Excon).to receive(:post).
+                       with(excon_uri + "v1.12" + "/containers/12345/stop?t=300",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                       and_return(double(status: 204))
+      api.stop_container('12345', 300)
+    end
+
+    it 'stops a container with a custom timeout' do
+      expect(Excon).to receive(:post).
+                       with(excon_uri + "v1.12" + "/containers/12345/stop?t=30",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                       and_return(double(status: 204))
+      api.stop_container('12345')
+    end
+
+    it 'restarts a container' do
+      expect(Excon).to receive(:post).
+                        with(excon_uri + "v1.12" + "/containers/12345/restart?t=30",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                        and_return(double(body: json_string, status: 204))
+      api.restart_container('12345')
+    end
+
+    it 'restarts a container with a custom timeout' do
+      expect(Excon).to receive(:post).
+                        with(excon_uri + "v1.12" + "/containers/12345/restart?t=300",
+                            client_cert: '/certs/cert.pem',
+                            client_key: '/certs/key.pem').
+                        and_return(double(body: json_string, status: 204))
+      api.restart_container('12345', 300)
+    end
+
+    it 'inspects a container' do
+      expect(Excon).to receive(:get).
+                           with(excon_uri + "v1.12" + "/containers/12345/json",
+                                client_cert: '/certs/cert.pem',
+                                client_key: '/certs/key.pem').
+                           and_return(double(body: json_string, status: 200))
+      expect(api.inspect_container('12345')).to eq(json_value)
+    end
+
+    it 'removes a container' do
+      expect(Excon).to receive(:delete).
+                           with(excon_uri + "v1.12" + "/containers/12345",
+                                client_cert: '/certs/cert.pem',
+                                client_key: '/certs/key.pem').
+                           and_return(double(status: 204))
+      expect(api.remove_container('12345')).to eq(true)
+    end
+  end
+
+   context 'with default TLS certificates' do
+    let(:excon_uri) { "https://#{hostname}:#{port}/" }
+    let(:tls_args)  { { tls: true } }
+    let(:api)       { Centurion::DockerViaApi.new(hostname, port, tls_args) }
+
+    it 'lists processes' do
+      expect(Excon).to receive(:get).
+                       with(excon_uri + "v1.12" + "/containers/json",
+                            client_cert: File.expand_path('~/.docker/cert.pem'),
+                            client_key: File.expand_path('~/.docker/key.pem')).
+                       and_return(double(body: json_string, status: 200))
+      expect(api.ps).to eq(json_value)
+    end
+  end
+end

data/spec/docker_via_cli_spec.rb

@@ -0,0 +1,91 @@
+require 'spec_helper'
+require 'centurion/docker_via_cli'
+
+describe Centurion::DockerViaCli do
+  let(:docker_path) { 'docker' }
+
+  context 'without TLS certificates' do
+    let(:docker_via_cli) { Centurion::DockerViaCli.new('host1', 2375, docker_path) }
+    it 'pulls the latest image given its name' do
+      expect(Centurion::Shell).to receive(:echo).
+                                with("docker -H=tcp://host1:2375 pull foo:latest")
+      docker_via_cli.pull('foo')
+    end
+
+    it 'pulls an image given its name & tag' do
+      expect(Centurion::Shell).to receive(:echo).
+                                with("docker -H=tcp://host1:2375 pull foo:bar")
+      docker_via_cli.pull('foo', 'bar')
+    end
+
+    it 'tails logs on a container' do
+      id = '12345abcdef'
+      expect(Centurion::Shell).to receive(:echo).
+                                with("docker -H=tcp://host1:2375 logs -f #{id}")
+      docker_via_cli.tail(id)
+    end
+
+    it 'should print all chars when one thread is running' do
+      expect(Centurion::Shell).to receive(:run_with_echo)
+
+      allow(Thread).to receive(:list) {[double(status: 'run')]}
+
+      docker_via_cli.pull('foo')
+    end
+
+    it 'should only print lines when multiple threads are running' do
+      expect(Centurion::Shell).to receive(:run_without_echo)
+
+      allow(Thread).to receive(:list) {[double(status: 'run'), double(status: 'run')]}
+
+      docker_via_cli.pull('foo')
+    end
+  end
+  context 'with TLS certificates' do
+    let(:tls_args) { { tls: true, tlscacert: '/certs/ca.pem',
+                       tlscert: '/certs/cert.pem', tlskey: '/certs/key.pem' } }
+    let(:docker_via_cli) { Centurion::DockerViaCli.new('host1', 2375,
+                                                       docker_path, tls_args) }
+    it 'pulls the latest image given its name' do
+      expect(Centurion::Shell).to receive(:echo).
+                                with('docker -H=tcp://host1:2375 ' \
+                                     '--tlsverify ' \
+                                     '--tlscacert=/certs/ca.pem ' \
+                                     '--tlscert=/certs/cert.pem ' \
+                                     '--tlskey=/certs/key.pem pull foo:latest')
+      docker_via_cli.pull('foo')
+    end
+
+    it 'pulls an image given its name & tag' do
+      expect(Centurion::Shell).to receive(:echo).
+                                with('docker -H=tcp://host1:2375 ' \
+                                     '--tlsverify ' \
+                                     '--tlscacert=/certs/ca.pem ' \
+                                     '--tlscert=/certs/cert.pem ' \
+                                     '--tlskey=/certs/key.pem pull foo:bar')
+      docker_via_cli.pull('foo', 'bar')
+    end
+
+    it 'tails logs on a container' do
+      id = '12345abcdef'
+      expect(Centurion::Shell).to receive(:echo).
+                                with('docker -H=tcp://host1:2375 ' \
+                                     '--tlsverify ' \
+                                     '--tlscacert=/certs/ca.pem ' \
+                                     '--tlscert=/certs/cert.pem ' \
+                                     "--tlskey=/certs/key.pem logs -f #{id}")
+      docker_via_cli.tail(id)
+    end
+
+    it 'attach to a container' do
+      id = '12345abcdef'
+      expect(Centurion::Shell).to receive(:echo).
+                                with('docker -H=tcp://host1:2375 ' \
+                                     '--tlsverify ' \
+                                     '--tlscacert=/certs/ca.pem ' \
+                                     '--tlscert=/certs/cert.pem ' \
+                                     "--tlskey=/certs/key.pem attach #{id}")
+      docker_via_cli.attach(id)
+    end
+  end
+end