dockerapi 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fa69dcb4c7b79c558bc6749b51def3a8a056e39259ad8163c84fec253193c67
-  data.tar.gz: '0998c5433ddcd3c4bbcc43ea6c21d61220527f7864c524e83bf0b3aedec501fd'
+  metadata.gz: aeb3c1971c26c62d0737576e5ec79f2abcf536b1148be5272be8f501dfcae852
+  data.tar.gz: 1392073ca52d6fecfc12e642368713c2fa44a9ebbcd7629de5fb54faf9ac7209
 SHA512:
-  metadata.gz: cafcf788d269546dd338daf50247df1ee1cf6af16372b50a2a6404b2323e0f8d6f78384789c245d122855d325e355dd9f822e4c61e5df4fb5bb9c7af79e11cac
-  data.tar.gz: b63d32250bfa09e067b56b19a2737ffc35e130511cd17dd31ffbb71db494406ff2b9e85e6e7226161e126b4d423a6fd570c3da6695dcb0d18407ce1c9a706190
+  metadata.gz: 3b03b8e5ce6d95f19c8dd6d357277a102fcc170b35ac989cd080db27c66efcad63125aaedab1c971a8ed435bed7c7447979d332a1b7f43686a2217907bf21fe8
+  data.tar.gz: 62cd2888ad859834cf949a6189f6e863e1b2f23ce9849fce4a39a1248cfa74efeaff5e0e6220a165d6b7980445a7773dc4bc3f8d4a678fc364a06b205fc07630

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+# 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:

data/Gemfile.lock

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

data/README.md

@@ -134,7 +134,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)
 
@@ -297,6 +297,37 @@ 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")
+
+```
+
 ### 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.

data/lib/docker/api/service.rb

@@ -0,0 +1,42 @@
+module Docker
+    module API
+        class Service < Docker::API::Base
+
+            def list params = {}
+                validate Docker::API::InvalidParameter, [:filters], params
+                @connection.get(build_path("/services", params))
+            end
+
+            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
+
+            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
+
+            def details name, params = {}
+                validate Docker::API::InvalidParameter, [:insertDefaults], params
+                @connection.get(build_path("/services/#{name}", params))
+            end
+
+            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
+
+            def delete name
+                @connection.delete("/services/#{name}")
+            end
+
+        end
+    end
+end

data/lib/docker/api/version.rb

@@ -1,6 +1,6 @@
 module Docker
   module API
-    GEM_VERSION = "0.9.0"
+    GEM_VERSION = "0.10.0"
 
     API_VERSION = "1.40"
 

data/lib/dockerapi.rb

@@ -14,6 +14,7 @@ require "docker/api/exec"
 require "docker/api/system"
 require "docker/api/swarm"
 require "docker/api/node"
+require "docker/api/service"
 
 module Docker
   module API

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dockerapi
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Alysson A. Costa
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-13 00:00:00.000000000 Z
+date: 2020-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: excon
@@ -52,6 +52,7 @@ files:
 - lib/docker/api/network.rb
 - lib/docker/api/node.rb
 - lib/docker/api/response.rb
+- lib/docker/api/service.rb
 - lib/docker/api/swarm.rb
 - lib/docker/api/system.rb
 - lib/docker/api/version.rb