Skip to content

Fix docs site deploy by using the official GitHub Pages actions - #503

Open
jjacobson95 wants to merge 1 commit into
mainfrom
docs-deploy-pages-501
Open

jjacobson95 wants to merge 1 commit into
mainfrom
docs-deploy-pages-501

Conversation

@jjacobson95

@jjacobson95 jjacobson95 commented Sep 28, 2026 •

Copy link
Copy Markdown
Collaborator

Documentation Update #1


Merge this first.

The Sphinx-docs workflow built the docs but the Deploy step failed, so the live site stopped updating. The deploy used peaceiris/actions-gh-pages with a DOCSITE_TOKEN secret that is no longer valid (password auth), causing git to fail with exit code 128 on every recent run.

This switches the deploy to the built-in GitHub Pages pipeline (actions/upload-pages-artifact + actions/deploy-pages), which authenticates with the workflow's OIDC token and needs no PAT. The repo's Pages source was set to "GitHub Actions".

Verified: the workflow's build and deploy jobs both succeed and the live site at https://pnnl-compbio.github.io/coderdata/ rebuilds.

Closes #501

The Sphinx-docs deploy used peaceiris/actions-gh-pages with a
DOCSITE_TOKEN secret that is no longer valid, so pushes to gh-pages
failed with a git auth error and the site stopped updating. Switch to
the built-in Pages pipeline (upload-pages-artifact + deploy-pages),
which authenticates via the workflow's OIDC token and needs no PAT.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

'build' update documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs site deploy fails

1 participant