Publish Documentation #890
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
| # Triggers after the documentation build has finished, | |
| # taking the artifact and uploading it to netlify | |
| # Mostly copied from the SageMath workflow file. | |
| name: Publish Documentation | |
| on: | |
| workflow_run: | |
| workflows: ["Build Documentation"] | |
| types: | |
| - completed | |
| permissions: | |
| statuses: write | |
| checks: write | |
| pull-requests: write | |
| jobs: | |
| upload-docs: | |
| runs-on: ubuntu-22.04 | |
| if: github.event.workflow_run.conclusion == 'success' | |
| steps: | |
| - name: Get information about workflow origin | |
| uses: potiuk/get-workflow-origin@v1_5 | |
| id: source-run-info | |
| with: | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| sourceRunId: ${{ github.event.workflow_run.id }} | |
| # Once https://github.com/actions/download-artifact/issues/172 and/or https://github.com/actions/download-artifact/issues/60 is implemented, we can use the official download-artifact action | |
| # For now use the solution from https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#using-data-from-the-triggering-workflow | |
| - name: Download docs | |
| uses: actions/[email protected] | |
| with: | |
| script: | | |
| var artifacts = await github.actions.listWorkflowRunArtifacts({ | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| run_id: ${{github.event.workflow_run.id }}, | |
| }); | |
| var matchArtifact = artifacts.data.artifacts.filter((artifact) => { | |
| return artifact.name == "doc" | |
| })[0]; | |
| var download = await github.actions.downloadArtifact({ | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| artifact_id: matchArtifact.id, | |
| archive_format: 'zip', | |
| }); | |
| var fs = require('fs'); | |
| fs.writeFileSync('${{github.workspace}}/doc.zip', Buffer.from(download.data)); | |
| - name: Extract docs | |
| run: unzip doc.zip -d doc | |
| - name: Deploy to Netlify | |
| id: deploy-netlify | |
| uses: netlify/actions/cli@master | |
| with: | |
| args: deploy --dir=doc ${NETLIFY_PRODUCTION:+"--prod"} --message ${NETLIFY_MESSAGE} --alias ${NETLIFY_ALIAS} | |
| env: | |
| NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }} | |
| NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }} | |
| NETLIFY_PRODUCTION: ${{ github.ref == 'refs/heads/master' }} | |
| NETLIFY_MESSAGE: ${{ steps.source-run-info.outputs.pullRequestNumber }} | |
| NETLIFY_ALIAS: deploy-preview-${{ steps.source-run-info.outputs.pullRequestNumber }} | |
| # Add deployment as status check, PR comment and annotation | |
| # we could use the nwtgck/actions-netlify action for that, except for that it is not (yet) working in workflow_run context: https://github.com/nwtgck/actions-netlify/issues/545 | |
| - name: Add/Update deployment status PR comment | |
| uses: marocchino/sticky-pull-request-comment@v2 | |
| with: | |
| number: ${{ steps.source-run-info.outputs.pullRequestNumber }} | |
| header: preview-comment | |
| message: | | |
| [Documentation preview for this PR](${{ steps.deploy-netlify.outputs.NETLIFY_URL }}) is ready! :tada: | |
| Built with commit: ${{ steps.source-run-info.outputs.sourceHeadSha }} | |
| - name: Update deployment status PR check | |
| uses: myrotvorets/[email protected] | |
| if: ${{ always() }} | |
| env: | |
| DEPLOY_SUCCESS: Successfully deployed preview. | |
| DEPLOY_FAILURE: Failed to deploy preview. | |
| with: | |
| token: ${{ secrets.GITHUB_TOKEN }} | |
| status: ${{ job.status == 'success' && 'success' || 'failure' }} | |
| sha: ${{ github.event.workflow_run.head_sha }} | |
| context: Deploy Documentation | |
| targetUrl: ${{ steps.deploy-netlify.outputs.NETLIFY_URL }} | |
| description: ${{ job.status == 'success' && env.DEPLOY_SUCCESS || env.DEPLOY_FAILURE }} | |
| - name: Report deployment url | |
| run: | | |
| echo "::notice::The documentation has being automatically deployed to Netlify. %0A ✅ Preview: ${{ steps.deploy-netlify.outputs.NETLIFY_URL }}" | |