reference.yml

repos:
- name: reference-docs
  remote: https://github.com/kubernetes-sigs/reference-docs.git
  # This and the generate-command below needs a change when reference-docs has
  # branches properly defined
  branch: master
  generate-command: |
    cd $GOPATH
    # set the branch, ex: v1.17.0 while K8S_RELEASE=1.17
    # CAUTION: The script won't work if you set K8S_RELEASE=1.18.0 before 1.18 is formally released.
    # The `v${K8S_RELEASE}` string must be a valid tag name from the kubernetes repo, which
    # is only created after the formal release.
    git clone --depth=1 --single-branch --branch v${K8S_RELEASE} https://github.com/kubernetes/kubernetes.git src/k8s.io/kubernetes
    cd src/k8s.io/kubernetes
    make generated_files
    cp -L -R vendor $GOPATH/src
    rm -r vendor/github.com/spf13/cobra
    rm -r vendor/github.com/spf13/pflag

    # kubectl cmd pkg
    cp -R vendor/k8s.io/kubectl/pkg/cmd  pkg/kubectl/
    cd $GOPATH
    go get -v github.com/kubernetes-sigs/reference-docs/gen-compdocs
    cd src/github.com/kubernetes-sigs/reference-docs/

    # generate component tool pages
    make comp
    cd $GOPATH
    go get -v github.com/kubernetes-sigs/reference-docs/gen-kubectldocs
    cd src/github.com/kubernetes-sigs/reference-docs/

    # create versioned dirs if needed and fetch v${K8S_RELEASE}:swagger.json
    make updateapispec
    # generate kubectl cmd reference
    make copycli
    # generate api reference
    cd $GOPATH
    rm -rf src/vendor
    go get -u github.com/go-openapi/loads
    go get -u github.com/go-openapi/spec
    go get -v github.com/kubernetes-sigs/reference-docs/gen-apidocs
    cd src/github.com/kubernetes-sigs/reference-docs/
    make copyapi

  files:
  #- src: gen-compdocs/build/cloud-controller-manager.md
  #  dst: content/en/docs/reference/command-line-tools-reference/
  - src: gen-compdocs/build/kube-apiserver.md
    dst: content/en/docs/reference/command-line-tools-reference/
  - src: gen-compdocs/build/kube-controller-manager.md
    dst: content/en/docs/reference/command-line-tools-reference/
  # We have problems generating docs for kubelet, it is done manually now
  # - src: gen-compdocs/build/kubelet.md
  #   dst: content/en/docs/reference/command-line-tools-reference/
  - src: gen-compdocs/build/kube-proxy.md
    dst: content/en/docs/reference/command-line-tools-reference/
  - src: gen-compdocs/build/kube-scheduler.md
    dst: content/en/docs/reference/command-line-tools-reference/
  - src: gen-compdocs/build/kubectl.md
    dst: content/en/docs/reference/kubectl/
  - src: gen-compdocs/build/kubeadm*.md
    dst: content/en/docs/reference/setup-tools/kubeadm/generated/