add docs-building CI (#46)

Replaces #44.

Trying a new PR that enables docs builds on PRs and branch builds.

Authors:
  - James Lamb (https://github.com/jameslamb)
  - Brad Rees (https://github.com/BradReesWork)
  - Jake Awe (https://github.com/AyodeAwe)

Approvers:
  - Don Acosta (https://github.com/acostadon)
  - Mike Sarahan (https://github.com/msarahan)

URL: #46

Author: jameslamb

ci/build_docs.sh

@@ -6,6 +6,9 @@ set -euo pipefail
 rapids-logger "Create test conda environment"
 . /opt/conda/etc/profile.d/conda.sh
 
+RAPIDS_VERSION="$(rapids-version)"
+RAPIDS_VERSION_MAJOR_MINOR="$(rapids-version-major-minor)"
+
 rapids-dependency-file-generator \
   --output conda \
   --file-key docs \
@@ -14,56 +17,39 @@ rapids-dependency-file-generator \
 rapids-mamba-retry env create --yes -f env.yaml -n docs
 conda activate docs
 
-rapids-print-env
+export RAPIDS_DOCS_DIR="$(mktemp -d)"
 
-rapids-logger "Downloading artifacts from previous jobs"
-CPP_CHANNEL=$(rapids-download-conda-from-s3 cpp)
-PYTHON_CHANNEL=$(rapids-download-conda-from-s3 python)
+rapids-print-env
 
 if [[ "${RAPIDS_CUDA_VERSION}" == "11.8.0" ]]; then
-  CONDA_CUDA_VERSION="11.8"
   DGL_CHANNEL="dglteam/label/cu118"
 else
-  CONDA_CUDA_VERSION="12.1"
   DGL_CHANNEL="dglteam/label/cu121"
 fi
 
 rapids-mamba-retry install \
-  --channel "${CPP_CHANNEL}" \
-  --channel "${PYTHON_CHANNEL}" \
   --channel conda-forge \
   --channel pyg \
   --channel nvidia \
   --channel "${DGL_CHANNEL}" \
-  libcugraph \
-  pylibcugraph \
-  cugraph \
-  cugraph-pyg \
-  cugraph-dgl \
-  libcugraph_etl \
-  pylibcugraphops \
-  pylibwholegraph \
+  "libcugraph==${RAPIDS_VERSION}.*" \
+  "pylibcugraph=${RAPIDS_VERSION}.*" \
+  "cugraph=${RAPIDS_VERSION}.*" \
+  "cugraph-pyg=${RAPIDS_VERSION}.*" \
+  "cugraph-dgl=${RAPIDS_VERSION}.*" \
+  "libcugraph_etl=${RAPIDS_VERSION}.*" \
+  "pylibcugraphops=${RAPIDS_VERSION}.*" \
+  "pylibwholegraph=${RAPIDS_VERSION}.*" \
   pytorch \
-  "cuda-version=${CONDA_CUDA_VERSION}"
-
-export RAPIDS_VERSION="$(rapids-version)"
-export RAPIDS_VERSION_MAJOR_MINOR="$(rapids-version-major-minor)"
-export RAPIDS_VERSION_NUMBER="$RAPIDS_VERSION_MAJOR_MINOR"
-export RAPIDS_DOCS_DIR="$(mktemp -d)"
+  "cuda-version=${RAPIDS_CUDA_VERSION%.*}"
 
 PROJ_LIST=("libcugraph libcugraphops libwholegraph")
 
 for PROJECT in ${PROJ_LIST}; do
   rapids-logger "Download ${PROJECT} xml_tar"
   TMP_DIR=$(mktemp -d)
   export XML_DIR_${PROJECT^^}="$TMP_DIR"
-
-  if [[ $PROJECT == "libcugraph" ]]; then
-      echo "TMP (FIXME) downloading xml for ${PROJECT} into ${XML_DIR}. Environment variable XML_DIR_${PROJECT^^} is set to ${XML_DIR}"
-      curl -O "https://raw.githubusercontent.com/BradReesWork/data/main/xml.tar.gz"
-  else
-    curl "https://d1664dvumjb44w.cloudfront.net/${PROJECT}/xml_tar/${RAPIDS_VERSION_NUMBER}/xml.tar.gz" | tar -xzf - -C "${TMP_DIR}"
-  fi
+  curl "https://d1664dvumjb44w.cloudfront.net/${PROJECT}/xml_tar/${RAPIDS_VERSION_MAJOR_MINOR}/xml.tar.gz" | tar -xzf - -C "${TMP_DIR}"
 done
 
 
@@ -77,4 +63,4 @@ mkdir -p "${RAPIDS_DOCS_DIR}/cugraph-docs/html"
 mv _html/* "${RAPIDS_DOCS_DIR}/cugraph-docs/html"
 popd
 
-rapids-upload-docs
+RAPIDS_VERSION_NUMBER="${RAPIDS_VERSION_MAJOR_MINOR}" rapids-upload-docs

ci/check_style.sh

@@ -8,7 +8,7 @@ rapids-logger "Create checks conda environment"
 
 rapids-dependency-file-generator \
   --output conda \
-  --file_key checks \
+  --file-key checks \
   --matrix "cuda=${RAPIDS_CUDA_VERSION%.*};arch=$(arch);py=${RAPIDS_PY_VERSION}" | tee env.yaml
 
 rapids-mamba-retry env create --yes -f env.yaml -n checks

conda/environments/all_cuda-118_arch-x86_64.yaml

@@ -16,7 +16,6 @@ dependencies:
 - doxygen
 - graphviz
 - ipython
-- make
 - nbsphinx
 - numpydoc
 - pre-commit

conda/environments/all_cuda-122_arch-x86_64.yaml

@@ -16,7 +16,6 @@ dependencies:
 - doxygen
 - graphviz
 - ipython
-- make
 - nbsphinx
 - numpydoc
 - pre-commit

dependencies.yaml

@@ -71,6 +71,10 @@ dependencies:
               cuda: "12.2"
             packages:
               - cuda-version=12.2
+          - matrix:
+              cuda: "12.5"
+            packages:
+              - cuda-version=12.5
 
   docs:
     common:

docs/cugraph-docs/source/installation/getting_cugraph.md

@@ -26,7 +26,7 @@ The RAPIDS Docker containers contain all RAPIDS packages, including all from cuG
 
 
 ## Conda
-It is easy to install cuGraph using conda. You can get a minimal conda installation with [Miniconda](https://conda.io/miniconda.html) or get the full installation with [Anaconda](https://www.anaconda.com/download).
+It is easy to install cuGraph using conda. We recommend using [Miniforge](https://github.com/conda-forge/miniforge).
 
 cuGraph Conda packages
  * cugraph - this will also import:

docs/cugraph-docs/source/wholegraph/installation/getting_wholegraph.md

@@ -21,7 +21,7 @@ The RAPIDS Docker containers (as of Release 23.10) contain all RAPIDS packages,
 
 
 ## Conda
-It is easy to install WholeGraph using conda. You can get a minimal conda installation with [Miniconda](https://conda.io/miniconda.html) or get the full installation with [Anaconda](https://www.anaconda.com/download).
+It is easy to install WholeGraph using conda. We recommend using [Miniforge](https://github.com/conda-forge/miniforge).
 
 WholeGraph conda packages
  * libwholegraph