Merge pull request #4149 from nikhiljindal/autoSwaggerSpec

Adding static swagger spec and a script to update it

api/swagger-spec/api.json

@@ -0,0 +1,27 @@
+{
+  "swaggerVersion": "1.2",
+  "apiVersion": "",
+  "basePath": "127.0.0.1:8050",
+  "resourcePath": "/api",
+  "apis": [
+   {
+    "path": "/api",
+    "description": "get available api versions",
+    "operations": [
+     {
+      "type": "void",
+      "method": "GET",
+      "summary": "get available api versions",
+      "nickname": "getApiVersions",
+      "parameters": [],
+      "produces": [
+       "application/json"
+      ],
+      "consumes": [
+       "application/json"
+      ]
+     }
+    ]
+   }
+  ]
+ }

api/swagger-spec/resourceListing.json

@@ -0,0 +1,30 @@
+{
+  "swaggerVersion": "1.2",
+  "apis": [
+   {
+    "path": "/api/v1beta1",
+    "description": "API at /api/v1beta1 version v1beta1"
+   },
+   {
+    "path": "/api/v1beta2",
+    "description": "API at /api/v1beta2 version v1beta2"
+   },
+   {
+    "path": "/api/v1beta3",
+    "description": "API at /api/v1beta3 version v1beta3"
+   },
+   {
+    "path": "/api",
+    "description": "get available api versions"
+   },
+   {
+    "path": "/version",
+    "description": "git code version from which this is built"
+   }
+  ],
+  "apiVersion": "",
+  "info": {
+   "title": "",
+   "description": ""
+  }
+ }

api/swagger-spec/version.json

@@ -0,0 +1,27 @@
+{
+  "swaggerVersion": "1.2",
+  "apiVersion": "",
+  "basePath": "127.0.0.1:8050",
+  "resourcePath": "/version",
+  "apis": [
+   {
+    "path": "/version",
+    "description": "git code version from which this is built",
+    "operations": [
+     {
+      "type": "void",
+      "method": "GET",
+      "summary": "get the code version",
+      "nickname": "getCodeVersion",
+      "parameters": [],
+      "produces": [
+       "application/json"
+      ],
+      "consumes": [
+       "application/json"
+      ]
+     }
+    ]
+   }
+  ]
+ }

hack/update-swagger-spec.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# Copyright 2015 Google Inc. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Script to fetch latest swagger spec.
+# Puts the updated spec at swagger-spec/
+
+set -o errexit
+set -o nounset
+set -o pipefail
+
+KUBE_ROOT=$(dirname "${BASH_SOURCE}")/..
+SWAGGER_ROOT_DIR="${KUBE_ROOT}/api/swagger-spec"
+source "${KUBE_ROOT}/hack/lib/init.sh"
+
+function cleanup()
+{
+    [[ -n ${APISERVER_PID-} ]] && kill ${APISERVER_PID} 1>&2 2>/dev/null
+
+    kube::etcd::cleanup
+
+    kube::log::status "Clean up complete"
+}
+
+trap cleanup EXIT SIGINT
+
+kube::etcd::start
+
+ETCD_HOST=${ETCD_HOST:-127.0.0.1}
+ETCD_PORT=${ETCD_PORT:-4001}
+API_PORT=${API_PORT:-8050}
+API_HOST=${API_HOST:-127.0.0.1}
+KUBELET_PORT=${KUBELET_PORT:-10250}
+
+# Start kube-apiserver
+kube::log::status "Starting kube-apiserver"
+"${KUBE_OUTPUT_HOSTBIN}/kube-apiserver" \
+  --address="127.0.0.1" \
+  --public_address_override="127.0.0.1" \
+  --port="${API_PORT}" \
+  --etcd_servers="http://${ETCD_HOST}:${ETCD_PORT}" \
+  --public_address_override="127.0.0.1" \
+  --kubelet_port=${KUBELET_PORT} \
+  --runtime_config=api/v1beta3 \
+  --portal_net="10.0.0.0/24" 1>&2 &
+APISERVER_PID=$!
+
+kube::util::wait_for_url "http://127.0.0.1:${API_PORT}/healthz" "apiserver: "
+
+SWAGGER_API_PATH="http://127.0.0.1:${API_PORT}/swaggerapi/"
+kube::log::status "Updating " ${SWAGGER_ROOT_DIR}
+curl ${SWAGGER_API_PATH} > ${SWAGGER_ROOT_DIR}/resourceListing.json
+curl ${SWAGGER_API_PATH}version > ${SWAGGER_ROOT_DIR}/version.json
+curl ${SWAGGER_API_PATH}api > ${SWAGGER_ROOT_DIR}/api.json
+curl ${SWAGGER_API_PATH}api/v1beta1 > ${SWAGGER_ROOT_DIR}/v1beta1.json
+curl ${SWAGGER_API_PATH}api/v1beta2 > ${SWAGGER_ROOT_DIR}/v1beta2.json
+curl ${SWAGGER_API_PATH}api/v1beta3 > ${SWAGGER_ROOT_DIR}/v1beta3.json
+
+kube::log::status "SUCCESS"