From 50d7d7c25b67bfc103234226404c1fc41c67253b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9phine=20Oberholtzer?= Date: Tue, 25 Aug 2026 15:40:51 -0400 Subject: [PATCH 1/4] X-ORG-619: publish-api-docs autogenerates versions.json --- .github/workflows/publish-api-docs.yaml | 64 ++++++++++++++++++++++++- 1 file changed, 62 insertions(+), 2 deletions(-) diff --git a/.github/workflows/publish-api-docs.yaml b/.github/workflows/publish-api-docs.yaml index e696db36..30801db1 100644 --- a/.github/workflows/publish-api-docs.yaml +++ b/.github/workflows/publish-api-docs.yaml @@ -36,7 +36,7 @@ on: type: string version-map: description: | - JSON map of RAPIDS version to tag, e.g. '{"26.08": "legacy", "26.10": "stable"}' + JSON map of tag to RAPIDS version, e.g. '{"stable": "26.08", "nightly": "26.10"}' required: true type: string secrets: @@ -113,10 +113,11 @@ jobs: - name: Compute Akamai request name id: akamai env: + PROJECT: ${{ matrix.project }} REPO: ${{ github.repository }} RUN_ID: ${{ github.run_id }} run: | - name="$(echo "${REPO}" | tr '[:upper:]' '[:lower:]' | tr '/' '-')-${RUN_ID}" + name="$(echo "${REPO}" | tr '[:upper:]' '[:lower:]' | tr '/' '-')-${RUN_ID}-${PROJECT}" echo "request-name=${name}" >> "${GITHUB_OUTPUT}" - name: Configure AWS credentials @@ -152,3 +153,62 @@ jobs: target-s3-bucket: ${{ secrets.target-s3-bucket }} target-s3-key-suffix: ${{ steps.version.outputs.rapids-version-major-minor }} target-s3-key: ${{ matrix.project }} + + publish-versions-json: + needs: compute-matrix + runs-on: ubuntu-latest + container: + image: ${{ inputs.container-image }} # zizmor: ignore[unpinned-images] + options: ${{ inputs.container-options }} + strategy: + fail-fast: false + matrix: + project: ${{ fromJSON(needs.compute-matrix.outputs.matrix) }} + steps: + + - name: Generate versions.json + env: + PROJECT: ${{ matrix.project }} + VERSION_MAP: ${{ inputs.version-map }} + run: | + jq -n -S \ + --arg project "${PROJECT}" \ + --argjson map "${VERSION_MAP}" \ + ' + $map + | to_entries + | map({ + name: "\(.value) (\(.key))", + url: "https://docs.nvidia.com/\($project)/\(.value)/", + version: .value + } + (if .key == "stable" then {preferred: true} else {}end)) + | sort_by(.version) + | reverse + ' > versions.json + + - name: Compute Akamai request name + id: akamai + env: + PROJECT: ${{ matrix.project }} + REPO: ${{ github.repository }} + RUN_ID: ${{ github.run_id }} + run: | + name="$(echo "${REPO}" | tr '[:upper:]' '[:lower:]' | tr '/' '-')-${RUN_ID}-${PROJECT}-versions-json" + echo "request-name=${name}" >> "${GITHUB_OUTPUT}" + + - name: Publish versions.json + uses: rapidsai/shared-actions/publish-one-doc@josephine/x-org-138-publish-one-doc + with: + akamai-access-token: ${{ secrets.akamai-access-token }} + akamai-client-secret: ${{ secrets.akamai-client-secret }} + akamai-client-token: ${{ secrets.akamai-client-token }} + akamai-emails-to-notify: ${{ secrets.akamai-emails-to-notify }} + akamai-host: ${{ secrets.akamai-host }} + akamai-request-name: ${{ steps.akamai.outputs.request-name }}-versions + dry-run: ${{ inputs.dry-run }} + file-path: ./versions.json + target-aws-access-key-id: ${{ secrets.target-aws-access-key-id }} + target-aws-region: ${{ secrets.target-aws-region }} + target-aws-secret-access-key: ${{ secrets.target-aws-secret-access-key }} + target-s3-bucket: ${{ secrets.target-s3-bucket }} + target-s3-key: ${{ matrix.project }} From b7cc7e3502fe3e441e2c3c8423b992304a6f0b55 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9phine=20Oberholtzer?= Date: Tue, 25 Aug 2026 16:39:45 -0400 Subject: [PATCH 2/4] Cat the versions.json --- .github/workflows/publish-api-docs.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/publish-api-docs.yaml b/.github/workflows/publish-api-docs.yaml index 30801db1..dafd74e1 100644 --- a/.github/workflows/publish-api-docs.yaml +++ b/.github/workflows/publish-api-docs.yaml @@ -185,6 +185,7 @@ jobs: | sort_by(.version) | reverse ' > versions.json + cat versions.json - name: Compute Akamai request name id: akamai From c2e018092e067635132b201d09a36358e9c04420 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9phine=20Wolf=20Oberholtzer?= <166141926+josephine-wolf-oberholtzer@users.noreply.github.com> Date: Tue, 25 Aug 2026 17:19:48 -0400 Subject: [PATCH 3/4] Update .github/workflows/publish-api-docs.yaml Co-authored-by: Bradley Dice --- .github/workflows/publish-api-docs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-api-docs.yaml b/.github/workflows/publish-api-docs.yaml index dafd74e1..3a99cacc 100644 --- a/.github/workflows/publish-api-docs.yaml +++ b/.github/workflows/publish-api-docs.yaml @@ -36,7 +36,7 @@ on: type: string version-map: description: | - JSON map of tag to RAPIDS version, e.g. '{"stable": "26.08", "nightly": "26.10"}' + JSON map of tag to library version, e.g. '{"stable": "26.08", "nightly": "26.10"}' required: true type: string secrets: From fa85fba86a79732f4564f579ca9bb55ae64c996c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jos=C3=A9phine=20Oberholtzer?= Date: Tue, 25 Aug 2026 18:12:01 -0400 Subject: [PATCH 4/4] Use publish-one-doc@main --- .github/workflows/publish-api-docs.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/publish-api-docs.yaml b/.github/workflows/publish-api-docs.yaml index 3a99cacc..6b8a6cb7 100644 --- a/.github/workflows/publish-api-docs.yaml +++ b/.github/workflows/publish-api-docs.yaml @@ -198,7 +198,7 @@ jobs: echo "request-name=${name}" >> "${GITHUB_OUTPUT}" - name: Publish versions.json - uses: rapidsai/shared-actions/publish-one-doc@josephine/x-org-138-publish-one-doc + uses: rapidsai/shared-actions/publish-one-doc@main with: akamai-access-token: ${{ secrets.akamai-access-token }} akamai-client-secret: ${{ secrets.akamai-client-secret }}