Add v1.28 API

docker · johndmulhausen · Apr 14, 2017 · Apr 11, 2017 · Apr 13, 2017 · Apr 13, 2017
commit 245340a05353e3690d4596740a18e8077757ed97
diff --git a/_data/toc.yaml b/_data/toc.yaml
@@ -29,9 +29,6 @@ guides:
     - path: /edge/engine/reference/commandline/docker/
       title: Docker Edge CLI reference
       nosync: true
-    - path: /edge/engine/api/v1.28/
-      title: v1.28 Reference (Docker CE Edge)
-      nosync: true
   - path: /docker-for-mac/install/
     title: Docker for Mac
   - path: /docker-for-windows/install/
@@ -496,9 +493,8 @@ reference:
     title: Getting started
   - path: /engine/api/sdks/
     title: SDKs
-  - path: /edge/engine/api/v1.28/
-    title: v1.28 Reference (Docker CE Edge)
-    nosync: true
+  - path: /engine/api/v1.28/
+    title: v1.28 Reference
   - path: /engine/api/v1.27/
     title: v1.27 Reference
   - sectiontitle: Previous API versions
@@ -853,10 +849,6 @@ reference:
     title: docker wait
 - title: Edge Daemon CLI reference (dockerd)
   path: /edge/engine/reference/commandline/dockerd/
-- sectiontitle: Docker Edge Engine API
-  section:
-  - path: /edge/engine/api/v1.28/
-    title: v1.28 API Reference
 - sectiontitle: Docker Edge Engine (docker) CLI
   section:
   - path: /edge/engine/reference/run/

diff --git a/_scripts/fetch-upstream-resources.sh b/_scripts/fetch-upstream-resources.sh
@@ -25,9 +25,10 @@ wget -O md_source/engine/api/v1.25/swagger.yaml https://raw.githubusercontent.co
 wget -O md_source/engine/api/v1.26/swagger.yaml https://raw.githubusercontent.com/docker/docker/v17.03.0-ce/api/swagger.yaml || (echo "Failed 1.26 swagger download" && exit -1)
 wget -O md_source/engine/api/v1.27/swagger.yaml https://raw.githubusercontent.com/docker/docker/v17.03.1-ce/api/swagger.yaml || (echo "Failed 1.27 swagger download" && exit -1)
 
-# Get the Edge API Swagger (it goes to a slightly different location)
-mkdir -p md_source/edge/engine/api/v1.28 \
-&& wget -O md_source/edge/engine/api/v1.28/swagger.yaml https://raw.githubusercontent.com/docker/docker/v17.04.0-ce/api/swagger.yaml || (echo "Failed 1.28 swagger download" && exit -1)
+# Get the Edge API Swagger (we only keep the latest one of these
+# When you change this you need to make sure to copy the previous
+# directory into a new one in the docs git and change the index.html
+wget -O md_source/engine/api/v1.28/swagger.yaml https://raw.githubusercontent.com/docker/docker/v17.04.0-ce/api/swagger.yaml || (echo "Failed 1.28 swagger download or the 1.28 directory doesn't exist" && exit -1)
 
 # Get a few one-off files that we use directly from upstream
 wget -O md_source/engine/reference/builder.md https://raw.githubusercontent.com/docker/docker/"$ENGINE_BRANCH"/docs/reference/builder.md || (echo "Failed engine/reference/builder.md download" && exit -1)

diff --git a/engine/api/v1.28/index.html b/engine/api/v1.28/index.html
@@ -0,0 +1,37 @@
+---
+layout: null
+redirect_from:
+  - /engine/reference/api/docker_remote_api_v1.28/
+---
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Docker Engine API v1.28 Reference</title>
+    <!-- needed for adaptive design -->
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="description" content="Reference for the API served by Docker Engine.">
+    <meta charset="utf-8"/>
+    <!--
+    ReDoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+      api-logo {
+        background-image: linear-gradient(0deg, #15A4D7 0%, #1488C6 100%);
+        height: 100px;
+        text-align: left !important;
+      }
+      api-logo img {
+        width: 136px !important;
+        margin: 32px 0 0 50px;
+      }
+    </style>
+  </head>
+  <body>
+    <redoc spec-url="swagger.yaml" hide-hostname="true" suppress-warnings="true" lazy-rendering></redoc>
+    <script src="redoc.1.11.0.min.js"> </script>
+  </body>
+</html>
diff --git a/engine/api/v1.28/redoc.1.11.0.min.js b/engine/api/v1.28/redoc.1.11.0.min.js