initial draft

.github/workflows/build.yaml

@@ -45,3 +45,14 @@ jobs:
       branch: ${{ inputs.branch }}
       date: ${{ inputs.date }}
       sha: ${{ inputs.sha }}
+  docs-build:
+    if: ${{ startsWith(github.ref, 'refs/heads/branch-') }}
+    needs: cpp-build
+    secrets: inherit
+    uses: rapidsai/shared-action-workflows/.github/workflows/custom-job.yaml@cuda-118
+    with:
+      build_type: branch
+      node_type: "gpu-latest-1"
+      arch: "amd64"
+      container_image: "rapidsai/ci:latest"
+      run_script: "ci/build_docs.sh"

.github/workflows/pr.yaml

@@ -15,6 +15,7 @@ jobs:
       - checks
       - conda-cpp-build
       - conda-cpp-tests
+      - docs-build
     secrets: inherit
     uses: rapidsai/shared-action-workflows/.github/workflows/pr-builder.yaml@cuda-118
   checks:
@@ -32,3 +33,13 @@ jobs:
     uses: rapidsai/shared-action-workflows/.github/workflows/conda-cpp-tests.yaml@cuda-118
     with:
       build_type: pull-request
+  docs-build:
+    needs: conda-cpp-build
+    secrets: inherit
+    uses: rapidsai/shared-action-workflows/.github/workflows/custom-job.yaml@cuda-118
+    with:
+      build_type: pull-request
+      node_type: "gpu-latest-1"
+      arch: "amd64"
+      container_image: "rapidsai/ci:latest"
+      run_script: "ci/build_docs.sh"

ci/build_docs.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+# Copyright (c) 2023, NVIDIA CORPORATION.
+
+set -euo pipefail
+
+rapids-logger "Create test conda environment"
+. /opt/conda/etc/profile.d/conda.sh
+
+rapids-dependency-file-generator \
+  --output requirements \
+  --file_key docs \
+  --matrix "cuda=${RAPIDS_CUDA_VERSION%.*};arch=$(arch);py=${RAPIDS_PY_VERSION}" | tee requirements.txt
+
+rapids-mamba-retry create -n test
+conda activate test
+pip install -r requirements.txt
+
+rapids-print-env
+
+rapids-logger "Downloading artifacts from previous jobs"
+CPP_CHANNEL=$(rapids-download-conda-from-s3 cpp)
+VERSION_NUMBER=$(rapids-get-rapids-version-from-git)
+
+rapids-mamba-retry install \
+  --channel "${CPP_CHANNEL}" \
+  rapids_core_dependencies
+
+
+# Build CPP docs
+gpuci_logger "Build CPP docs"
+pushd docs
+sphinx-build -b dirhtml . _build
+popd
+
+
+if [[ ${RAPIDS_BUILD_TYPE} == "branch" ]]; then
+  aws s3 sync --delete doxygen/html "s3://rapidsai-docs/rapids-cmake/${VERSION_NUMBER}/_build"
+fi

dependencies.yaml

@@ -6,11 +6,17 @@ files:
       - build
       - cudatoolkit
       - test
+      - docs_build
   checks:
     output: none
     includes:
       - build
       - style_checks
+  docs:
+    output: none
+    includes:
+      - cudatoolkit
+      - docs_build
 channels:
   - rapidsai
   - conda-forge
@@ -51,6 +57,13 @@ dependencies:
               cuda: "11.8"
             packages:
               - cudatoolkit=11.8
+  docs_build:
+    common:
+      - output_types: [requirements]
+        packages:
+          - sphinx
+          - sphinx_rtd_theme
+          - sphinx_copybutton
   test:
     common:
       - output_types: [conda, requirements]