build-composite.sh

   1 #!/bin/bash
   2 # SPDX-license-identifier: Apache-2.0
   3 ##############################################################################
   4 # Copyright (c) 2016 NEC and others.
   5 # All rights reserved. This program and the accompanying materials
   6 # are made available under the terms of the Apache License, Version 2.0
   7 # which accompanies this distribution, and is available at
   8 # http://www.apache.org/licenses/LICENSE-2.0
   9 ##############################################################################
  10
  11 set -o errexit
  12 set -o nounset
  13 set -o pipefail
  14 set -o xtrace
  15
  16 GIT_CLONE_BASE=${GIT_CLONE_BASE:-ssh://gerrit.opnfv.org:29418}
  17 GERRIT_BRANCH=${GERRIT_BRANCH:-master}
  18 WORKSPACE=${WORKSPACE:-/tmp}
  19
  20 get_repo_names() {
  21     # NOTE: Not all repositories are ready for the composite docs,
  22     #       so we have the repo name list here to add project docs
  23     #       one by one. This will be replaced by the list in project.cfg .
  24     # grep -v '^#' releng/jjb/opnfvdocs/project.cfg | sort
  25     echo "sdnvpn"
  26     echo "fuel"
  27     echo "joid"
  28     echo "functest"
  29 }
  30
  31 git_clone() {
  32     _repo="$1"
  33
  34     [[ -d "$WORKSPACE/$_repo" ]] && return 0
  35     pushd $WORKSPACE
  36     git clone -b $GERRIT_BRANCH --depth 1 --quiet $GIT_CLONE_BASE/$_repo
  37     popd
  38 }
  39
  40 git_clone releng
  41
  42 repos=$(get_repo_names)
  43
  44 [[ -e docs/projects ]] && rm -rf docs/projects
  45 mkdir -p docs/projects
  46
  47 echo
  48 echo "Cloning repos of participating OPNFV Projects and copying docs"
  49 echo
  50 for repo in $repos; do
  51     echo "    $repo ($GERRIT_BRANCH)"
  52     git_clone $repo
  53     [[ -e $WORKSPACE/$repo/docs ]] || continue
  54     [[ -e docs/projects/$repo ]] && rm -rf docs/projects/$repo
  55     cp -r $WORKSPACE/$repo/docs docs/projects/$repo
  56 done
  57
  58 # NOTE: Removing index.rst in project repos to reduce number of docs.
  59 find docs/projects -type f -name 'index.rst' -print | xargs -I i rm -f i
  60
  61 # NOTE: automated link generation is not ready...
  62 #echo
  63 #echo "Creating document links"
  64 #echo
  65 #for guide in configguide userguide
  66 #do
  67 #    link_list=$WORKSPACE/docs/$guide/projects-$guide.rst
  68 #    for repo in $repos
  69 #    do
  70 #        file=projects/$repo/$guide/$guide.rst
  71 #        [[ -e $WORKSPACE/docs/$file ]] || continue
  72 #        echo "" >> $link_list
  73 #        echo "$repo:" >> $link_list
  74 #        echo ".. include:: ../$file" >> $link_list
  75 #    done
  76 #done
  77
  78 $WORKSPACE/releng/utils/docs-build.sh
  79
  80 echo "Done"