Fix hack/update-api-reference-docs.sh

- update toplevel api object pattern in swagger doc script
- make hack/update-api-reference-docs.sh indepenent from master
This commit is contained in:
Dr. Stefan Schimanski 2016-06-20 09:21:58 +02:00
parent a055c4e80f
commit 6d75c01b1d
4 changed files with 14 additions and 26 deletions

View File

@ -400,10 +400,10 @@ span.icon > [class^="icon-"], span.icon > [class*=" icon-"] { cursor: default; }
<p><a href="#_v1beta1_thirdpartyresourcelist">v1beta1.ThirdPartyResourceList</a></p> <p><a href="#_v1beta1_thirdpartyresourcelist">v1beta1.ThirdPartyResourceList</a></p>
</li> </li>
<li> <li>
<p><a href="#_v1beta1_daemonset">v1beta1.DaemonSet</a></p> <p><a href="#_v1beta1_daemonsetlist">v1beta1.DaemonSetList</a></p>
</li> </li>
<li> <li>
<p><a href="#_v1beta1_daemonsetlist">v1beta1.DaemonSetList</a></p> <p><a href="#_v1beta1_daemonset">v1beta1.DaemonSet</a></p>
</li> </li>
<li> <li>
<p><a href="#_v1beta1_ingress">v1beta1.Ingress</a></p> <p><a href="#_v1beta1_ingress">v1beta1.Ingress</a></p>
@ -6093,7 +6093,7 @@ Both these may change in the future. Incoming requests are matched against the h
</div> </div>
<div id="footer"> <div id="footer">
<div id="footer-text"> <div id="footer-text">
Last updated 2016-06-06 17:05:19 UTC Last updated 2016-06-20 07:50:53 UTC
</div> </div>
</div> </div>
</body> </body>

View File

@ -28,12 +28,12 @@ COPY build.gradle build/
COPY gen-swagger-docs.sh build/ COPY gen-swagger-docs.sh build/
#run the script once to download the dependent java libraries into the image #run the script once to download the dependent java libraries into the image
RUN mkdir /output RUN mkdir /output /swagger-source
RUN mkdir /swagger-source
RUN wget https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/swagger-spec/v1.json -O /swagger-source/v1.json RUN wget https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/swagger-spec/v1.json -O /swagger-source/v1.json
RUN build/gen-swagger-docs.sh v1 https://raw.githubusercontent.com/GoogleCloudPlatform/kubernetes/master/pkg/api/v1/register.go RUN wget https://raw.githubusercontent.com/GoogleCloudPlatform/kubernetes/master/pkg/api/v1/register.go -O /register.go
RUN rm /output/* RUN build/gen-swagger-docs.sh v1
RUN rm /swagger-source/* RUN rm /output/* /swagger-source/* /register.go
RUN chmod -R 777 build/ RUN chmod -R 777 build/
RUN chmod -R 777 gradle-cache/ RUN chmod -R 777 gradle-cache/

View File

@ -22,16 +22,6 @@ set -o pipefail
cd /build cd /build
# wget doesn't retry on 503, so adding a loop to make it more resilient.
for i in {1..3}; do
if wget "$2" -O register.go; then
break
fi
if [ $i -eq 3 ]; then
exit 1
fi
done
# gendocs takes "input.json" as the input swagger spec. # gendocs takes "input.json" as the input swagger spec.
# $1 is expected to be <group>_<version> # $1 is expected to be <group>_<version>
cp /swagger-source/"$1".json input.json cp /swagger-source/"$1".json input.json
@ -40,8 +30,7 @@ cp /swagger-source/"$1".json input.json
#insert a TOC for top level API objects #insert a TOC for top level API objects
buf="== Top Level API Objects\n\n" buf="== Top Level API Objects\n\n"
top_level_models=$(grep GetObjectKind ./register.go | sed 's/func (obj \*\(.*\)) GetObjectKind(\(.*\)) .*/\1/g' \ top_level_models=$(grep '&[A-Za-z]*{},' /register.go | sed 's/.*&//;s/{},//')
| tr -d '()' | tr -d '{}' | tr -d ' ')
# check if the top level models exist in the definitions.adoc. If they exist, # check if the top level models exist in the definitions.adoc. If they exist,
# their name will be <version>.<model_name> # their name will be <version>.<model_name>

View File

@ -60,20 +60,19 @@ fi
for ver in $VERSIONS; do for ver in $VERSIONS; do
TMP_IN_HOST="${OUTPUT_TMP_IN_HOST}/${ver}" TMP_IN_HOST="${OUTPUT_TMP_IN_HOST}/${ver}"
REGISTER_FILE_URL="https://raw.githubusercontent.com/kubernetes/kubernetes/master/pkg"
if [[ ${ver} == "v1" ]]; then if [[ ${ver} == "v1" ]]; then
REGISTER_FILE_URL="${REGISTER_FILE_URL}/api/${ver}/register.go" REGISTER_FILE="${REPO_DIR}/pkg/api/${ver}/register.go"
else else
REGISTER_FILE_URL="${REGISTER_FILE_URL}/apis/${ver}/register.go" REGISTER_FILE="${REPO_DIR}/pkg/apis/${ver}/register.go"
fi fi
SWAGGER_JSON_NAME="$(kube::util::gv-to-swagger-name "${ver}")" SWAGGER_JSON_NAME="$(kube::util::gv-to-swagger-name "${ver}")"
docker run ${user_flags} \ docker run ${user_flags} \
--rm -v "${TMP_IN_HOST}":/output:z \ --rm -v "${TMP_IN_HOST}":/output:z \
-v "${SWAGGER_PATH}":/swagger-source:z \ -v "${SWAGGER_PATH}":/swagger-source:z \
gcr.io/google_containers/gen-swagger-docs:v5 \ -v "${REGISTER_FILE}":/register.go:z \
"${SWAGGER_JSON_NAME}" \ gcr.io/google_containers/gen-swagger-docs:v6 \
"${REGISTER_FILE_URL}" "${SWAGGER_JSON_NAME}"
done done
# Check if we actually changed anything # Check if we actually changed anything