Generate 1.34 version

Author: joelwurtz

composer.json

@@ -24,7 +24,7 @@
     },
     "extra": {
         "branch-alias": {
-            "4.1.33": "4.1.33.x-dev"
+            "4.1.34": "4.1.34.x-dev"
         }
     },
     "minimum-stability": "dev",

docker-swagger.yaml

@@ -19,10 +19,10 @@ produces:
 consumes:
   - "application/json"
   - "text/plain"
-basePath: "/v1.33"
+basePath: "/v1.34"
 info:
   title: "Docker Engine API"
-  version: "1.33"
+  version: "1.34"
   x-logo:
     url: "https://docs.docker.com/images/logo-docker-main.png"
   description: |
@@ -44,19 +44,22 @@ info:
 
     The API is usually changed in each release of Docker, so API calls are versioned to ensure that clients don't break.
 
-    For Docker Engine 17.09, the API version is 1.32. To lock to this version, you prefix the URL with `/v1.32`. For example, calling `/info` is the same as calling `/v1.32/info`.
+    For Docker Engine 17.10, the API version is 1.33. To lock to this version, you prefix the URL with `/v1.33`. For example, calling `/info` is the same as calling `/v1.33/info`.
 
     Engine releases in the near future should support this version of the API, so your client will continue to work even if it is talking to a newer Engine.
 
     In previous versions of Docker, it was possible to access the API without providing a version. This behaviour is now deprecated will be removed in a future version of Docker.
 
+    If the API version specified in the URL is not supported by the daemon, a HTTP `400 Bad Request` error message is returned.
+
     The API uses an open schema model, which means server may add extra properties to responses. Likewise, the server will ignore any extra query parameters and request body properties. When you write clients, you need to ignore additional properties in responses to ensure they do not break when talking to newer Docker daemons.
 
-    This documentation is for version 1.33 of the API. Use this table to find documentation for previous versions of the API:
+    This documentation is for version 1.34 of the API. Use this table to find documentation for previous versions of the API:
 
     Docker version  | API version | Changes
     ----------------|-------------|---------
-    17.09.x | [1.31](https://docs.docker.com/engine/api/v1.32/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-32-api-changes)
+    17.10.x | [1.33](https://docs.docker.com/engine/api/v1.33/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-33-api-changes)
+    17.09.x | [1.32](https://docs.docker.com/engine/api/v1.32/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-32-api-changes)
     17.07.x | [1.31](https://docs.docker.com/engine/api/v1.31/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-31-api-changes)
     17.06.x | [1.30](https://docs.docker.com/engine/api/v1.30/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-30-api-changes)
     17.05.x | [1.29](https://docs.docker.com/engine/api/v1.29/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-29-api-changes)
@@ -719,7 +722,15 @@ definitions:
             description: "Gives the container full access to the host."
           PublishAllPorts:
             type: "boolean"
-            description: "Allocates a random host port for all of a container's exposed ports."
+            description: |
+              Allocates an ephemeral host port for all of a container's
+              exposed ports.
+
+              Ports are de-allocated when the container stops and allocated when the container starts.
+              The allocated port might be changed when restarting the container.
+
+              The port is selected from the ephemeral port range that depends on the kernel.
+              For example, on Linux the range is defined by `/proc/sys/net/ipv4/ip_local_port_range`.
           ReadonlyRootfs:
             type: "boolean"
             description: "Mount the container's root filesystem as read only."
@@ -3041,6 +3052,24 @@ definitions:
       PublishedPort:
         description: "The port on the swarm hosts."
         type: "integer"
+      PublishMode:
+        description: |
+          The mode in which port is published.
+
+          <p><br /></p>
+
+          - "ingress" makes the target port accessible on on every node,
+            regardless of whether there is a task for the service running on
+            that node or not.
+          - "host" bypasses the routing mesh and publish the port directly on
+            the swarm node where that service is running.
+
+        type: "string"
+        enum:
+          - "ingress"
+          - "host"
+        default: "ingress"
+        example: "ingress"
 
   EndpointSpec:
     description: "Properties that can be configured to access and load balance a service."
@@ -5701,6 +5730,13 @@ paths:
                 description: "Exit code of the container"
                 type: "integer"
                 x-nullable: false
+              Error:
+                description: "container waiting error, if any"
+                type: "object"
+                properties:
+                  Message:
+                    description: "Details of an error"
+                    type: "string"
         404:
           description: "no such container"
           schema:
@@ -6158,6 +6194,11 @@ paths:
 
             Only the registry domain name (and port if not the default 443) are required. However, for legacy reasons, the Docker Hub registry must be specified with both a `https://` prefix and a `/v1/` suffix even though Docker will prefer to use the v2 registry API.
           type: "string"
+        - name: "platform"
+          in: "query"
+          description: "Platform in the format os[/arch[/variant]]"
+          type: "string"
+          default: ""
       responses:
         200:
           description: "no error"
@@ -6239,6 +6280,11 @@ paths:
           in: "header"
           description: "A base64-encoded auth configuration. [See the authentication section for details.](#section/Authentication)"
           type: "string"
+        - name: "platform"
+          in: "query"
+          description: "Platform in the format os[/arch[/variant]]"
+          type: "string"
+          default: ""
       tags: ["Image"]
   /images/{name}/json:
     get:
@@ -9928,4 +9974,4 @@ paths:
           description: "server error"
           schema:
             $ref: "#/definitions/ErrorResponse"
-      tags: ["Session (experimental)"]
+      tags: ["Session (experimental)"]

src/Client.php

@@ -34,7 +34,7 @@ public static function create($httpClient = null)
         if (null === $httpClient) {
             $httpClient = \Http\Discovery\HttpClientDiscovery::find();
             $plugins = [];
-            $uri = \Http\Discovery\UriFactoryDiscovery::find()->createUri('v1.33');
+            $uri = \Http\Discovery\UriFactoryDiscovery::find()->createUri('v1.34');
             $plugins[] = new \Http\Client\Common\Plugin\AddPathPlugin($uri);
             $httpClient = new \Http\Client\Common\PluginClient($httpClient, $plugins);
         }

src/Model/ContainersIdWaitPostResponse200.php

@@ -18,6 +18,12 @@ class ContainersIdWaitPostResponse200
      * @var int
      */
     protected $statusCode;
+    /**
+     * container waiting error, if any.
+     *
+     * @var ContainersIdWaitPostResponse200Error
+     */
+    protected $error;
 
     /**
      * Exit code of the container.
@@ -42,4 +48,28 @@ public function setStatusCode(?int $statusCode): self
 
         return $this;
     }
+
+    /**
+     * container waiting error, if any.
+     *
+     * @return ContainersIdWaitPostResponse200Error
+     */
+    public function getError(): ?ContainersIdWaitPostResponse200Error
+    {
+        return $this->error;
+    }
+
+    /**
+     * container waiting error, if any.
+     *
+     * @param ContainersIdWaitPostResponse200Error $error
+     *
+     * @return self
+     */
+    public function setError(?ContainersIdWaitPostResponse200Error $error): self
+    {
+        $this->error = $error;
+
+        return $this;
+    }
 }

src/Model/ContainersIdWaitPostResponse200Error.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file has been auto generated by Jane,
+ *
+ * Do no edit it directly.
+ */
+
+namespace Docker\API\Model;
+
+class ContainersIdWaitPostResponse200Error
+{
+    /**
+     * Details of an error.
+     *
+     * @var string
+     */
+    protected $message;
+
+    /**
+     * Details of an error.
+     *
+     * @return string
+     */
+    public function getMessage(): ?string
+    {
+        return $this->message;
+    }
+
+    /**
+     * Details of an error.
+     *
+     * @param string $message
+     *
+     * @return self
+     */
+    public function setMessage(?string $message): self
+    {
+        $this->message = $message;
+
+        return $this;
+    }
+}

src/Model/EndpointPortConfig.php

@@ -32,6 +32,21 @@ class EndpointPortConfig
      * @var int
      */
     protected $publishedPort;
+    /**
+     * The mode in which port is published.
+
+    <p><br /></p>
+
+    - "ingress" makes the target port accessible on on every node,
+     regardless of whether there is a task for the service running on
+     that node or not.
+    - "host" bypasses the routing mesh and publish the port directly on
+     the swarm node where that service is running.
+
+     *
+     * @var string
+     */
+    protected $publishMode;
 
     /**
      * @return string
@@ -120,4 +135,46 @@ public function setPublishedPort(?int $publishedPort): self
 
         return $this;
     }
+
+    /**
+     * The mode in which port is published.
+
+    <p><br /></p>
+
+    - "ingress" makes the target port accessible on on every node,
+     regardless of whether there is a task for the service running on
+     that node or not.
+    - "host" bypasses the routing mesh and publish the port directly on
+     the swarm node where that service is running.
+
+     *
+     * @return string
+     */
+    public function getPublishMode(): ?string
+    {
+        return $this->publishMode;
+    }
+
+    /**
+     * The mode in which port is published.
+
+    <p><br /></p>
+
+    - "ingress" makes the target port accessible on on every node,
+     regardless of whether there is a task for the service running on
+     that node or not.
+    - "host" bypasses the routing mesh and publish the port directly on
+     the swarm node where that service is running.
+
+     *
+     * @param string $publishMode
+     *
+     * @return self
+     */
+    public function setPublishMode(?string $publishMode): self
+    {
+        $this->publishMode = $publishMode;
+
+        return $this;
+    }
 }

src/Model/HostConfig.php

@@ -360,7 +360,15 @@ class HostConfig
      */
     protected $privileged;
     /**
-     * Allocates a random host port for all of a container's exposed ports.
+     * Allocates an ephemeral host port for all of a container's.
+    exposed ports.
+
+    Ports are de-allocated when the container stops and allocated when the container starts.
+    The allocated port might be changed when restarting the container.
+
+    The port is selected from the ephemeral port range that depends on the kernel.
+    For example, on Linux the range is defined by `/proc/sys/net/ipv4/ip_local_port_range`.
+
      *
      * @var bool
      */
@@ -1763,7 +1771,15 @@ public function setPrivileged(?bool $privileged): self
     }
 
     /**
-     * Allocates a random host port for all of a container's exposed ports.
+     * Allocates an ephemeral host port for all of a container's.
+    exposed ports.
+
+    Ports are de-allocated when the container stops and allocated when the container starts.
+    The allocated port might be changed when restarting the container.
+
+    The port is selected from the ephemeral port range that depends on the kernel.
+    For example, on Linux the range is defined by `/proc/sys/net/ipv4/ip_local_port_range`.
+
      *
      * @return bool
      */
@@ -1773,7 +1789,15 @@ public function getPublishAllPorts(): ?bool
     }
 
     /**
-     * Allocates a random host port for all of a container's exposed ports.
+     * Allocates an ephemeral host port for all of a container's.
+    exposed ports.
+
+    Ports are de-allocated when the container stops and allocated when the container starts.
+    The allocated port might be changed when restarting the container.
+
+    The port is selected from the ephemeral port range that depends on the kernel.
+    For example, on Linux the range is defined by `/proc/sys/net/ipv4/ip_local_port_range`.
+
      *
      * @param bool $publishAllPorts
      *