A script to render a digest HTML page to read Kubernetes CRDs

kubernetes-crds-to-html.sh

#!/bin/bash
# Prerequisites:
#   - yq: https://github.com/mikefarah/yq
#   - yaml2json: https://github.com/bronze1man/yaml2json
#   - generate-schema-doc: https://github.com/coveooss/json-schema-for-humans

FILE=$1

if [ ! -d html ] ; then
  mkdir html
fi

cat << EOF > render.yaml
\$schema: "https://json-schema.org/draft/2020-12/schema"
type: "object"
description: ""
additionalProperties": false
EOF

yq -r '.spec.versions[0].schema.openAPIV3Schema' ${FILE} >> render.yaml

yaml2json < render.yaml > render.json

generate-schema-doc --config template_name=js --config with_footer=false --config link_to_reused_ref=true render.json html/