docker-engine-ruby 0.7.2 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cff37aa30011a27df0c003775bfcdad05a655e1d4fcc5e537a9e3d802211caa6
-  data.tar.gz: 80e03ef8dba5fcf1d501b08b5fabe388e8c6e9bd37d915a1d05b592c5d7aa905
+  metadata.gz: becc7e2bea0be35bb89964bd8ed0e78078063b6b95073d091604f90bf0781f16
+  data.tar.gz: 317e7bd7e947520069bf9e9540b8e7a3b245322322732ef1e8a28ef2d97aba35
 SHA512:
-  metadata.gz: 5fb1dea729c8a8266fa41c017fc23000dcdbbec3170abbb1e24b5412671198fed1866405024f7f1c1f29cd419af483110f69337f8e71e0e567a33b7080c1c0a5
-  data.tar.gz: 964f96f9ffd40214d32bff6c60c4d99e0ee916ab3a1943bc49c14af1905cfeaafc17a214f01b99539862bafaab134c0e559efc3a2d9770643022fa34b8101127
+  metadata.gz: f3de9722cf36d01eeb82929a2c93460f505b723041a73c0b4064f83d7e3bdd1caebbfab3858f9a14e58ee0447b4c4a7fc182d48f567f41d3a24b50e0576a38e1
+  data.tar.gz: 14f6e5c74e5bf141b67f92068a649079a09806ca6f263b042e0fc276e53282f8c662c2a69dfa172467098ab1d7f37fc2e7efcd54e37525c118c2cc1d9166e607

data/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.7.4 (2026-04-23)
+
+Full Changelog: [v0.7.3...v0.7.4](https://github.com/Hexlet/docker-ruby/compare/v0.7.3...v0.7.4)
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([590bc94](https://github.com/Hexlet/docker-ruby/commit/590bc94c26ce9d630f0f6b4c9458d837876a9a98))
+* **internal:** correct multipart form field name encoding ([d2df78a](https://github.com/Hexlet/docker-ruby/commit/d2df78ae65e43660b24958459e1f1f165ca9483f))
+* multipart encoding for file arrays ([b186016](https://github.com/Hexlet/docker-ruby/commit/b186016397a9419d3f4622e1bd5fc6ad8a02bc82))
+* properly mock time in ruby ci tests ([f291b96](https://github.com/Hexlet/docker-ruby/commit/f291b9605760add258fc3e596a664800663d9e7f))
+* variable name typo ([b827fa8](https://github.com/Hexlet/docker-ruby/commit/b827fa8ca02b7b0ca4d27ee6cf45cb520069c959))
+
+
+### Chores
+
+* **ci:** add build step ([f5b8022](https://github.com/Hexlet/docker-ruby/commit/f5b8022932e298a82aa303e923a6e5bf69279cdc))
+* **ci:** skip lint on metadata-only changes ([24f48e2](https://github.com/Hexlet/docker-ruby/commit/24f48e2052ca6fd27a2e19a49f9436891a522902))
+* **ci:** skip uploading artifacts on stainless-internal branches ([1b1aa08](https://github.com/Hexlet/docker-ruby/commit/1b1aa0891ea556e0c8ffa46ea20ff0a4d5f3e700))
+* **ci:** support opting out of skipping builds on metadata-only commits ([a9b2155](https://github.com/Hexlet/docker-ruby/commit/a9b2155d508034db5317b6e7122183b167f7ae92))
+* **internal:** codegen related update ([c0b2afb](https://github.com/Hexlet/docker-ruby/commit/c0b2afb257b2a173db9721e248ecbbcb230c54c1))
+* **internal:** codegen related update ([ab55081](https://github.com/Hexlet/docker-ruby/commit/ab550815719723e748965fb23c2547aee2b1de91))
+* **internal:** more robust bootstrap script ([d23ffee](https://github.com/Hexlet/docker-ruby/commit/d23ffee2238d18545a5b1bb69a515e22b427fea8))
+* **internal:** tweak CI branches ([7889dd4](https://github.com/Hexlet/docker-ruby/commit/7889dd429e6f5facaad352660290bee0a81bd446))
+* **internal:** update gitignore ([33e96c7](https://github.com/Hexlet/docker-ruby/commit/33e96c75c33be17c746f95320942a9e2d362cad1))
+* update placeholder string ([a3b8bba](https://github.com/Hexlet/docker-ruby/commit/a3b8bbab2dfb07a0a882c843f4d7c28da690772c))
+
+## 0.7.3 (2026-02-24)
+
+Full Changelog: [v0.7.2...v0.7.3](https://github.com/Hexlet/docker-ruby/compare/v0.7.2...v0.7.3)
+
 ## 0.7.2 (2026-02-20)
 
 Full Changelog: [v0.7.1...v0.7.2](https://github.com/Hexlet/docker-ruby/compare/v0.7.1...v0.7.2)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "docker-engine-ruby", "~> 0.7.2"
+gem "docker-engine-ruby", "~> 0.7.4"
 ```
 
 <!-- x-release-please-end -->
@@ -132,6 +132,15 @@ docker = DockerEngineRuby::Client.new(
 )
 ```
 
+By default, peer verification is enabled. You can disable it explicitly:
+
+```ruby
+docker = DockerEngineRuby::Client.new(
+  base_url: "https://localhost:2376",
+  tls_verify_peer: false
+)
+```
+
 You can also configure these through environment variables:
 
 - `DOCKER_TLS_CA_CERT_PATH`

data/lib/docker_engine_ruby/client.rb

@@ -15,6 +15,9 @@ module DockerEngineRuby
     # Default max retry delay in seconds.
     DEFAULT_MAX_RETRY_DELAY = 8.0
 
+    # Whether to verify server TLS certificate chain.
+    DEFAULT_TLS_VERIFY_PEER = true
+
     # rubocop:disable Style/MutableConstant
     # @type [Hash{Symbol=>String}]
     ENVIRONMENTS = {production: "http://localhost:2375", production_tls: "https://localhost:2376"}
@@ -106,6 +109,8 @@ module DockerEngineRuby
     # @param initial_retry_delay [Float]
     #
     # @param max_retry_delay [Float]
+    #
+    # @param tls_verify_peer [Boolean] Whether to verify server TLS certificate chain.
     def initialize(
       tls_ca_cert_path: ENV["DOCKER_TLS_CA_CERT_PATH"],
       tls_client_cert_path: ENV["DOCKER_TLS_CLIENT_CERT_PATH"],
@@ -115,10 +120,12 @@ module DockerEngineRuby
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
+      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
+      tls_verify_peer: self.class::DEFAULT_TLS_VERIFY_PEER
     )
       base_url ||= DockerEngineRuby::Client::ENVIRONMENTS.fetch(environment&.to_sym || :production) do
-        message = "environment must be one of #{DockerEngineRuby::Client::ENVIRONMENTS.keys}, got #{environment}"
+        message = "environment must be one of " \
+                  "#{DockerEngineRuby::Client::ENVIRONMENTS.keys}, got #{environment}"
         raise ArgumentError.new(message)
       end
 
@@ -132,6 +139,7 @@ module DockerEngineRuby
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
         max_retry_delay: max_retry_delay,
+        tls_verify_peer: tls_verify_peer,
         tls_ca_cert_path: @tls_ca_cert_path,
         tls_client_cert_path: @tls_client_cert_path,
         tls_client_key_path: @tls_client_key_path

data/lib/docker_engine_ruby/internal/transport/base_client.rb

@@ -197,6 +197,7 @@ module DockerEngineRuby
         # @param max_retry_delay [Float]
         # @param headers [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}]
         # @param idempotency_header [String, nil]
+        # @param tls_verify_peer [Boolean]
         # @param tls_ca_cert_path [String, nil]
         # @param tls_client_cert_path [String, nil]
         # @param tls_client_key_path [String, nil]
@@ -208,6 +209,7 @@ module DockerEngineRuby
           max_retry_delay: 0.0,
           headers: {},
           idempotency_header: nil,
+          tls_verify_peer: true,
           tls_ca_cert_path: nil,
           tls_client_cert_path: nil,
           tls_client_key_path: nil
@@ -219,6 +221,7 @@ module DockerEngineRuby
           end
           @requester = DockerEngineRuby::Internal::Transport::PooledNetRequester.new(
             unix_socket_path: @unix_socket_path,
+            tls_verify_peer: tls_verify_peer,
             tls_ca_cert_path: tls_ca_cert_path,
             tls_client_cert_path: tls_client_cert_path,
             tls_client_key_path: tls_client_key_path

data/lib/docker_engine_ruby/internal/transport/pooled_net_requester.rb

@@ -37,10 +37,11 @@ module DockerEngineRuby
           # @param tls_cert [OpenSSL::X509::Certificate, nil]
           # @param tls_key [OpenSSL::PKey::PKey, nil]
           # @param unix_socket_path [String, nil]
+          # @param tls_verify_peer [Boolean]
           # @param url [URI::Generic]
           #
           # @return [Net::HTTP]
-          def connect(cert_store:, tls_cert:, tls_key:, unix_socket_path:, url:)
+          def connect(cert_store:, tls_cert:, tls_key:, unix_socket_path:, tls_verify_peer:, url:)
             if unix_socket_path
               return UnixSocketHTTP.new(unix_socket_path).tap do
                 _1.use_ssl = false
@@ -65,6 +66,7 @@ module DockerEngineRuby
                 _1.cert_store = cert_store
                 _1.cert = tls_cert if tls_cert
                 _1.key = tls_key if tls_key
+                _1.verify_mode = tls_verify_peer ? OpenSSL::SSL::VERIFY_PEER : OpenSSL::SSL::VERIFY_NONE
               end
             end
           end
@@ -141,6 +143,7 @@ module DockerEngineRuby
                   tls_cert: @tls_cert,
                   tls_key: @tls_key,
                   unix_socket_path: unix_socket_path,
+                  tls_verify_peer: @tls_verify_peer,
                   url: url
                 )
               end
@@ -236,9 +239,11 @@ module DockerEngineRuby
         # @param tls_client_cert_path [String, nil]
         # @param tls_client_key_path [String, nil]
         # @param unix_socket_path [String, nil]
+        # @param tls_verify_peer [Boolean]
         def initialize(
           size: self.class::DEFAULT_MAX_CONNECTIONS,
           unix_socket_path: nil,
+          tls_verify_peer: true,
           tls_ca_cert_path: nil,
           tls_client_cert_path: nil,
           tls_client_key_path: nil
@@ -246,12 +251,15 @@ module DockerEngineRuby
           @mutex = Mutex.new
           @size = size
           @default_unix_socket_path = unix_socket_path
+          @tls_verify_peer = tls_verify_peer
           @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @cert_store.add_file(tls_ca_cert_path) if tls_ca_cert_path
 
           if tls_client_cert_path || tls_client_key_path
             if tls_client_cert_path.nil? || tls_client_key_path.nil?
-              raise ArgumentError.new("Both tls_client_cert_path and tls_client_key_path must be provided together.")
+              raise ArgumentError.new(
+                "Both tls_client_cert_path and tls_client_key_path must be provided together."
+              )
             end
 
             @tls_cert = OpenSSL::X509::Certificate.new(File.read(tls_client_cert_path))

data/lib/docker_engine_ruby/internal/util.rb

@@ -157,7 +157,7 @@ module DockerEngineRuby
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{DockerEngineRuby::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{DockerEngineRuby::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module DockerEngineRuby
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module DockerEngineRuby
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(DockerEngineRuby::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module DockerEngineRuby
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -490,6 +504,37 @@ module DockerEngineRuby
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -540,16 +585,15 @@ module DockerEngineRuby
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in DockerEngineRuby::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -566,6 +610,7 @@ module DockerEngineRuby
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -575,7 +620,7 @@ module DockerEngineRuby
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || DockerEngineRuby::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -591,6 +636,7 @@ module DockerEngineRuby
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private

data/lib/docker_engine_ruby/models/config_delete_params.rb

@@ -7,7 +7,13 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/docker_engine_ruby/models/config_inspect_params.rb

@@ -7,7 +7,13 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/docker_engine_ruby/models/config_update_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute version
       #
       #   @return [Integer]
       required :version, Integer
 
-      # @!method initialize(version:, request_options: {})
+      # @!method initialize(id:, version:, request_options: {})
+      #   @param id [String]
       #   @param version [Integer]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/docker_engine_ruby/models/container_archive_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute path
       #
       #   @return [String]
       required :path, String
 
-      # @!method initialize(path:, request_options: {})
+      # @!method initialize(id:, path:, request_options: {})
+      #   @param id [String]
       #   @param path [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/docker_engine_ruby/models/container_attach_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute detach_keys
       #
       #   @return [String, nil]
@@ -37,7 +42,8 @@ module DockerEngineRuby
       #   @return [Boolean, nil]
       optional :stream, DockerEngineRuby::Internal::Type::Boolean
 
-      # @!method initialize(detach_keys: nil, logs: nil, stderr: nil, stdin: nil, stdout: nil, stream: nil, request_options: {})
+      # @!method initialize(id:, detach_keys: nil, logs: nil, stderr: nil, stdin: nil, stdout: nil, stream: nil, request_options: {})
+      #   @param id [String]
       #   @param detach_keys [String]
       #   @param logs [Boolean]
       #   @param stderr [Boolean]

data/lib/docker_engine_ruby/models/container_changes_params.rb

@@ -7,7 +7,13 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/docker_engine_ruby/models/container_delete_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute force
       #
       #   @return [Boolean, nil]
@@ -22,7 +27,8 @@ module DockerEngineRuby
       #   @return [Boolean, nil]
       optional :v, DockerEngineRuby::Internal::Type::Boolean
 
-      # @!method initialize(force: nil, link: nil, v: nil, request_options: {})
+      # @!method initialize(id:, force: nil, link: nil, v: nil, request_options: {})
+      #   @param id [String]
       #   @param force [Boolean]
       #   @param link [Boolean]
       #   @param v [Boolean]

data/lib/docker_engine_ruby/models/container_exec_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute attach_stderr
       #
       #   @return [Boolean, nil]
@@ -65,7 +70,8 @@ module DockerEngineRuby
       #   @return [String, nil]
       optional :working_dir, String, api_name: :WorkingDir
 
-      # @!method initialize(attach_stderr: nil, attach_stdin: nil, attach_stdout: nil, cmd: nil, console_size: nil, detach_keys: nil, env: nil, privileged: nil, tty: nil, user: nil, working_dir: nil, request_options: {})
+      # @!method initialize(id:, attach_stderr: nil, attach_stdin: nil, attach_stdout: nil, cmd: nil, console_size: nil, detach_keys: nil, env: nil, privileged: nil, tty: nil, user: nil, working_dir: nil, request_options: {})
+      #   @param id [String]
       #   @param attach_stderr [Boolean]
       #   @param attach_stdin [Boolean]
       #   @param attach_stdout [Boolean]

data/lib/docker_engine_ruby/models/container_export_params.rb

@@ -7,7 +7,13 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/docker_engine_ruby/models/container_inspect_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute size
       #
       #   @return [Boolean, nil]
       optional :size, DockerEngineRuby::Internal::Type::Boolean
 
-      # @!method initialize(size: nil, request_options: {})
+      # @!method initialize(id:, size: nil, request_options: {})
+      #   @param id [String]
       #   @param size [Boolean]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/docker_engine_ruby/models/container_kill_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute signal
       #
       #   @return [String, nil]
       optional :signal, String
 
-      # @!method initialize(signal: nil, request_options: {})
+      # @!method initialize(id:, signal: nil, request_options: {})
+      #   @param id [String]
       #   @param signal [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/docker_engine_ruby/models/container_logs_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute follow
       #
       #   @return [Boolean, nil]
@@ -42,7 +47,8 @@ module DockerEngineRuby
       #   @return [Integer, nil]
       optional :until_, Integer
 
-      # @!method initialize(follow: nil, since: nil, stderr: nil, stdout: nil, tail: nil, timestamps: nil, until_: nil, request_options: {})
+      # @!method initialize(id:, follow: nil, since: nil, stderr: nil, stdout: nil, tail: nil, timestamps: nil, until_: nil, request_options: {})
+      #   @param id [String]
       #   @param follow [Boolean]
       #   @param since [Integer]
       #   @param stderr [Boolean]

data/lib/docker_engine_ruby/models/container_pause_params.rb

@@ -7,7 +7,13 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(id:, request_options: {})
+      #   @param id [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/docker_engine_ruby/models/container_rename_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute name
       #
       #   @return [String]
       required :name, String
 
-      # @!method initialize(name:, request_options: {})
+      # @!method initialize(id:, name:, request_options: {})
+      #   @param id [String]
       #   @param name [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end

data/lib/docker_engine_ruby/models/container_resize_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute h
       #
       #   @return [Integer]
@@ -17,7 +22,8 @@ module DockerEngineRuby
       #   @return [Integer]
       required :w, Integer
 
-      # @!method initialize(h:, w:, request_options: {})
+      # @!method initialize(id:, h:, w:, request_options: {})
+      #   @param id [String]
       #   @param h [Integer]
       #   @param w [Integer]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]

data/lib/docker_engine_ruby/models/container_restart_params.rb

@@ -7,6 +7,11 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute signal
       #
       #   @return [String, nil]
@@ -17,7 +22,8 @@ module DockerEngineRuby
       #   @return [Integer, nil]
       optional :t, Integer
 
-      # @!method initialize(signal: nil, t: nil, request_options: {})
+      # @!method initialize(id:, signal: nil, t: nil, request_options: {})
+      #   @param id [String]
       #   @param signal [String]
       #   @param t [Integer]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]

data/lib/docker_engine_ruby/models/container_start_params.rb

@@ -7,12 +7,18 @@ module DockerEngineRuby
       extend DockerEngineRuby::Internal::Type::RequestParameters::Converter
       include DockerEngineRuby::Internal::Type::RequestParameters
 
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
       # @!attribute detach_keys
       #
       #   @return [String, nil]
       optional :detach_keys, String
 
-      # @!method initialize(detach_keys: nil, request_options: {})
+      # @!method initialize(id:, detach_keys: nil, request_options: {})
+      #   @param id [String]
       #   @param detach_keys [String]
       #   @param request_options [DockerEngineRuby::RequestOptions, Hash{Symbol=>Object}]
     end