Fix missing docs #91
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: mkdocs-release | |
| on: | |
| push: | |
| branches: [branch-*\.*] | |
| repository_dispatch: | |
| types: | |
| - trigger-rebuild | |
| concurrency: | |
| group: ${{ github.workflow }} | |
| cancel-in-progress: false | |
| jobs: | |
| publish-release: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Extract branch name (push) | |
| if: ${{ github.event_name == 'push' }} | |
| run: echo "BRANCH=${GITHUB_REF#refs/heads/}" >> "$GITHUB_ENV" | |
| - name: Extract branch name (repository_dispatch) | |
| if: ${{ github.event_name == 'repository_dispatch' }} | |
| run: echo "BRANCH=${{ github.event.client_payload.branch }}" >> "$GITHUB_ENV" | |
| - name: Extract version from branch name | |
| run: echo "HOPSWORKS_VERSION=${BRANCH#branch-}" >> "$GITHUB_ENV" | |
| - name: Checkout main repo | |
| uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 0 | |
| ref: ${{ env.BRANCH }} | |
| - name: Checkout the API repo | |
| uses: actions/checkout@v4 | |
| with: | |
| # TODO: replace aversey with logicalclocks | |
| repository: aversey/hopsworks-api | |
| ref: ${{ env.BRANCH }} | |
| path: hopsworks-api | |
| - name: Cache local Maven repository | |
| uses: actions/cache@v4 | |
| with: | |
| path: ~/.m2/repository | |
| key: ${{ runner.os }}-maven-${{ hashFiles('java/pom.xml') }} | |
| restore-keys: | | |
| ${{ runner.os }}-maven- | |
| - name: Set up JDK 8 | |
| uses: actions/setup-java@v5 | |
| with: | |
| java-version: "8" | |
| distribution: "adopt" | |
| - name: Build javadoc documentation | |
| working-directory: hopsworks-api/java | |
| run: mvn clean install javadoc:javadoc javadoc:aggregate -DskipTests && cp -r target/site/apidocs ../../docs/javadoc | |
| - uses: actions/setup-python@v5 | |
| with: | |
| python-version: "3.10" | |
| - name: Install uv | |
| uses: astral-sh/setup-uv@v7 | |
| with: | |
| activate-environment: true | |
| working-directory: hopsworks-api/python | |
| - name: Install Python API dependencies | |
| run: uv sync --extra dev --group docs --project hopsworks-api/python | |
| - name: Install Python dependencies | |
| run: uv pip install -r requirements-docs.txt | |
| - name: Install Ubuntu dependencies | |
| run: sudo apt update && sudo apt-get install -y libxml2-dev libxslt-dev | |
| - name: Setup git for mike | |
| run: | | |
| git config --global user.name Mike | |
| git config --global user.email [email protected] | |
| - name: Deploy the docs with mike | |
| run: mike deploy ${HOPSWORKS_VERSION} latest -u --push |