From 9adf45d48d188680c015e1a8608065dcf96c467c Mon Sep 17 00:00:00 2001 From: Joel Stanley Date: Tue, 8 Mar 2022 12:15:43 +1030 Subject: github: Add workflow to build and deploy docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This builds the gcov coverage report and the skiboot docs on the Github hosted runner, without using a container. Remove the CROSS= definition from build-docs.sh to allow the makefile detect which cross compiler is installed, instead of hardcoding the non-le variant. This is a simplification from the previous docs build, which used the containers. However the containers have since been re-worked and no longer leave the build artifacts on the host system. The github action used for deploying seems to be the most commonly used: https://github.com/JamesIves/github-pages-deploy-action Signed-off-by: Joel Stanley Signed-off-by: Cédric Le Goater --- .github/workflows/build-docs.yml | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 .github/workflows/build-docs.yml (limited to '.github') diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml new file mode 100644 index 0000000..242f200 --- /dev/null +++ b/.github/workflows/build-docs.yml @@ -0,0 +1,30 @@ +name: Generate and deploy documentation + +on: + push: + branches: + - master + +jobs: + docs-build-and-deploy: + + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Install apt dependencies + run: | + sudo apt install -qq build-essential gcc-powerpc64le-linux-gnu git lcov \ + device-tree-compiler libssl-dev libmbedtls-dev \ + python3-sphinx python3-recommonmark + + - name: Generate docs and coverage report + run: ./opal-ci/build-docs.sh + + - name: Deploy docs + uses: JamesIves/github-pages-deploy-action@v4.2.5 + with: + branch: gh-pages + folder: doc/_build/ghpages -- cgit v1.1