feat: github action to integrate/publish endo and agoric-sdk reference docs too #362
Workflow file for this run
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
| name: Build and Deploy documentation site | |
| on: | |
| # If it's a push to production branch, Cloudflare wrangler will deploy it as a | |
| # production deployment | |
| # The production branch for documentation project on Cloudflare is configured | |
| # to be `main` | |
| push: | |
| branches: | |
| - main | |
| # If it's a push to a non-production branch, Cloudflare wrangler will deploy | |
| # it as a preview deployment | |
| pull_request: | |
| branches: | |
| - "*" | |
| jobs: | |
| build-and-deploy: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v4 | |
| - name: Checkout Endo | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: endojs/endo | |
| path: endo | |
| - name: Build Endo docs | |
| run: | | |
| cd endo | |
| yarn install | |
| yarn docs:markdown-for-agoric-documentation-repo | |
| - name: Move Endo docs into main/reference | |
| run: mv endo/api-docs main/reference/endo | |
| - name: Checkout agoric-sdk | |
| uses: actions/checkout@v4 | |
| with: | |
| repository: agoric/agoric-sdk | |
| path: agoric-sdk | |
| - name: Build agoric-sdk docs | |
| run: | | |
| cd agoric-sdk | |
| yarn install | |
| yarn build | |
| yarn docs:markdown-for-agoric-documentation-repo | |
| - name: Move agoric-sdk docs into main/reference | |
| run: mv agoric-sdk/api-docs main/reference/agoric-sdk | |
| - name: Build Doc site | |
| run: | | |
| yarn install | |
| yarn docs:build-cf | |
| - name: Publish to Cloudflare Pages | |
| id: publish-to-cloudflare-pages | |
| uses: cloudflare/wrangler-action@v3 | |
| with: | |
| apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }} | |
| # Cloudflare account ID is safe to be public | |
| # Ref: https://github.com/cloudflare/wrangler-legacy/issues/209#issuecomment-541654484 | |
| accountId: 0c4635effffcd7f36d1b9f0425a4367a | |
| command: pages deploy --project-name=documentation dist/ | |
| - name: Comment with preview URL | |
| if: github.event_name == 'pull_request' | |
| uses: actions/github-script@v7 | |
| with: | |
| script: | | |
| github.rest.issues.createComment({ | |
| issue_number: context.issue.number, | |
| owner: context.repo.owner, | |
| repo: context.repo.repo, | |
| body: 'Cloudflare Pages Preview URL: ${{ steps.publish-to-cloudflare-pages.outputs.deployment-url }}' | |
| }) |