Skip to content

feat!: migrate all templates from app_id to client_id (major)#458

Open
timdittler wants to merge 1 commit into
mainfrom
feat/automerge-client-id
Open

feat!: migrate all templates from app_id to client_id (major)#458
timdittler wants to merge 1 commit into
mainfrom
feat/automerge-client-id

Conversation

@timdittler

@timdittler timdittler commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

What

Org-wide migration of the GitHub App auth secret from app_id/app-id to client_id/client-id across all templates. create-github-app-token deprecated its app-id input in favor of client-id; templates now pass the secret to client-id.

Migrated

Template before after
template_automerge_dependabot app_id (required) client_id (required)
template_autodev app_id client_id
template_changeset_release app_id client_id
template_release_drafter app_id client_id
template_terraform_format app-id client-id
template_gitops app-id client-id
versions.yml (internal) vars.STAFFBASE_ACTIONS_APP_ID vars.STAFFBASE_ACTIONS_CLIENT_ID

README examples updated.

Breaking / semver

major label set so release-drafter cuts v14.0.0. Callers pin exact tags/SHAs, so nothing breaks until a caller bumps to v14 — at which point it must rename its secret to client_id/client-id and pass the App's client id value (not the numeric app id). Callers are intentionally not migrated here.

Prerequisites

  • Org variable STAFFBASE_ACTIONS_CLIENT_ID (staffbase-actions app client id) must exist — versions.yml in this repo uses it immediately on merge.

Related

  • Staffbase/open-source-policy#57 (adopts the auto-merge template)
  • Staffbase/infrastructure#15517 (howto doc)

@timdittler timdittler force-pushed the feat/automerge-client-id branch from 15a21cf to ec07e3d Compare June 10, 2026 09:00
@timdittler timdittler added the major Pull requests with breakable changes label Jun 10, 2026
@timdittler timdittler force-pushed the feat/automerge-client-id branch from ec07e3d to 1fcb43d Compare June 10, 2026 09:10
@timdittler timdittler changed the title feat(automerge): support client_id secret (app_id deprecated) feat!: migrate all templates from app_id to client_id (major) Jun 10, 2026
BREAKING CHANGE: every template that authenticated via a GitHub App now
requires a client_id (client-id) secret instead of app_id (app-id), and
passes it to create-github-app-token's client-id input. The action
deprecated app-id in favor of client-id.

Migrated templates:
- template_automerge_dependabot: app_id  -> client_id (now required)
- template_autodev:              app_id  -> client_id
- template_changeset_release:    app_id  -> client_id
- template_release_drafter:      app_id  -> client_id
- template_terraform_format:     app-id  -> client-id
- template_gitops:               app-id  -> client-id
- versions.yml (internal):       STAFFBASE_ACTIONS_APP_ID -> STAFFBASE_ACTIONS_CLIENT_ID

Callers must pass their App's client id (not app id). Existing callers are
unaffected until they bump to this major version, at which point they must
rename the secret. README examples updated.
@timdittler timdittler force-pushed the feat/automerge-client-id branch from 1fcb43d to 451b53d Compare June 10, 2026 09:17
@timdittler timdittler marked this pull request as ready for review June 10, 2026 10:41
@timdittler timdittler requested a review from a team as a code owner June 10, 2026 10:41
@timdittler timdittler requested review from axdotl and timkante June 10, 2026 10:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

major Pull requests with breakable changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant