docker-engine 0.1.1 → 0.2.0

data/lib/docker_engine/resources/services.rb

@@ -16,7 +16,7 @@ module DockerEngine
       #
       # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [DockerEngine::Models::ServiceCreateResponse]
+      # @return [DockerEngine::Models::CreateResponse]
       #
       # @see DockerEngine::Models::ServiceCreateParams
       def create(params)
@@ -26,7 +26,45 @@ module DockerEngine
           path: "services/create",
           headers: parsed.except(:spec).transform_keys(x_registry_auth: "x-registry-auth"),
           body: parsed[:spec],
-          model: DockerEngine::Models::ServiceCreateResponse,
+          model: DockerEngine::CreateResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::ServiceUpdateParams} for more details.
+      #
+      # Update a service
+      #
+      # @overload update(id, version:, spec:, registry_auth_from: nil, rollback: nil, x_registry_auth: nil, request_options: {})
+      #
+      # @param id [String] Path param: ID or name of service.
+      #
+      # @param version [Integer] Query param: The version number of the service object being updated. This is
+      #
+      # @param spec [DockerEngine::Models::ServiceUpdateParams::Spec] Body param: User modifiable configuration for a service.
+      #
+      # @param registry_auth_from [Symbol, DockerEngine::Models::ServiceUpdateParams::RegistryAuthFrom] Query param: If the `X-Registry-Auth` header is not specified, this parameter
+      #
+      # @param rollback [String] Query param: Set to this parameter to `previous` to cause a server-side rollback
+      #
+      # @param x_registry_auth [String] Header param: A base64url-encoded auth configuration for pulling from private
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::UpdateResponse]
+      #
+      # @see DockerEngine::Models::ServiceUpdateParams
+      def update(id, params)
+        parsed, options = DockerEngine::ServiceUpdateParams.dump_request(params)
+        query_params = [:version, :registry_auth_from, :rollback]
+        @client.request(
+          method: :post,
+          path: ["services/%1$s/update", id],
+          query: parsed.slice(*query_params).transform_keys(registry_auth_from: "registryAuthFrom"),
+          headers: parsed.except(:spec, *query_params).transform_keys(x_registry_auth: "x-registry-auth"),
+          body: parsed[:spec],
+          model: DockerEngine::UpdateResponse,
           options: options
         )
       end
@@ -102,6 +140,50 @@ module DockerEngine
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::ServiceLogsParams} for more details.
+      #
+      # Get `stdout` and `stderr` logs from a service. See also
+      # [`/containers/{id}/logs`](#operation/ContainerLogs).
+      #
+      # **Note**: This endpoint works only for services with the `local`, `json-file` or
+      # `journald` logging drivers.
+      #
+      # @overload logs(id, details: nil, follow: nil, since: nil, stderr: nil, stdout: nil, tail: nil, timestamps: nil, request_options: {})
+      #
+      # @param id [String] ID or name of the service
+      #
+      # @param details [Boolean] Show service context and extra details provided to logs.
+      #
+      # @param follow [Boolean] Keep connection after returning logs.
+      #
+      # @param since [Integer] Only return logs since this time, as a UNIX timestamp
+      #
+      # @param stderr [Boolean] Return logs from `stderr`
+      #
+      # @param stdout [Boolean] Return logs from `stdout`
+      #
+      # @param tail [String] Only return this number of log lines from the end of the logs.
+      #
+      # @param timestamps [Boolean] Add timestamps to every log line
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [StringIO]
+      #
+      # @see DockerEngine::Models::ServiceLogsParams
+      def logs(id, params = {})
+        parsed, options = DockerEngine::ServiceLogsParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["services/%1$s/logs", id],
+          query: parsed,
+          headers: {"accept" => "application/vnd.docker.multiplexed-stream"},
+          model: StringIO,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [DockerEngine::Client]

data/lib/docker_engine/resources/swarm.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module DockerEngine
+  module Resources
+    class Swarm
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SwarmUpdateParams} for more details.
+      #
+      # Update a swarm
+      #
+      # @overload update(version:, spec:, rotate_manager_token: nil, rotate_manager_unlock_key: nil, rotate_worker_token: nil, request_options: {})
+      #
+      # @param version [Integer] Query param: The version number of the swarm object being updated. This is
+      #
+      # @param spec [DockerEngine::Models::Spec] Body param: User modifiable swarm configuration.
+      #
+      # @param rotate_manager_token [Boolean] Query param: Rotate the manager join token.
+      #
+      # @param rotate_manager_unlock_key [Boolean] Query param: Rotate the manager unlock key.
+      #
+      # @param rotate_worker_token [Boolean] Query param: Rotate the worker join token.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see DockerEngine::Models::SwarmUpdateParams
+      def update(params)
+        parsed, options = DockerEngine::SwarmUpdateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "swarm/update",
+          query: parsed.except(:spec).transform_keys(
+            rotate_manager_token: "rotateManagerToken",
+            rotate_manager_unlock_key: "rotateManagerUnlockKey",
+            rotate_worker_token: "rotateWorkerToken"
+          ),
+          body: parsed[:spec],
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SwarmInitParams} for more details.
+      #
+      # Initialize a new swarm
+      #
+      # @overload init(advertise_addr: nil, data_path_addr: nil, data_path_port: nil, default_addr_pool: nil, force_new_cluster: nil, listen_addr: nil, spec: nil, subnet_size: nil, request_options: {})
+      #
+      # @param advertise_addr [String] Externally reachable address advertised to other nodes. This
+      #
+      # @param data_path_addr [String] Address or interface to use for data path traffic (format:
+      #
+      # @param data_path_port [Integer] DataPathPort specifies the data path port number for data traffic.
+      #
+      # @param default_addr_pool [Array<String>] Default Address Pool specifies default subnet pools for global
+      #
+      # @param force_new_cluster [Boolean] Force creation of a new swarm.
+      #
+      # @param listen_addr [String] Listen address used for inter-manager communication, as well
+      #
+      # @param spec [DockerEngine::Models::Spec] User modifiable swarm configuration.
+      #
+      # @param subnet_size [Integer] SubnetSize specifies the subnet size of the networks created
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [String]
+      #
+      # @see DockerEngine::Models::SwarmInitParams
+      def init(params = {})
+        parsed, options = DockerEngine::SwarmInitParams.dump_request(params)
+        @client.request(method: :post, path: "swarm/init", body: parsed, model: String, options: options)
+      end
+
+      # Inspect swarm
+      #
+      # @overload inspect_(request_options: {})
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::SwarmAPI]
+      #
+      # @see DockerEngine::Models::SwarmInspectParams
+      def inspect_(params = {})
+        @client.request(
+          method: :get,
+          path: "swarm",
+          model: DockerEngine::SwarmAPI,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SwarmJoinParams} for more details.
+      #
+      # Join an existing swarm
+      #
+      # @overload join(advertise_addr: nil, data_path_addr: nil, join_token: nil, listen_addr: nil, remote_addrs: nil, request_options: {})
+      #
+      # @param advertise_addr [String] Externally reachable address advertised to other nodes. This
+      #
+      # @param data_path_addr [String] Address or interface to use for data path traffic (format:
+      #
+      # @param join_token [String] Secret token for joining this swarm.
+      #
+      # @param listen_addr [String] Listen address used for inter-manager communication if the node
+      #
+      # @param remote_addrs [Array<String>] Addresses of manager nodes already participating in the swarm.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see DockerEngine::Models::SwarmJoinParams
+      def join(params = {})
+        parsed, options = DockerEngine::SwarmJoinParams.dump_request(params)
+        @client.request(method: :post, path: "swarm/join", body: parsed, model: NilClass, options: options)
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SwarmLeaveParams} for more details.
+      #
+      # Leave a swarm
+      #
+      # @overload leave(force: nil, request_options: {})
+      #
+      # @param force [Boolean] Force leave swarm, even if this is the last manager or that it will
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see DockerEngine::Models::SwarmLeaveParams
+      def leave(params = {})
+        parsed, options = DockerEngine::SwarmLeaveParams.dump_request(params)
+        @client.request(method: :post, path: "swarm/leave", query: parsed, model: NilClass, options: options)
+      end
+
+      # Unlock a locked manager
+      #
+      # @overload unlock(unlock_key: nil, request_options: {})
+      #
+      # @param unlock_key [String] The swarm's unlock key.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see DockerEngine::Models::SwarmUnlockParams
+      def unlock(params = {})
+        parsed, options = DockerEngine::SwarmUnlockParams.dump_request(params)
+        @client.request(method: :post, path: "swarm/unlock", body: parsed, model: NilClass, options: options)
+      end
+
+      # Get the unlock key
+      #
+      # @overload unlock_key(request_options: {})
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::SwarmUnlockKeyResponse]
+      #
+      # @see DockerEngine::Models::SwarmUnlockKeyParams
+      def unlock_key(params = {})
+        @client.request(
+          method: :get,
+          path: "swarm/unlockkey",
+          model: DockerEngine::Models::SwarmUnlockKeyResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [DockerEngine::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/docker_engine/resources/system.rb

@@ -3,20 +3,105 @@
 module DockerEngine
   module Resources
     class System
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SystemDataUsageParams} for more details.
+      #
+      # Get data usage information
+      #
+      # @overload data_usage(type: nil, verbose: nil, request_options: {})
+      #
+      # @param type [Array<Symbol, DockerEngine::Models::SystemDataUsageParams::Type>] Object types, for which to compute and return data.
+      #
+      # @param verbose [Boolean] Show detailed information on space usage.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::SystemDataUsageResponse]
+      #
+      # @see DockerEngine::Models::SystemDataUsageParams
+      def data_usage(params = {})
+        parsed, options = DockerEngine::SystemDataUsageParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "system/df",
+          query: parsed,
+          model: DockerEngine::Models::SystemDataUsageResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::SystemEventsParams} for more details.
+      #
+      # Stream real-time events from the server.
+      #
+      # Various objects within Docker report events when something happens to them.
+      #
+      # Containers report these events: `attach`, `commit`, `copy`, `create`, `destroy`,
+      # `detach`, `die`, `exec_create`, `exec_detach`, `exec_start`, `exec_die`,
+      # `export`, `health_status`, `kill`, `oom`, `pause`, `rename`, `resize`,
+      # `restart`, `start`, `stop`, `top`, `unpause`, `update`, and `prune`
+      #
+      # Images report these events: `create`, `delete`, `import`, `load`, `pull`,
+      # `push`, `save`, `tag`, `untag`, and `prune`
+      #
+      # Volumes report these events: `create`, `mount`, `unmount`, `destroy`, and
+      # `prune`
+      #
+      # Networks report these events: `create`, `connect`, `disconnect`, `destroy`,
+      # `update`, `remove`, and `prune`
+      #
+      # The Docker daemon reports these events: `reload`
+      #
+      # Services report these events: `create`, `update`, and `remove`
+      #
+      # Nodes report these events: `create`, `update`, and `remove`
+      #
+      # Secrets report these events: `create`, `update`, and `remove`
+      #
+      # Configs report these events: `create`, `update`, and `remove`
+      #
+      # The Builder reports `prune` events
+      #
+      # @overload events(filters: nil, since: nil, until_: nil, request_options: {})
+      #
+      # @param filters [String] A JSON encoded value of filters (a `map[string][]string`) to process on the even
+      #
+      # @param since [String] Show events created since this timestamp then stream new events.
+      #
+      # @param until_ [String] Show events created until this timestamp then stop streaming.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::SystemEventsResponse]
+      #
+      # @see DockerEngine::Models::SystemEventsParams
+      def events(params = {})
+        parsed, options = DockerEngine::SystemEventsParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "events",
+          query: parsed.transform_keys(until_: "until"),
+          headers: {"accept" => "application/json-seq"},
+          model: DockerEngine::Models::SystemEventsResponse,
+          options: options
+        )
+      end
+
       # Get system information
       #
       # @overload info(request_options: {})
       #
       # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [DockerEngine::Models::SystemInfoResponse]
+      # @return [DockerEngine::Models::Info]
       #
       # @see DockerEngine::Models::SystemInfoParams
       def info(params = {})
         @client.request(
           method: :get,
           path: "info",
-          model: DockerEngine::Models::SystemInfoResponse,
+          model: DockerEngine::Info,
           options: params[:request_options]
         )
       end
@@ -47,14 +132,14 @@ module DockerEngine
       #
       # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [DockerEngine::Models::SystemVersionResponse]
+      # @return [DockerEngine::Models::Version]
       #
       # @see DockerEngine::Models::SystemVersionParams
       def version(params = {})
         @client.request(
           method: :get,
           path: "version",
-          model: DockerEngine::Models::SystemVersionResponse,
+          model: DockerEngine::Version,
           options: params[:request_options]
         )
       end

data/lib/docker_engine/resources/tasks.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module DockerEngine
+  module Resources
+    class Tasks
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::TaskListParams} for more details.
+      #
+      # List tasks
+      #
+      # @overload list(filters: nil, request_options: {})
+      #
+      # @param filters [String] A JSON encoded value of the filters (a `map[string][]string`) to
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<DockerEngine::Models::Task>]
+      #
+      # @see DockerEngine::Models::TaskListParams
+      def list(params = {})
+        parsed, options = DockerEngine::TaskListParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "tasks",
+          query: parsed,
+          model: DockerEngine::Internal::Type::ArrayOf[DockerEngine::Task],
+          options: options
+        )
+      end
+
+      # Inspect a task
+      #
+      # @overload inspect_(id, request_options: {})
+      #
+      # @param id [String] ID of the task
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::Task]
+      #
+      # @see DockerEngine::Models::TaskInspectParams
+      def inspect_(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["tasks/%1$s", id],
+          model: DockerEngine::Task,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::TaskLogsParams} for more details.
+      #
+      # Get `stdout` and `stderr` logs from a task. See also
+      # [`/containers/{id}/logs`](#operation/ContainerLogs).
+      #
+      # **Note**: This endpoint works only for services with the `local`, `json-file` or
+      # `journald` logging drivers.
+      #
+      # @overload logs(id, details: nil, follow: nil, since: nil, stderr: nil, stdout: nil, tail: nil, timestamps: nil, request_options: {})
+      #
+      # @param id [String] ID of the task
+      #
+      # @param details [Boolean] Show task context and extra details provided to logs.
+      #
+      # @param follow [Boolean] Keep connection after returning logs.
+      #
+      # @param since [Integer] Only return logs since this time, as a UNIX timestamp
+      #
+      # @param stderr [Boolean] Return logs from `stderr`
+      #
+      # @param stdout [Boolean] Return logs from `stdout`
+      #
+      # @param tail [String] Only return this number of log lines from the end of the logs.
+      #
+      # @param timestamps [Boolean] Add timestamps to every log line
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [StringIO]
+      #
+      # @see DockerEngine::Models::TaskLogsParams
+      def logs(id, params = {})
+        parsed, options = DockerEngine::TaskLogsParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: ["tasks/%1$s/logs", id],
+          query: parsed,
+          headers: {"accept" => "application/vnd.docker.multiplexed-stream"},
+          model: StringIO,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [DockerEngine::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/docker_engine/resources/volumes.rb

@@ -25,6 +25,37 @@ module DockerEngine
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::VolumeUpdateParams} for more details.
+      #
+      # "Update a volume. Valid only for Swarm cluster volumes"
+      #
+      # @overload update(name, version:, spec: nil, request_options: {})
+      #
+      # @param name [String] Path param: The name or ID of the volume
+      #
+      # @param version [Integer] Query param: The version number of the volume being updated. This is required to
+      #
+      # @param spec [DockerEngine::Models::VolumeUpdateParams::Spec] Body param: Cluster-specific options used to create the volume.
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see DockerEngine::Models::VolumeUpdateParams
+      def update(name, params)
+        parsed, options = DockerEngine::VolumeUpdateParams.dump_request(params)
+        query_params = [:version]
+        @client.request(
+          method: :put,
+          path: ["volumes/%1$s", name],
+          query: parsed.slice(*query_params),
+          body: parsed.except(*query_params),
+          model: NilClass,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {DockerEngine::Models::VolumeListParams} for more details.
       #
@@ -36,7 +67,7 @@ module DockerEngine
       #
       # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [DockerEngine::Models::VolumeListResponse]
+      # @return [DockerEngine::Models::ListResponse]
       #
       # @see DockerEngine::Models::VolumeListParams
       def list(params = {})
@@ -45,7 +76,7 @@ module DockerEngine
           method: :get,
           path: "volumes",
           query: parsed,
-          model: DockerEngine::Models::VolumeListResponse,
+          model: DockerEngine::ListResponse,
           options: options
         )
       end
@@ -94,6 +125,31 @@ module DockerEngine
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {DockerEngine::Models::VolumePruneParams} for more details.
+      #
+      # Delete unused volumes
+      #
+      # @overload prune(filters: nil, request_options: {})
+      #
+      # @param filters [String] Filters to process on the prune list, encoded as JSON (a `map[string][]string`).
+      #
+      # @param request_options [DockerEngine::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [DockerEngine::Models::VolumePruneResponse]
+      #
+      # @see DockerEngine::Models::VolumePruneParams
+      def prune(params = {})
+        parsed, options = DockerEngine::VolumePruneParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "volumes/prune",
+          query: parsed,
+          model: DockerEngine::Models::VolumePruneResponse,
+          options: options
+        )
+      end
+
       # @api private
       #
       # @param client [DockerEngine::Client]

data/lib/docker_engine/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DockerEngine
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end