Skip to content

Remove Add

Remove Add #139

Workflow file for this run

name: Docs CI
on:
pull_request:
branches: [ main ]
push:
branches: [ 'main', 'release/v*' ]
jobs:
makedirs:
runs-on: ubuntu-22.04
steps:
- name: Make Directories
run: |
mkdir -p tmp-deephaven-core-v2/${{ github.ref_name }}/
cd tmp-deephaven-core-v2/${{ github.ref_name }}/
mkdir -p javadoc pydoc client-api
cd client-api
mkdir -p javascript python cpp-examples cpp r
- name: Deploy Directories
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz
path: tmp-deephaven-core-v2/
remote_path: deephaven-core-v2/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
symlink:
if: ${{ github.event_name == 'push' && startsWith(github.ref, 'refs/heads/release/v') }}
needs: [javadoc, typedoc, pydoc, cppdoc, rdoc]
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
- name: Setup Git
run: |
git config user.name "$(git --no-pager log --format=format:'%an' -n 1)"
git config user.email "$(git --no-pager log --format=format:'%ae' -n 1)"
git remote remove upstream 2>/dev/null || git remote add upstream https://github.com/deephaven/deephaven-core.git
git fetch --tags upstream
- name: Make Symlinks
run: |
VERSION=$(basename ${{ github.ref_name }})
git tag -a -m "[Temp Tag] ${VERSION}" ${VERSION} release/${VERSION}
LATEST=$(git tag --sort="version:refname" | grep -E "^v([0-9]+[.]?){3}$" | tail -1)
mkdir -p tmp-deephaven-core-v2/symlinks
cd tmp-deephaven-core-v2/symlinks
ln -s ../release/${LATEST} latest
ln -s ../main next
- name: Deploy Symlinks
uses: burnett01/[email protected]
with:
switches: -rlptDvz
path: tmp-deephaven-core-v2/
remote_path: deephaven-core-v2/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
javadoc:
needs: [makedirs]
runs-on: ubuntu-22.04
concurrency:
group: javadoc-${{ github.workflow }}-${{ github.ref }}
# We don't want to cancel in-progress jobs against main because that might leave the upload in a bad state.
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup JDK 11
id: setup-java-11
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '11'
- name: Setup JDK 17
id: setup-java-17
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '17'
- name: Set JAVA_HOME
run: echo "JAVA_HOME=${{ steps.setup-java-11.outputs.path }}" >> $GITHUB_ENV
- name: Setup gradle properties
run: |
.github/scripts/gradle-properties.sh >> gradle.properties
cat gradle.properties
- name: All Javadoc
uses: burrunan/gradle-cache-action@v1
with:
job-id: allJavadoc
arguments: --scan outputVersion combined-javadoc:allJavadoc
gradle-version: wrapper
- name: Get Deephaven Version
id: dhc-version
run: echo "version=$(cat build/version)" >> $GITHUB_OUTPUT
- name: Upload Javadocs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: javadocs-${{ steps.dhc-version.outputs.version }}
path: 'combined-javadoc/build/docs/javadoc/'
- name: Deploy Javadoc
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: combined-javadoc/build/docs/javadoc/
remote_path: deephaven-core-v2/${{ github.ref_name }}/javadoc/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
typedoc:
needs: [makedirs]
runs-on: ubuntu-22.04
concurrency:
group: typedoc-${{ github.workflow }}-${{ github.ref }}
# We don't want to cancel in-progress jobs against main because that might leave the upload in a bad state.
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup JDK 11
id: setup-java-11
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '11'
- name: Setup JDK 17
id: setup-java-17
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '17'
- name: Set JAVA_HOME
run: echo "JAVA_HOME=${{ steps.setup-java-11.outputs.path }}" >> $GITHUB_ENV
- name: Setup gradle properties
run: |
.github/scripts/gradle-properties.sh >> gradle.properties
cat gradle.properties
- name: Run typedoc on JS API
uses: burrunan/gradle-cache-action@v1
with:
job-id: typedoc
arguments: --scan outputVersion :web-client-api:types:typedoc
gradle-version: wrapper
- name: Get Deephaven Version
id: dhc-version
run: echo "version=$(cat build/version)" >> $GITHUB_OUTPUT
- name: Upload JavaScript/TypeScript docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: typedoc-${{ steps.dhc-version.outputs.version }}
path: 'web/client-api/types/build/documentation/'
- name: Deploy JavaScript/TypeScript docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: web/client-api/types/build/documentation/
remote_path: deephaven-core-v2/${{ github.ref_name }}/client-api/javascript/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
pydoc:
needs: [makedirs]
runs-on: ubuntu-22.04
concurrency:
group: pydoc-${{ github.workflow }}-${{ github.ref }}
# We don't want to cancel in-progress jobs against main because that might leave the upload in a bad state.
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup JDK 11
id: setup-java-11
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '11'
- name: Setup JDK 17
id: setup-java-17
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '17'
- name: Set JAVA_HOME
run: echo "JAVA_HOME=${{ steps.setup-java-11.outputs.path }}" >> $GITHUB_ENV
- name: Setup gradle properties
run: |
.github/scripts/gradle-properties.sh >> gradle.properties
cat gradle.properties
- name: Generate Python Docs
uses: burrunan/gradle-cache-action@v1
with:
job-id: pythonDocs
arguments: --scan outputVersion sphinx:pythonDocs sphinx:pydeephavenDocs
gradle-version: wrapper
- name: Get Deephaven Version
id: dhc-version
run: echo "version=$(cat build/version)" >> $GITHUB_OUTPUT
- name: Upload Python Server Docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: pyserver-docs-${{ steps.dhc-version.outputs.version }}
path: 'sphinx/build/docs/'
- name: Upload Python Client Docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: pyclient-docs-${{ steps.dhc-version.outputs.version }}
path: 'sphinx/build/pyclient-docs/'
- name: Deploy Python Docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: sphinx/build/docs/
remote_path: deephaven-core-v2/${{ github.ref_name }}/pydoc/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
- name: Deploy Client Python Docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: sphinx/build/pyclient-docs/
remote_path: deephaven-core-v2/${{ github.ref_name }}/client-api/python/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
- name: Upload JVM Error Logs
uses: actions/upload-artifact@v4
if: failure()
with:
name: docs-ci-pydoc-jvm-err
path: '**/*_pid*.log'
if-no-files-found: ignore
cppdoc:
needs: [makedirs]
runs-on: ubuntu-22.04
concurrency:
group: cppdoc-${{ github.workflow }}-${{ github.ref }}
# We don't want to cancel in-progress jobs against main because that might leave the upload in a bad state.
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup JDK 11
id: setup-java-11
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '11'
- name: Set JAVA_HOME
run: echo "JAVA_HOME=${{ steps.setup-java-11.outputs.path }}" >> $GITHUB_ENV
- name: Setup gradle properties
run: |
.github/scripts/gradle-properties.sh >> gradle.properties
cat gradle.properties
- name: Generate C++ Docs
uses: burrunan/gradle-cache-action@v1
with:
job-id: cppDocs
arguments: --scan outputVersion sphinx:cppClientDocs sphinx:cppExamplesDocs
gradle-version: wrapper
- name: Get Deephaven Version
id: dhc-version
run: echo "version=$(cat build/version)" >> $GITHUB_OUTPUT
- name: Upload Client C++ Docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: cppclient-docs-${{ steps.dhc-version.outputs.version }}
path: 'sphinx/build/cppClientDocs/'
- name: Upload Client C++ Example Docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: cppclient-examples-${{ steps.dhc-version.outputs.version }}
path: 'sphinx/build/cppExamplesDocs/'
- name: Deploy Client C++ Docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: sphinx/build/cppClientDocs/
remote_path: deephaven-core-v2/${{ github.ref_name }}/client-api/cpp/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
- name: Deploy Client C++ Example Docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: sphinx/build/cppExamplesDocs/
remote_path: deephaven-core-v2/${{ github.ref_name }}/client-api/cpp-examples/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
rdoc:
needs: [makedirs]
runs-on: ubuntu-22.04
concurrency:
group: rdoc-${{ github.workflow }}-${{ github.ref }}
# We don't want to cancel in-progress jobs against main because that might leave the upload in a bad state.
cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup JDK 11
id: setup-java-11
uses: actions/setup-java@v4
with:
distribution: 'temurin'
java-version: '11'
- name: Set JAVA_HOME
run: echo "JAVA_HOME=${{ steps.setup-java-11.outputs.path }}" >> $GITHUB_ENV
- name: Setup gradle properties
run: |
.github/scripts/gradle-properties.sh >> gradle.properties
cat gradle.properties
- name: Generate R Docs
uses: burrunan/gradle-cache-action@v1
with:
job-id: rDocs
arguments: --scan outputVersion R:rClientSite
gradle-version: wrapper
- name: Get Deephaven Version
id: dhc-version
run: echo "version=$(cat build/version)" >> $GITHUB_OUTPUT
- name: Upload R Docs
if: ${{ github.event_name == 'push' }}
uses: actions/upload-artifact@v4
with:
name: rdoc-${{ steps.dhc-version.outputs.version }}
path: 'R/rdeephaven/docs/'
- name: Deploy R Docs
if: ${{ github.event_name == 'push' }}
uses: burnett01/[email protected]
with:
switches: -rlptDvz --delete
path: R/rdeephaven/docs/
remote_path: deephaven-core-v2/${{ github.ref_name }}/client-api/r/
remote_host: ${{ secrets.DOCS_HOST }}
remote_port: ${{ secrets.DOCS_PORT }}
remote_user: ${{ secrets.DOCS_USER }}
remote_key: ${{ secrets.DEEPHAVEN_CORE_SSH_KEY }}
- name: Upload JVM Error Logs
uses: actions/upload-artifact@v4
if: failure()