train 3.8.9 → 3.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba990081a6ccfd78a6762b5685f7a22abfb252823f2fd185b942840450943243
-  data.tar.gz: 965ea4c81f9bb0fd0268f9d60cff8de1c1cd65ec89254a0bbbe8e6938cf85893
+  metadata.gz: 7efd89c593b5d3676a3aaa39b6df6138181bc729d14e6e4fa71bda99013a83fe
+  data.tar.gz: db07f812a1bc3a15702b96977390dd2bd36da3f16607df1af8e348166e3b7b3d
 SHA512:
-  metadata.gz: bebfde45aff5cafec1a39fa25aa63b429ad092911276beeed1f3ef0a3bceb3d50baa563ff52cfde417a1556b19d23f40eb97348c6c01d31aba83747fc2819284
-  data.tar.gz: 8514f25925c060845e2e62dd73733b7d8fe03aea00e67c551067e99f4fd1388d50926bedc2fb8f2125541ecc93599562dafe276bbd4f1c32def1a73655c03f12
+  metadata.gz: 941b825ff06fc1766b53387cb1d7d27e72fd069e891147a13c6a89535b371488082a0f461ffd0fdd63078ea3308d52c7d0fee2566a6dcbc3c02f4d38a8e7984a
+  data.tar.gz: 2bb1ba30867b74b6d329ed41b2a8c3f5981259044758cda8e58749e5ddc2e41db3ead3bab682b8711fe4dcb4f8dd5fede9a6ae4d4356c2ebaf065b3640986867

data/lib/train/transports/docker.rb

@@ -83,6 +83,17 @@ class Train::Transports::Docker
       end
     end
 
+    def unique_identifier
+      uuid = @container.nil? ? @id : @container.id # default uuid set to the docker host.
+      unless sniff_for_windows?
+        cmd = run_command_via_connection("head -1 /proc/self/cgroup|cut -d/ -f3") if file("/proc/self/cgroup").exist?
+        unless cmd.stdout.empty?
+          uuid = cmd.stdout.strip
+        end
+      end
+      uuid
+    end
+
     private
 
     def file_via_connection(path)

data/lib/train/transports/podman.rb

@@ -0,0 +1,157 @@
+require "docker"
+require "train/plugins"
+
+module Train::Transports
+  class Podman < Train.plugin(1)
+
+    name "podman"
+
+    include_options Train::Extras::CommandWrapper
+    option :host, required: true
+    option :podman_url, required: false
+
+    def connection(state = {}, &block)
+      opts = merge_options(options, state || {})
+
+      validate_options(opts)
+
+      if @connection && @connection_options == opts
+        reuse_connection(&block)
+      else
+        create_new_connection(opts, &block)
+      end
+    end
+
+    private
+
+    # Creates a new Podman connection instance and save it for potential future
+    # reuse.
+    #
+    # @param options [Hash] connection options
+    # @return [Podman::Connection] a Podman connection instance
+    # @api private
+    def create_new_connection(options, &block)
+      if @connection
+        logger.debug("[Podman] shutting previous connection #{@connection}")
+        @connection.close
+      end
+
+      @connection_options = options
+      @connection = Connection.new(options, &block)
+    end
+
+    # Return the last saved Podman connection instance.
+    #
+    # @return [Podman::Connection] a Podman connection instance
+    # @api private
+    def reuse_connection
+      logger.debug("[Podman] reusing existing connection #{@connection}")
+      yield @connection if block_given?
+      @connection
+    end
+  end
+
+  class Train::Transports::Podman
+    class Connection < BaseConnection
+      def initialize(options)
+        super(options)
+
+        @id = options[:host]
+
+        if RUBY_PLATFORM =~ /windows|mswin|msys|mingw|cygwin/
+          raise "Unsupported host platform."
+        end
+
+        # Currently Podman url can be set using option and setting the environment variable.
+        uid = Process.uid
+        podman_url = options[:podman_url] || ENV["CONTAINER_HOST"]
+        podman_url ||= "unix:///run/podman/podman.sock" if uid == 0
+        podman_url ||= "unix:///run/user/#{uid}/podman/podman.sock"
+
+        Docker.url = podman_url
+
+        # Using docker-api ruby library to fetch the Podman container data.
+        @container = ::Docker::Container.get(@id) ||
+          raise("Can't find Podman container #{@id}")
+        @cmd_wrapper = nil
+        @cmd_wrapper = CommandWrapper.load(self, @options)
+        @probably_windows = nil
+      rescue Excon::Error::Socket
+        raise Train::TransportError, "Unable to connect to Podman using #{podman_url}"
+      rescue Docker::Error::NotFoundError => e
+        raise Train::TransportError, "Container Not Found: #{e.message}"
+      rescue Docker::Error::ServerError => e
+        raise Train::TransportError, "#{e.message}"
+      end
+
+      def close
+        # nothing to do at the moment
+      end
+
+      def uri
+        if @container.nil?
+          "podman://#{@id}"
+        else
+          "podman://#{@container.id}"
+        end
+      end
+
+      def unique_identifier
+        @container.nil? ? @id : @container.id # default uuid set to the podman host.
+      end
+
+      private
+
+      def file_via_connection(path)
+        if os.aix?
+          Train::File::Remote::Aix.new(self, path)
+        elsif os.solaris?
+          Train::File::Remote::Unix.new(self, path)
+        elsif os.windows?
+          Train::File::Remote::Windows.new(self, path)
+        else
+          Train::File::Remote::Linux.new(self, path)
+        end
+      end
+
+      def run_command_via_connection(cmd, &_data_handler)
+        cmd = @cmd_wrapper.run(cmd) unless @cmd_wrapper.nil?
+
+        # Cannot use os.windows? here because it calls run_command_via_connection,
+        # causing infinite recursion during initial platform detection
+        if sniff_for_windows?
+          invocation = cmd_run_command(cmd)
+        else
+          invocation = sh_run_command(cmd)
+        end
+        stdout, stderr, exit_status = @container.exec(
+          invocation, user: @options[:user]
+        )
+        CommandResult.new(stdout.join, stderr.join, exit_status)
+      rescue ::Docker::Error::DockerError => _
+        raise
+      rescue => _
+        # @TODO: differentiate any other error
+        raise
+      end
+
+      def sh_run_command(cmd)
+        ["/bin/sh", "-c", cmd]
+      end
+
+      def cmd_run_command(cmd)
+        ["cmd.exe", "/s", "/c", cmd]
+      end
+
+      def sniff_for_windows?
+        return @probably_windows unless @probably_windows.nil?
+
+        # Run a command using /bin/sh, which should fail under Windows
+        stdout, _stderr, _exit_status = @container.exec(
+          sh_run_command("true"), user: @options[:user]
+        )
+        @probably_windows = !!stdout.detect { |l| l.include? "failure in a Windows system call" }
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: train
 version: !ruby/object:Gem::Version
-  version: 3.8.9
+  version: 3.10.1
 platform: ruby
 authors:
 - Chef InSpec Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-09 00:00:00.000000000 Z
+date: 2022-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: train-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.8.9
+        version: 3.10.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 3.8.9
+        version: 3.10.1
 - !ruby/object:Gem::Dependency
   name: train-winrm
   requirement: !ruby/object:Gem::Requirement
@@ -213,6 +213,7 @@ files:
 - lib/train/transports/helpers/azure/file_parser.rb
 - lib/train/transports/helpers/azure/subscription_id_file_parser.rb
 - lib/train/transports/helpers/azure/subscription_number_file_parser.rb
+- lib/train/transports/podman.rb
 - lib/train/transports/vmware.rb
 homepage: 
 licenses:
@@ -230,7 +231,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="