Deploy docs preview #168
This file contains 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
| # Use this starter workflow to deploy HTML generated by Antora to surge.sh | |
| # Docs are published at <org>-<repo>-<deployid>.surge.sh | |
| # | |
| # By default, this workflow runs on completion of a workflow called "Verify docs PR" | |
| # | |
| # This workflow expects the triggering workflow to generate an artifact called "docs" | |
| # - update the reference to "docs" and "docs.zip" in this workflow if your triggering workflow generates an artifact with a different name | |
| name: "Deploy docs preview" | |
| on: | |
| workflow_run: | |
| workflows: ["Verify docs PR"] | |
| types: | |
| - completed | |
| jobs: | |
| publish-docs: | |
| # Uncomment this if statement to deploy only when the PR builds cleanly | |
| # if: github.event.workflow_run.conclusion == 'success' | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: "Download built documentation" | |
| uses: actions/[email protected] | |
| env: | |
| RUN_ID: ${{ github.event.workflow_run.id }} | |
| WORKSPACE: ${{ github.workspace }} | |
| with: | |
| script: | | |
| var artifacts = await github.rest.actions.listWorkflowRunArtifacts({ | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| run_id: ${{ env.RUN_ID }}, | |
| }); | |
| var matchArtifact = artifacts.data.artifacts.filter((artifact) => { | |
| return artifact.name == "docs" | |
| })[0]; | |
| var download = await github.rest.actions.downloadArtifact({ | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| artifact_id: matchArtifact.id, | |
| archive_format: 'zip', | |
| }); | |
| var fs = require('fs'); | |
| fs.writeFileSync('${{ env.WORKSPACE }}/docs.zip', Buffer.from(download.data)); | |
| - run: unzip docs.zip | |
| - id: get-deploy-id | |
| run: | | |
| deployid=$(<deployid) | |
| case "$deployid" in ''|*[!0-9]*) echo "Provided PR number is not an integer"; exit 1 ;; esac | |
| echo "deploy-id=$deployid" >> "$GITHUB_OUTPUT" | |
| - id: get-deploy-url | |
| env: | |
| ORG: ${{ github.event.repository.owner.login }} | |
| REPO: ${{ github.event.repository.name }} | |
| DEPLOYID: ${{ steps.get-deploy-id.outputs.deploy-id }} | |
| run: | | |
| deployurl=$ORG-$REPO-$DEPLOYID.surge.sh | |
| echo "deploy-url=$deployurl" >> $GITHUB_OUTPUT | |
| - uses: actions/setup-node@v3 | |
| with: | |
| node-version: lts/* | |
| - name: Deploy docs to surge | |
| shell: bash | |
| env: | |
| DEPLOY_URL: ${{ steps.get-deploy-url.outputs.deploy-url }} | |
| SURGE_TOKEN: "${{ secrets.DOCS_SURGE_TOKEN }}" | |
| run: | | |
| npm install -g surge | |
| surge ./site $DEPLOY_URL --token "$SURGE_TOKEN" | |
| # If the PR artifacts include a changelog file, add it to the PR as a comment | |
| # The changelog contains links to new and changed files in the deployed docs | |
| - name: Comment on PR (changelog) | |
| if: ${{ hashFiles('changelog') != '' }} | |
| uses: marocchino/sticky-pull-request-comment@v2 | |
| with: | |
| number: ${{ steps.get-deploy-id.outputs.deploy-id }} | |
| recreate: true | |
| header: docs-pr-changes | |
| path: changelog | |
| GITHUB_TOKEN: ${{ secrets.DOCS_PR_COMMENT_TOKEN }} | |
| # If there's no changelog, add a generic comment to the PR | |
| - name: Comment on PR (no changelog) | |
| if: ${{ hashFiles('changelog') == '' }} | |
| env: | |
| DEPLOY_URL: ${{ steps.get-deploy-url.outputs.deploy-url }} | |
| uses: marocchino/sticky-pull-request-comment@v2 | |
| with: | |
| number: ${{ steps.get-deploy-id.outputs.deploy-id }} | |
| header: docs-pr-changes | |
| message: | | |
| Looks like you've updated the documentation! | |
| Check out your changes at https://${{ env.DEPLOY_URL }} | |
| GITHUB_TOKEN: ${{ secrets.DOCS_PR_COMMENT_TOKEN }} |