Improve archival dockerfile (#5357)

Author: Misty Stanley-Jones

.dockerignore

@@ -1,5 +1,7 @@
 .dockerignore
 .git
+.github
+.jekyll-metadata
 .gitignore
 Dockerfile
 docker-compose.yml

Dockerfile

@@ -1,33 +1,11 @@
-FROM docs/docker.github.io:docs-base
+# Set to the version for this archive
+ARG VER=v17.06
 
-# docs-base contains: GitHub Pages, nginx, wget, svn, and the docs archives,
-# running on Alpine. See the contents of docs-base at:
-# https://github.com/docker/docker.github.io/tree/docs-base
+# This image comes from the Dockerfile.builder.onbuild file in the publish-tools branch
+# https://github.com/docker/docker.github.io/blob/publish-tools/Dockerfile.builder.onbuild
+FROM docs/docker.github.io:docs-builder-onbuild AS builder
 
-# First, build non-edge (all of this is duplicated later -- that is on purpose)
-
-# Copy master into target directory (skipping files / folders in .dockerignore)
-# These files represent the current docs
-COPY . md_source
-
-# Move built html into md_source directory so we can reuse the target directory
-# to hold the static output.
-# Pull reference docs from upstream locations, then build the master docs
-# into static HTML in the "target" directory using Jekyll
-# then nuke the md_source directory.
-
-## Branch to pull from, per ref doc
-## To get master from svn the svn branch needs to be 'trunk'. To get a branch from svn it needs to be 'branches/branchname'
-
-# Engine
-ENV ENGINE_SVN_BRANCH="branches/17.06.x"
-ENV ENGINE_BRANCH="17.06.x"
-
-# Distribution
-ENV DISTRIBUTION_SVN_BRANCH="branches/release/2.6"
-ENV DISTRIBUTION_BRANCH="release/2.6"
-
-RUN jekyll build -s md_source -d target --config md_source/_config.yml \
-	&& rm -rf target/apidocs/layouts \
-	&& find target -type f -name '*.html' -print0 | xargs -0 sed -i 's#href="https://docs.docker.com/#href="/#g' \
-	&& rm -rf md_source
+# Reset the docs/docker.github.io:nginx-onbuild image, which is based on nginx:alpine
+# This image comes from the Dockerfule.nginx.onbuild in the publish-tools branch
+# https://github.com/docker/docker.github.io/blob/publish-tools/Dockerfile.nginx.onbuild
+FROM docs/docker.github.io:nginx-onbuild

Gemfile

@@ -3,5 +3,5 @@ source "https://rubygems.org"
 # Update me once in a while: https://github.com/github/pages-gem/releases
 # Please ensure, before upgrading, that this version exists as a tag in starefossen/github-pages here:
 # https://hub.docker.com/r/starefossen/github-pages/tags/
-gem "github-pages", "137"
+gem "github-pages", "147"
 gem 'wdm', '>= 0.1.0' if Gem.win_platform?

Jenkinsfile

@@ -10,13 +10,9 @@ incremental: true
 permalink: pretty
 safe: false
 lsi: false
-url: https://docs.docker.com
+url: https://docs.docker.com/v17.06
 keep_files: ["v1.4", "v1.5", "v1.6", "v1.7", "v1.8", "v1.9", "v1.10", "v1.11", "v1.12", "v1.13", "v17.03"]
-
-collections:
-  samples:
-    output: true
-
+exclude: ["Dockerfile", "Gemfile", "Gemfile.lock", "hooks", "_scripts", ".git", ".github", '*.gliffy', '*.snagproj', '*.plist', '*.diff']
 gems:
   - jekyll-redirect-from
   - jekyll-seo-tag

_config.yml

@@ -0,0 +1,25 @@
+/**
+ * Styles for the Swagger API documentation (engine/api/v1.x/index.html)
+ */
+
+
+/* ReDoc doesn't change outer page styles */
+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;
+}
+/**
+ * Disable request-type badges, see https://github.com/Rebilly/ReDoc/issues/61
+ */
+redoc .operation-type {
+    display: none !important;
+}

css/api-reference.css

@@ -11,27 +11,10 @@
     <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>
+    <link rel="stylesheet" type="text/css" href="/css/api-reference.css">
   </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>
+    <script src="/js/redoc.min.js"> </script>
   </body>
 </html>

engine/api/v1.25/index.html

@@ -11,27 +11,10 @@
     <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>
+    <link rel="stylesheet" type="text/css" href="/css/api-reference.css">
   </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>
+    <script src="/js/redoc.min.js"> </script>
   </body>
 </html>