infopen-docker 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 94ca42d731e85d57fc86dc7447df2d4378fd2ebb
+  data.tar.gz: efcb13e191ab8baab287f4823e6347597470898d
+SHA512:
+  metadata.gz: 567575d1a903d37e6e3ca8d0ae99b44c2a3b76bbbed9e344af7a524e1e9a674c9d5af3450931b19883bfb2add1f5b7abdaae17d2eea5197032698adc4915466b
+  data.tar.gz: 9f2018241d4bb0255f203e65a7e67ff9b03ecb1ccc2d3d6f62fafaa6879937124dffc31cae07e0c8f9c61bfc078158591125969c99c91cee560dc05a91385727

data/lib/docker/lifecycle.rb

@@ -0,0 +1,72 @@
+##
+# This module contains tests about docker images and containers lifecycle
+
+module Infopen::Docker::Lifecycle
+
+    require 'docker'
+    include Infopen::Docker::Error
+
+
+    ##
+    # Remove image and its containers.
+    #
+    # Raise an ArgumentError if bad param number
+    #
+    # Raise an Infopen::Docker::ArgumentError if param is not a
+    # Docker::Image instance
+    #
+    # Raise an Infopen::Docker::ImageError if image not exists
+
+    def self.remove_image_and_its_containers(image_obj)
+
+        # Check param
+        unless image_obj.is_a?(Docker::Image)
+            raise ArgumentError, "Expected a Docker::Image, got: #{image_obj}."
+        end
+
+        # Get and remove all containers linked to image
+        get_containers_from_image_id(image_obj.id).each do |container|
+            Docker::Container.get(container.id).remove(:force => true)
+        end
+
+        # Remove image
+        image_obj.remove(:force => true)
+    end
+
+
+    ##
+    # Get all containers created with image id param.
+    #
+    # It's a private module method.
+    #
+    # Raise an ArgumentError if bad param number
+    #
+    # Raise an Infopen::Docker::ArgumentError if param is not a
+    # Docker::Image instance
+    #
+    # Raise an Infopen::Docker::ImageError if image not exists
+
+    def self.get_containers_from_image_id (image_id)
+
+        # Check param type
+        unless image_id.is_a?(String) and image_id.length != 0
+            raise ArgumentError, "Expected not empty string, got: #{image_id}."
+        end
+
+        # Check image is valid
+        begin
+            image = Docker::Image.get(image_id)
+        rescue Docker::Error::NotFoundError
+            raise ImageError, "Image #{image_id} not exists."
+        end
+
+        Docker::Container.all(:all => true).select { |container|
+            container
+                .info['Image']
+                .start_with?(image.id)
+        }
+    end
+    private_class_method :get_containers_from_image_id
+
+end
+

data/lib/errors/errors.rb

@@ -0,0 +1,22 @@
+##
+# This module reference error classes for this gem
+
+module Infopen::Docker::Error
+
+    ##
+    # Default error, not raised but can be used to catch gem specific errors
+
+    class InfopenDockerError < StandardError; end
+
+    ##
+    # Used in case of methods argument errors
+
+    class ArgumentError < InfopenDockerError; end
+
+    ##
+    # Used if docker image not exists
+
+    class ImageError < InfopenDockerError; end
+
+end
+

data/lib/infopen-docker.rb

@@ -0,0 +1,12 @@
+# This module manage common docker tasks
+
+module Infopen
+
+    module Infopen::Docker
+
+        require 'errors/errors'
+        require 'docker/lifecycle'
+    end
+
+end
+

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: infopen-docker
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Alexandre Chaussier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: docker-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.24'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.24.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.24'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.24.0
+description: Used to add common functions for Dockerfile tests
+email: a.chaussier@infopen.pro
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/docker/lifecycle.rb
+- lib/errors/errors.rb
+- lib/infopen-docker.rb
+homepage: https://github.com/infOpen/ruby-gem-infopen-docker
+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: Docker common functions
+test_files: []