dockerapi 0.8.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e010cc4d2a5c4aa102ffe7cd9d58e7e4823bf4ba9079f9a622cb021dad8cd0e
-  data.tar.gz: 47163ffb19a35b4a473da7f88f40d5eac418a15638ccc8d91b6b1672a1af09f6
+  metadata.gz: a32e488d06a0afd653bb04ab0ad5131fa8e898973128d7a6661f3d3fa4eae53d
+  data.tar.gz: 641ffcc096f798fbfff057fb1eecc7ce97ad9191c2acf49f5e97c90bf5ceddc5
 SHA512:
-  metadata.gz: b48b06f99c46c936d4458a1908c08fe13f862ce7c63394077f52d8b621b2eb9e0be959682227f9b7ba59946f18b9098f2983a4bf1a781d16218ad66b08c730a3
-  data.tar.gz: ee2cb40d653054ea9bb559b9d39f43dd28556dcc25374033904f5c292403e371176ce1233636209bd5678df06f90436f6214aaafadd255d0b438cc870c318591
+  metadata.gz: 6cda72170483e133b467a399d77fbcc7668793726b8f67beb4235c5eaf74e2d91977c9544f93ee7d3f3c4b681004d9415f939d2d521aa70151d3a580fc15fc86
+  data.tar.gz: d45997041c9d706d2c2d0e2c5e3f5ccaedad51d71cb27ba8538898565e6259e30d7ff11ffa60a5dee9ffca3611ed51ddc96ca68af2a5aff490715b4645297c0d

data/CHANGELOG.md

@@ -1,17 +1,85 @@
+# 0.12.0
+
+Add `Docker::API::Plugin` methods:
+* list
+* privileges
+* install
+* details
+* remove
+* enable
+* disable
+* upgrade
+* create
+* push
+* configure
+
+# 0.11.0
+
+Add `Docker::API::Task` methods:
+* list
+* details
+* logs
+
+Add `Docker::API::Secret` methods:
+* create
+* update
+* list
+* details
+* delete
+
+Add `Docker::API::Config` methods:
+* create
+* update
+* list
+* details
+* delete
+
+Add `Docker::API::Image` methods:
+* distribution
+
+# 0.10.0
+
+Add `Docker::API::Service` methods:
+* create
+* update
+* list
+* details
+* logs
+* delete
+
+# 0.9.0
+
+Significant change: `#inspect` is now deprecated and replaced by `#details` in the following classes:
+* `Docker::API::Container`
+* `Docker::API::Image`
+* `Docker::API::Network`
+* `Docker::API::Volume`
+* `Docker::API::Exec`
+* `Docker::API::Swarm`
+* `Docker::API::Node`
+
+The method will be removed in the refactoring phase.
+
+# 0.8.1
+
+Restore the default `#inspect` output for `Docker::API` classes. 
+
+Most of the overriding methods take an argument, therefore calling using the expect arguments will return a `Docker::API::Response` object, while calling without arguments will return `Kernel#inspect`. To avoid this confusing schema, next release will rename `#inspect` within `Docker::API` to something else.
+
 # 0.8.0
 
-Add Docker::API::Swarm methods:
+Add `Docker::API::Swarm` methods:
 * init
 * update
-* inspect
+* ~~inspect~~ details
 * unlock_key
 * unlock
 * join
 * leave
 
-Add Docker::API::Node methods:
+Add `Docker::API::Node` methods:
 * list
-* inspect
+* ~~inspect~~ details
 * update
 * delete
 
@@ -19,7 +87,7 @@ Query parameters and request body json can now skip the validation step with `:s
 
 # 0.7.0
 
-Major changes: Docker::API::Connection is now a regular class intead of a Singleton, allowing multiple connections to be stablished within the same program (replacing the connect_to implementation). To leverage this feature, API-related classes must be initialized and may or may not receive a Docker::API::Connection as parameter, or it'll connect to /var/run/docker.sock by default. For this reason, class methods were replaced with instance methods. Documentation will reflect this changes of implementation.
+Significant changes: `Docker::API::Connection` is now a regular class intead of a Singleton, allowing multiple connections to be stablished within the same program (replacing the connect_to implementation). To leverage this feature, API-related classes must be initialized and may or may not receive a `Docker::API::Connection` as parameter, or it'll connect to `/var/run/docker.sock` by default. For this reason, class methods were replaced with instance methods. Documentation will reflect this changes of implementation.
 
 Bug fix: Image push returns a 20X status even when the push is unsucessful. To prevent false positives, it now requires the authentication parameters to be provided, generating a 403 status for invalid credentials or an error if they are absent.
 
@@ -27,15 +95,15 @@ Bug fix: Image push returns a 20X status even when the push is unsucessful. To p
 
 Add connection parameters specifications with connect_to in Docker::API::Connection.
 
-Add Docker::API::Exec methods:
+Add `Docker::API::Exec` methods:
 * create
 * start
 * resize
-* inspect
+* ~~inspect~~ details
 
 # 0.5.0
 
-Add Docker::API::System methods:
+Add `Docker::API::System` methods:
 * auth
 * ping
 * info
@@ -43,7 +111,7 @@ Add Docker::API::System methods:
 * events
 * df
 
-Add new response class Docker::API::Response with the following methods:
+Add new response class `Docker::API::Response` with the following methods:
 * json
 * path
 * success?
@@ -52,9 +120,9 @@ Error classes output better error messages.
 
 # 0.4.0
 
-Add Docker::API::Network methods:
+Add `Docker::API::Network` methods:
 * list
-* inspect
+* ~~inspect~~ details
 * create
 * remove
 * prune
@@ -63,9 +131,9 @@ Add Docker::API::Network methods:
 
 # 0.3.0
 
-Add Docker::API::Volume methods:
+Add `Docker::API::Volume` methods:
 * list
-* inspect
+* ~~inspect~~ details
 * create
 * remove
 * prune
@@ -73,8 +141,8 @@ Add Docker::API::Volume methods:
 
 # 0.2.0
 
-Add Docker::API::Image methods:
-* inspect
+Add `Docker::API::Image` methods:
+* ~~inspect~~ details
 * history
 * list
 * search
@@ -89,13 +157,13 @@ Add Docker::API::Image methods:
 * build
 * delete_cache
 
-Add Docker::API::System.auth (untested) for basic authentication
+Add `Docker::API::System.auth` (untested) for basic authentication
 
 # 0.1.0
 
-Add Docker::API::Container methods:
+Add `Docker::API::Container` methods:
 * list
-* inspect
+* ~~inspect~~ details
 * top
 * changes
 * start

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dockerapi (0.8.0)
+    dockerapi (0.12.0)
       excon (~> 0.74.0)
 
 GEM

data/README.md

@@ -20,8 +20,6 @@ Or install it yourself as:
 
 ## Usage
 
-New implementation details as of v0.7.0.
-
 ### Images
 
 ```ruby
@@ -44,7 +42,10 @@ image.create( fromSrc: "https://url.to/file.tar", repo: "repo:tag" )
 image.list
 
 # Inspect image
-image.inspect("image")
+image.details("image")
+
+# Return image digest and platform information by contacting the registry.
+image.distribution("image")
 
 # History
 image.history("image")
@@ -125,7 +126,7 @@ container.list
 container.list(all: true)
 
 # Inspect container
-container.inspect("nginx")
+container.details("nginx")
 
 # View container's processes
 container.top("nginx")
@@ -136,7 +137,7 @@ container.top("nginx").json
 # View filesystem changes
 container.changes("nginx")
 
-# View filesystem logs
+# View container logs
 container.logs("nginx", stdout: true)
 container.logs("nginx", stdout: true, follow: true)
 
@@ -172,7 +173,7 @@ volume.create( Name:"my-volume" )
 volume.list
 
 # Inspect volume
-volume.inspect("my-volume")
+volume.details("my-volume")
 
 # Remove volume
 volume.remove("my-volume")
@@ -191,7 +192,7 @@ network = Docker::API::Network.new
 network.list
 
 # Inspect network
-network.inspect("bridge")
+network.details("bridge")
 
 # Create network
 network.create( Name:"my-network" )
@@ -246,7 +247,7 @@ response = exe.start(id)
 print response.data[:stream]
 
 # Inspect exec instance
-exe.inspect(id)
+exe.details(id)
 ```
 
 ### Swarm
@@ -258,7 +259,7 @@ swarm = Docker::API::Swarm.new
 swarm.init({AdvertiseAddr: "local-ip-address:2377", ListenAddr: "0.0.0.0:4567"})
 
 # Inspect swarm
-swarm.inspect
+swarm.details
 
 # Update swarm
 swarm.update(version, {rotateWorkerToken: true})
@@ -288,7 +289,7 @@ node = Docker::API::Node.new
 node.list
 
 # Inspect node
-node.inspect("node-id")
+node.details("node-id")
 
 # Update node (version, Role and Availability must be present)
 node.update("node-id", {version: "version"}, {Role: "worker", Availability: "pause" })
@@ -299,9 +300,141 @@ node.update("node-id", {version: "version"}, {Role: "manager", Availability: "ac
 node.delete("node-id")
 ```
 
+### Service
+```ruby
+# Connect to local service endpoints
+service = Docker::API::Service.new
+
+# List services
+service.list
+
+# Create a service
+service.create({Name: "nginx-service", 
+    TaskTemplate: {ContainerSpec: { Image: "nginx:alpine" }},
+    Mode: { Replicated: { Replicas: 2 } },
+    EndpointSpec: { Ports: [ {Protocol: "tcp", PublishedPort: 80, TargetPort: 80} ] }
+})
+
+# Update a service (needs version and current Spec)
+version = service.details( service ).json["Version"]["Index"]
+spec = service.details(service).json["Spec"]
+service.update("nginx-service", {version: version}, spec.merge!({ Mode: { Replicated: { Replicas: 1 } } }))
+
+# View service logs
+service.logs("nginx-service", stdout: true)
+
+# Inspect service 
+service.details("nginx-service")
+
+# Delete service 
+service.delete("nginx-service")
+```
+
+### Task
+```ruby
+# Connect to local task endpoints
+task = Docker::API::Task.new
+
+# List tasks
+task.list
+
+# View task logs
+task.logs("task-id", stdout: true)
+
+# Inspect service 
+task.details("task-id")
+```
+
+### Secret
+```ruby
+# Connect to local secret endpoints
+secret = Docker::API::Secret.new
+
+# List secrets
+secret.list
+
+# Create a secret
+secret.create({Name: "secret-name", Data: "VEhJUyBJUyBOT1QgQSBSRUFMIENFUlRJRklDQVRFCg=="})
+
+# Inspect secrets 
+secret.details("secret-name")
+
+# Update a secret (needs version and current Spec)
+version = secret.details( "secret-name" ).json["Version"]["Index"]
+spec = secret.details("secret-name").json["Spec"]
+secret.update("secret-name", {version: version}, spec.merge!({ Data: "VEhJUyBJUyBOT1QgQSBSRUFMIENFUlRJRklDQVRFCg==" }))
+
+# Delete secret
+secret.delete("secret-name")
+```
+
+### Config
+```ruby
+# Connect to local config endpoints
+config = Docker::API::Config.new
+
+# List configs
+config.list
+
+# Create a config
+config.create({Name: "config-name", Data: "VEhJUyBJUyBOT1QgQSBSRUFMIENFUlRJRklDQVRFCg=="})
+
+# Inspect configs 
+config.details("config-name")
+
+# Update a configs (needs version and current Spec)
+version = config.details( "config-name" ).json["Version"]["Index"]
+spec = config.details("config-name").json["Spec"]
+config.update("config-name", {version: version}, spec.merge!({ Data: "VEhJUyBJUyBOT1QgQSBSRUFMIENFUlRJRklDQVRFCg==" }))
+
+# Delete config
+config.delete("config-name")
+```
+
+### Plugin
+```ruby
+# Connect to local plugin endpoints
+plugin = Docker::API::Plugin.new
+
+# List plugins
+plugin.list
+
+# List plugin's privileges
+plugin.privileges(remote: "plugin-name")
+
+# Install plugin (using defined privileges)
+privileges = plugin.privileges(remote: "plugin-name")
+plugin.install({remote: "plugin-name"}, privileges)
+
+# Upgrade plugin (using defined privileges)
+privileges = plugin.privileges(remote: "plugin-name2")
+plugin.upgrade("plugin-name", {remote: "plugin-name2"}, privileges)
+
+# Enable plugin
+plugin.enable("plugin-name", timeout: 0)
+
+# Disable plugin
+plugin.disable("plugin-name")
+
+# Configure plugin
+plugin.configure("plugin-name", ["DEBUG=1"])
+
+# Inspect plugin
+plugin.details("plugin-name")
+
+# Remove plugin
+plugin.remove("plugin-name")
+
+# Create plugin (tar file must contain rootfs folder and config.json file)
+plugin.create("name", "/path/to/file.tar")
+
+# Push plugin
+plugin.push("name")
+```
+
 ### Connection
 
-By default Docker::API::Connection will connect to local Docker socket at `/var/run/docker.sock`. See examples below to use a different path or connect to a remote address.
+By default `Docker::API::Connection` will connect to local Docker socket at `/var/run/docker.sock`. See examples below to use a different path or connect to a remote address.
 
 ```ruby
 # Setting different connections
@@ -373,17 +506,20 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 | Class | Tests | Implementation | Refactoring |
 |---|---|---|---|
-| Container | Ok | Ok | 7/24 |
-| Image | Ok | Ok | 7/31 |
-| Volume | Ok | Ok | 8/7 |
-| Network | Ok | Ok | 8/7 |
-| System | Ok | Ok | 8/7 |
-| Exec | Ok | Ok | 8/7 |
-| Swarm | Ok | Ok | 8/14 |
-| Node | Ok | Ok | 8/14 |
-| Service | 7/17 | 7/17 | 8/14 |
-| Task | 7/17 | 7/17 | 8/14 |
-| Secret | 7/17 | 7/17 | 8/14 |
+| Image | Ok | Ok | 8/7 |
+| Container | Ok | Ok | 8/14 |
+| Volume | Ok | Ok | 8/21 |
+| Network | Ok | Ok | 8/21 |
+| System | Ok | Ok | 8/21 |
+| Exec | Ok | Ok | 8/21 |
+| Swarm | Ok | Ok | 8/28 |
+| Node | Ok | Ok | 8/28 |
+| Service | Ok | Ok | 8/28 |
+| Task | Ok | Ok | 9/4 |
+| Secret | Ok | Ok | 9/4 |
+| Config | Ok | Ok | 9/4 |
+| Distribution | Ok | Ok | 9/4 |
+| Plugin | Ok | 7/24 | 9/4 |
 
 ## Contributing
 

data/lib/docker/api/config.rb

@@ -0,0 +1,70 @@
+# This class represents the Docker API endpoints regarding configs.
+#
+# @see https://docs.docker.com/engine/api/v1.40/#tag/Config
+#
+# Configs are application configurations that can be used by services. Swarm mode must be enabled for these endpoints to work.
+class Docker::API::Config < Docker::API::Base
+
+    # List configs
+    #
+    # Docker API: GET /configs
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ConfigList
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def list params = {}
+        validate Docker::API::InvalidParameter, [:filters], params
+        @connection.get(build_path("/configs",params))
+    end
+
+    # Create a config
+    #
+    # Docker API: POST /configs/create
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ConfigCreate
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    def create body = {}
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :Data, :Templating], body
+        @connection.request(method: :post, path: "/configs/create", headers: {"Content-Type": "application/json"}, body: body.to_json)
+    end
+
+    # Inspect a config
+    #
+    # Docker API: GET /configs/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ConfigInspect
+    #
+    # @param name [String]: The ID or name of the config.
+    def details name
+        @connection.get("/configs/#{name}")
+    end
+
+    # Update a config
+    #
+    # Docker API: POST /configs/{id}/update
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ConfigUpdate
+    #
+    # @param name [String]: The ID or name of the config.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    def update name, params = {}, body = {}
+        validate Docker::API::InvalidParameter, [:version], params
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :Data, :Driver, :Templating], body
+        @connection.request(method: :post, path: build_path("/configs/#{name}/update",params), headers: {"Content-Type": "application/json"}, body: body.to_json)
+    end
+
+    # Delete a config
+    #
+    # Docker API: DELETE /configs/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ConfigDelete
+    #
+    # @param name [String]: The ID or name of the config.
+    def delete name
+        @connection.delete("/configs/#{name}")
+    end
+end

data/lib/docker/api/container.rb

@@ -5,16 +5,12 @@ module Docker
 
         class Container < Docker::API::Base
 
-            def base_path
-                "/containers"
-            end
-
             def list params = {}
                 validate Docker::API::InvalidParameter, [:all, :limit, :size, :filters], params
                 @connection.get(build_path(["json"], params))
             end
 
-            def inspect name, params = {}
+            def details name, params = {}
                 validate Docker::API::InvalidParameter, [:size], params
                 @connection.get(build_path([name, "json"], params))
             end
@@ -124,7 +120,7 @@ module Docker
             end
 
             def export name, path = "exported_container"
-                response = self.inspect(name)
+                response = self.details(name)
                 if response.status == 200
                     file = File.open(File.expand_path(path), "wb")
                     streamer = lambda do |chunk, remaining_bytes, total_bytes|
@@ -154,6 +150,21 @@ module Docker
                 response
             end
 
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def base_path
+                "/containers"
+            end
+
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name, params = args[0], args[1] || {}
+                details(name, params)
+            end
+            #################################################
+
         end
     end
 end

data/lib/docker/api/exec.rb

@@ -2,10 +2,6 @@ module Docker
     module API
         class Exec < Docker::API::Base
 
-            def base_path
-                "/exec"
-            end
-
             def create name, body = {}
                 validate Docker::API::InvalidRequestBody, [:AttachStdin, :AttachStdout, :AttachStderr, :DetachKeys, :Tty, :Env, :Cmd, :Privileged, :User, :WorkingDir], body
                 @connection.request(method: :post, path: "/containers/#{name}/exec", headers: {"Content-Type": "application/json"}, body: body.to_json )
@@ -27,12 +23,23 @@ module Docker
 
             def resize name, params = {}
                 validate Docker::API::InvalidParameter, [:w, :h], params
-                @connection.post(build_path([name, "resize"], params))
+                @connection.post(build_path("/exec/#{name}/resize", params))
             end
 
-            def inspect name
-                @connection.get(build_path([name, "json"]))
+            def details name
+                @connection.get("/exec/#{name}/json")
+            end
+            
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name = args[0]
+                details(name)
             end
+            #################################################
 
         end
     end

data/lib/docker/api/image.rb

@@ -7,12 +7,12 @@ module Docker
         BuildParams = [:dockerfile, :t, :extrahosts, :remote, :q, :nocache, :cachefrom, :pull, :rm, :forcerm, :memory, :memswap, :cpushares, :cpusetcpus, :cpuperiod, :cpuquota, :buildargs, :shmsize, :squash, :labels, :networkmode, :platform, :target, :outputs]
         class Image < Docker::API::Base
 
-            def base_path
-                "/images"
+            def details name
+                @connection.get(build_path([name, "json"]))
             end
 
-            def inspect name
-                @connection.get(build_path([name, "json"]))
+            def distribution name
+                @connection.get("/distribution/#{name}/json")
             end
 
             def history name
@@ -76,7 +76,7 @@ module Docker
             def commit params = {}, body = {}
                 validate Docker::API::InvalidParameter, [:container, :repo, :tag, :comment, :author, :pause, :changes], params
                 validate Docker::API::InvalidRequestBody, Docker::API::CommitBody, body
-                container = Docker::API::Container.new.inspect(params[:container])
+                container = Docker::API::Container.new.details(params[:container])
                 return container if [404, 301].include? container.status
                 body = JSON.parse(container.body)["Config"].merge(body)
                 @connection.request(method: :post, path: build_path("/commit", params), headers: {"Content-Type": "application/json"}, body: body.to_json)
@@ -132,7 +132,21 @@ module Docker
                 @connection.post(build_path("/build/prune", params))
             end
 
-        end
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def base_path
+                "/images"
+            end
 
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name = args[0]
+                details(name)
+            end
+            #################################################
+
+        end
     end
 end

data/lib/docker/api/network.rb

@@ -2,16 +2,12 @@ module Docker
     module API        
         class Network < Docker::API::Base
 
-            def base_path
-                "/networks"
-            end
-
             def list params = {}
                 validate Docker::API::InvalidParameter, [:filters], params
                 @connection.get(build_path("/networks", params))
             end
 
-            def inspect name, params = {}
+            def details name, params = {}
                 validate Docker::API::InvalidParameter, [:verbose, :scope], params
                 @connection.get(build_path([name], params))
             end
@@ -40,6 +36,21 @@ module Docker
                 @connection.request(method: :post, path: build_path([name, "disconnect"]), headers: {"Content-Type": "application/json"}, body: body.to_json)
             end
 
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def base_path
+                "/networks"
+            end
+
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name, params = args[0], args[1] || {}
+                details(name, params)
+            end
+            #################################################
+
         end
     end
 end

data/lib/docker/api/node.rb

@@ -1,16 +1,12 @@
 module Docker
     module API        
         class Node < Docker::API::Base
-            
+
             def list params = {}
                 validate Docker::API::InvalidParameter, [:filters], params
                 @connection.get(build_path("/nodes", params))
             end
 
-            def inspect name
-                @connection.get("/nodes/#{name}")
-            end
-
             def update name, params = {}, body = {}
                 validate Docker::API::InvalidParameter, [:version], params
                 validate Docker::API::InvalidRequestBody, [:Name, :Labels, :Role, :Availability], body
@@ -21,6 +17,22 @@ module Docker
                 validate Docker::API::InvalidParameter, [:force], params
                 @connection.delete(build_path("/nodes/#{name}", params))
             end
+
+            def details name
+                @connection.get("/nodes/#{name}")
+            end
+
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name = args[0]
+                details(name)
+            end
+            #################################################
+
         end
     end
 end

data/lib/docker/api/plugin.rb

@@ -0,0 +1,166 @@
+# This class represents the Docker API endpoints regarding plugins.
+#
+# @see https://docs.docker.com/engine/api/v1.40/#tag/Plugin
+class Docker::API::Plugin < Docker::API::Base
+
+    # List plugins
+    #
+    # Docker API: GET /plugins
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginList
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def list params = {}
+        validate Docker::API::InvalidParameter, [:filters], params
+        @connection.get(build_path("/plugins", params))
+    end
+
+    # Get plugin privileges
+    #
+    # Docker API: GET /plugins/privileges
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/GetPluginPrivileges
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def privileges params = {}
+        validate Docker::API::InvalidParameter, [:remote], params
+        @connection.get(build_path("/plugins/privileges", params))
+    end
+
+    # Install a plugin
+    #
+    # Pulls and installs a plugin. After the plugin is installed, it can be enabled using the POST /plugins/{name}/enable endpoint.
+    #
+    # Docker API: POST /plugins/pull
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginPull
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    #
+    # @param privileges [Array]: Plugin privileges to be sent as json in request body.
+    #
+    # @param authentication [Hash]: Authentication parameters.
+    def install params = {}, privileges = [], authentication = {}
+        validate Docker::API::InvalidParameter, [:remote, :name], params
+        headers = {"Content-Type": "application/json"}
+        headers.merge!({"X-Registry-Auth" => Base64.urlsafe_encode64(authentication.to_json.to_s)}) if authentication.keys.size > 0
+        @connection.request(method: :post, path: build_path("/plugins/pull", params), headers: headers, body: privileges.to_json )
+    end
+
+    # Inspect a plugin
+    #
+    # Docker API: GET /plugins/{name}/json
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginInspect
+    #
+    # @param name [String]: The ID or name of the plugin.
+    def details name 
+        @connection.get("/plugins/#{name}/json")
+    end
+
+    # Remove a plugin
+    #
+    # Docker API: DELETE /plugins/{name}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginDelete
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def remove name, params = {}
+        validate Docker::API::InvalidParameter, [:force], params
+        @connection.delete(build_path("/plugins/#{name}",params))
+    end
+
+    # Enable a plugin
+    #
+    # Docker API: POST /plugins/{name}/enable
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginEnable
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def enable name, params = {}
+        validate Docker::API::InvalidParameter, [:timeout], params
+        @connection.post(build_path("/plugins/#{name}/enable", params))
+    end
+
+    # Disable a plugin
+    #
+    # Docker API: POST /plugins/{name}/disable
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginDisable
+    #
+    # @param name [String]: The ID or name of the plugin.
+    def disable name
+        @connection.post("/plugins/#{name}/disable")
+    end
+
+    # Upgrade a plugin
+    #
+    # Docker API: POST /plugins/{name}/upgrade
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginUpgrade
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    #
+    # @param privileges [Array]: Plugin privileges to be sent as json in request body.
+    #
+    # @param authentication [Hash]: Authentication parameters.
+    def upgrade name, params = {}, privileges = [], authentication = {}
+        validate Docker::API::InvalidParameter, [:remote], params
+        headers = {"Content-Type": "application/json"}
+        headers.merge!({"X-Registry-Auth" => Base64.urlsafe_encode64(authentication.to_json.to_s)}) if authentication.keys.size > 0
+        @connection.request(method: :post, path: build_path("/plugins/#{name}/upgrade", params), headers: headers, body: privileges.to_json )
+    end
+
+    # Create a plugin
+    #
+    # Docker API: POST /plugins/create
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginCreate
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param path [String]: Path to tar file that contains rootfs folder and config.json file.
+    def create name, path
+        file = File.open( File.expand_path( path ) , "r")
+        response = @connection.request(method: :post, path: "/plugins/create?name=#{name}", body: file.read.to_s )
+        file.close        
+        response
+    end
+
+    # Push a plugin to the registry.
+    #
+    # Docker API: POST /plugins/{name}/push
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginPush
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param authentication [Hash]: Authentication parameters.
+    def push name, authentication = {}
+        if authentication.keys.size > 0
+            @connection.request(method: :post, path: "/plugins/#{name}/push", headers: {"X-Registry-Auth" => Base64.urlsafe_encode64(authentication.to_json.to_s)})
+        else
+            @connection.post("/plugins/#{name}/push")
+        end
+    end
+
+    # Configure a plugin
+    #
+    # Docker API: POST /plugins/{name}/set
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/PluginSet
+    #
+    # @param name [String]: The ID or name of the plugin.
+    #
+    # @param config [Array]: Plugin configuration to be sent as json in request body.
+    def configure name, config
+        @connection.request(method: :post, path: "/plugins/#{name}/set", headers: {"Content-Type": "application/json"}, body:config.to_json)
+    end
+
+end

data/lib/docker/api/secret.rb

@@ -0,0 +1,70 @@
+# This class represents the Docker API endpoints regarding secrets.
+#
+# @see https://docs.docker.com/engine/api/v1.40/#tag/Secret
+#
+# Secrets are sensitive data that can be used by services. Swarm mode must be enabled for these endpoints to work.
+class Docker::API::Secret < Docker::API::Base
+
+    # List secrets
+    #
+    # Docker API: GET /secrets
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/SecretList
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def list params = {}
+        validate Docker::API::InvalidParameter, [:filters], params
+        @connection.get(build_path("/secrets",params))
+    end
+
+    # Create a secret
+    #
+    # Docker API: POST /secrets/create
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/SecretCreate
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    def create body = {}
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :Data, :Driver, :Templating], body
+        @connection.request(method: :post, path: "/secrets/create", headers: {"Content-Type": "application/json"}, body: body.to_json)
+    end
+
+    # Inspect a secret
+    #
+    # Docker API: GET /secrets/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/SecretInspect
+    #
+    # @param name [String]: The ID or name of the secret.
+    def details name
+        @connection.get("/secrets/#{name}")
+    end
+
+    # Update a secret
+    #
+    # Docker API: POST /secrets/{id}/update
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/SecretUpdate
+    #
+    # @param name [String]: The ID or name of the secret.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    def update name, params = {}, body = {}
+        validate Docker::API::InvalidParameter, [:version], params
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :Data, :Driver, :Templating], body
+        @connection.request(method: :post, path: build_path("/secrets/#{name}/update",params), headers: {"Content-Type": "application/json"}, body: body.to_json)
+    end
+
+    # Delete a secret
+    #
+    # Docker API: DELETE /secrets/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/SecretDelete
+    #
+    # @param name [String]: The ID or name of the secret.
+    def delete name
+        @connection.delete("/secrets/#{name}")
+    end
+end

data/lib/docker/api/service.rb

@@ -0,0 +1,98 @@
+# This class represents the Docker API endpoints regarding services.
+#
+# @see https://docs.docker.com/engine/api/v1.40/#tag/Service
+#
+# Services are the definitions of tasks to run on a swarm. Swarm mode must be enabled for these endpoints to work.
+class Docker::API::Service < Docker::API::Base
+
+    # List services
+    #
+    # Docker API: GET /services
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceList
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def list params = {}
+        validate Docker::API::InvalidParameter, [:filters], params
+        @connection.get(build_path("/services", params))
+    end
+
+    # Create a service
+    #
+    # Docker API: POST /services/create
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceCreate
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    #
+    # @param authentication [Hash]: Authentication parameters.
+    def create body = {}, authentication = {}
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :TaskTemplate, :Mode, :UpdateConfig, :RollbackConfig, :Networks, :EndpointSpec], body
+        headers = {"Content-Type": "application/json"}
+        headers.merge!({"X-Registry-Auth" => Base64.urlsafe_encode64(authentication.to_json.to_s)}) if authentication.keys.size > 0
+        @connection.request(method: :post, path: "/services/create", headers: headers, body: body.to_json)
+    end
+
+    # Update a service
+    #
+    # Docker API: POST /services/{id}/update
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceUpdate
+    #
+    # @param name [String]: The ID or name of the service.
+    #
+    # @param params [Hash]:  Parameters that are appended to the URL.
+    #
+    # @param body [Hash]: Request body to be sent as json.
+    #
+    # @param authentication [Hash]:  Authentication parameters.
+    def update name, params = {}, body = {}, authentication = {}
+        # view https://github.com/docker/swarmkit/issues/1394#issuecomment-240850719
+        validate Docker::API::InvalidParameter, [:version, :registryAuthFrom, :rollback], params
+        validate Docker::API::InvalidRequestBody, [:Name, :Labels, :TaskTemplate, :Mode, :UpdateConfig, :RollbackConfig, :Networks, :EndpointSpec], body
+        headers = {"Content-Type": "application/json"}
+        headers.merge!({"X-Registry-Auth" => Base64.urlsafe_encode64(authentication.to_json.to_s)}) if authentication.keys.size > 0
+        @connection.request(method: :post, path: build_path("/services/#{name}/update", params), headers: headers, body: body.to_json)
+    end
+
+    # Inspect a service
+    #
+    # Docker API: GET /services/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceInspect
+    #
+    # @param name [String]: The ID or name of the service.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL. 
+    def details name, params = {}
+        validate Docker::API::InvalidParameter, [:insertDefaults], params
+        @connection.get(build_path("/services/#{name}", params))
+    end
+
+    # Get stdout and stderr logs from a service. 
+    #
+    # Note: This endpoint works only for services with the local, json-file or journald logging drivers.
+    #
+    # Docker API: GET /services/{id}/logs
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceLogs
+    #
+    # @param name [String]: The ID or name of the service.
+    #
+    # @param params [Hash]: Parameters that are appended to the URL. 
+    def logs name, params = {}
+        validate Docker::API::InvalidParameter, [:details, :follow, :stdout, :stderr, :since, :timestamps, :tail], params
+        @connection.get(build_path("/services/#{name}/logs", params))
+    end
+
+    # Delete a service
+    #
+    # Docker API: DELETE /services/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/ServiceDelete
+    #
+    # @param name [String]: The ID or name of the service.
+    def delete name
+        @connection.delete("/services/#{name}")
+    end
+end

data/lib/docker/api/swarm.rb

@@ -13,7 +13,7 @@ module Docker
                 @connection.request(method: :post, path: build_path("/swarm/update", params), headers: {"Content-Type": "application/json"}, body: body.to_json)
             end
 
-            def inspect
+            def details
                 @connection.get("/swarm")
             end
 
@@ -35,6 +35,17 @@ module Docker
                 validate Docker::API::InvalidParameter, [:force], params
                 @connection.post(build_path("/swarm/leave", params))
             end
+
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def inspect
+                caller.each { | el | return super.inspect if el.match(/inspector/) }
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                details
+            end
+            #################################################
+            
         end
     end
 end

data/lib/docker/api/task.rb

@@ -0,0 +1,46 @@
+# This class represents the Docker API endpoints regarding tasks.
+#
+# @see https://docs.docker.com/engine/api/v1.40/#tag/Task
+#
+# A task is a container running on a swarm. It is the atomic scheduling unit of swarm. Swarm mode must be enabled for these endpoints to work.
+class Docker::API::Task < Docker::API::Base
+
+    # List tasks
+    #
+    # Docker API: GET /tasks
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/TaskList
+    #
+    # @param params [Hash]: Parameters that are appended to the URL.
+    def list params = {}
+        validate Docker::API::InvalidParameter, [:filters], params
+        @connection.get(build_path("/tasks",params))
+    end
+
+    # Inspect a task
+    #
+    # Docker API: GET /tasks/{id}
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/TaskInspect
+    #
+    # @param name [String]: The ID or name of the task.
+    def details name
+        @connection.get("/tasks/#{name}")
+    end
+
+    # Get stdout and stderr logs from a task.
+    #
+    # Note: This endpoint works only for services with the local, json-file or journald logging drivers.
+    #
+    # Docker API: GET /tasks/{id}/logs
+    #
+    # @see https://docs.docker.com/engine/api/v1.40/#operation/TaskLogs
+    #
+    # @param name (String) : The ID or name of the task.
+    #
+    # @param params (Hash) : Parameters that are appended to the URL.
+    def logs name, params = {}
+        validate Docker::API::InvalidParameter, [:details, :follow, :stdout, :stderr, :since, :timestamps, :tail], params
+        @connection.get(build_path("/tasks/#{name}/logs", params))
+    end
+end

data/lib/docker/api/version.rb

@@ -1,6 +1,6 @@
 module Docker
   module API
-    GEM_VERSION = "0.8.0"
+    GEM_VERSION = "0.12.0"
 
     API_VERSION = "1.40"
 

data/lib/docker/api/volume.rb

@@ -1,24 +1,21 @@
 module Docker
     module API
         class Volume < Docker::API::Base
-            def base_path
-                "/volumes"
-            end
 
             def list params = {}
                 validate Docker::API::InvalidParameter, [:filters], params
                 @connection.get(build_path("/volumes", params))
             end
 
+            def details name
+                @connection.get(build_path([name]))
+            end
+
             def create body = {}
                 validate Docker::API::InvalidRequestBody, [:Name, :Driver, :DriverOpts, :Labels], body
                 @connection.request(method: :post, path: build_path(["create"]), headers: {"Content-Type": "application/json"}, body: body.to_json)
             end
 
-            def inspect name
-                @connection.get(build_path([name]))
-            end
-
             def remove name, params = {}
                 validate Docker::API::InvalidParameter, [:force], params
                 @connection.delete(build_path([name]))
@@ -29,6 +26,21 @@ module Docker
                 @connection.post(build_path(["prune"], params))
             end
 
+            #################################################
+            # Items in this area to be removed before 1.0.0 #
+            #################################################
+            def base_path
+                "/volumes"
+            end
+
+            def inspect *args
+                return super.inspect if args.size == 0
+                warn  "WARNING: #inspect is deprecated and will be removed in the future, please use #details instead."
+                name = args[0]
+                @connection.get(build_path([name]))
+            end
+            #################################################
+
         end
     end
 end

data/lib/dockerapi.rb

@@ -14,6 +14,11 @@ require "docker/api/exec"
 require "docker/api/system"
 require "docker/api/swarm"
 require "docker/api/node"
+require "docker/api/service"
+require "docker/api/task"
+require "docker/api/secret"
+require "docker/api/config"
+require "docker/api/plugin"
 
 module Docker
   module API

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dockerapi
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Alysson A. Costa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-08 00:00:00.000000000 Z
+date: 2020-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: excon
@@ -44,6 +44,7 @@ files:
 - bin/setup
 - dockerapi.gemspec
 - lib/docker/api/base.rb
+- lib/docker/api/config.rb
 - lib/docker/api/connection.rb
 - lib/docker/api/container.rb
 - lib/docker/api/error.rb
@@ -51,9 +52,13 @@ files:
 - lib/docker/api/image.rb
 - lib/docker/api/network.rb
 - lib/docker/api/node.rb
+- lib/docker/api/plugin.rb
 - lib/docker/api/response.rb
+- lib/docker/api/secret.rb
+- lib/docker/api/service.rb
 - lib/docker/api/swarm.rb
 - lib/docker/api/system.rb
+- lib/docker/api/task.rb
 - lib/docker/api/version.rb
 - lib/docker/api/volume.rb
 - lib/dockerapi.rb