From fd90733972c6e78a0871b068e01e29ae1ac97fd7 Mon Sep 17 00:00:00 2001
From: Sebastiaan van Stijn <github@gone.nl>
Date: Wed, 4 Oct 2017 15:34:08 +0200
Subject: [PATCH] Add PortConfig.PublishMode to API documentation

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
---
 api/swagger.yaml | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/api/swagger.yaml b/api/swagger.yaml
index 590b378451..1e300e7b40 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -3042,6 +3042,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."