Skip to content

Migrate workflows from PATs to GitHub App - #220

Open
eric-schneider wants to merge 1 commit into
mainfrom
docs-github-app-docs-ui
Open

eric-schneider wants to merge 1 commit into
mainfrom
docs-github-app-docs-ui

Conversation

@eric-schneider

@eric-schneider eric-schneider commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

All Classic and Fine-grained Personal Access Tokens (PATs) are being retired for DataStax GitHub orgs. The draft trigger and the UI bundle release sign in with DOCS_GITHUB_PAT, one of those tokens.

This pull request switches the trigger to a short-lived token from the Docs team's GitHub App, made with actions/create-github-app-token. The token is limited to GitHub Actions in riptano/datastax-docs-site, where it starts the draft build and follows it.

The release no longer stores a token: nothing it runs needs one, since npm ci installs only from the npm registry and the release uses GitHub's built-in token.

Its draft check fails until the App is set up, because the check runs the changed workflow. Once the App is in place, I'll re-run the check and merge this when it passes, so please leave the merge to me. Merging it runs the release workflow, which publishes a new UI bundle from main.

GitHub blocks every personal access token in the riptano and datastax
organizations from 19 November 2026, 4 PM Pacific. The draft trigger and
the UI bundle release sign in with DOCS_GITHUB_PAT, one of those tokens.

Get a short-lived token for the draft trigger from the Docs GitHub App
instead, with actions/create-github-app-token. It is limited to GitHub
Actions in riptano/datastax-docs-site, where it starts the draft build
and follows it. The App's client ID and private key come from
organization variables and secrets: DOCS_APP_RIPTANO_CLIENT_ID and
DOCS_APP_RIPTANO_PRIVATE_KEY where each organization has its own App,
otherwise DOCS_APP_CLIENT_ID and DOCS_APP_PRIVATE_KEY.

The release no longer stores a token: nothing it runs needs one, since
npm ci installs only from the npm registry and the release uses GitHub's
built-in token.
@github-actions

github-actions Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

UI bundle preview build successful! ✅
Deploying bundle preview.
Deploy successful! View preview

@eric-schneider eric-schneider changed the title Use the Docs GitHub App's token instead of a PAT Migrate workflows from PATs to GitHub App Nov 19, 2026
@eric-schneider eric-schneider self-assigned this Nov 19, 2026

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

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant