Skip to content

Add .github/README.md documenting CI/release workflows - #841

Open
shambupujar wants to merge 1 commit into
mainfrom
chore/fix-ci-docs
Open

shambupujar wants to merge 1 commit into
mainfrom
chore/fix-ci-docs

Conversation

@shambupujar

@shambupujar shambupujar commented Sep 6, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds .github/README.md as a reference doc for the 8 workflows in .github/workflows/, mirroring the same doc already added to the babylon-node repo. There was no existing documentation covering which workflows run automatically vs. need manual dispatch, the release sequence, or what each job depends on externally.

  • Automatic workflows table: main.yml, build-typescript-sdk.yml, postman.yml, pr-namespace-deletion.yml, release-drafter.yml, releases.yml.
  • Manual workflows table: publish-typescript-sdk.yml, and postman.yml's workflow_dispatch path.
  • Release sequence, cross-referenced against docs/releasing-new-version.md's existing runbook.
  • External dependencies per job: secrets, AWS IAM roles/Secrets Manager paths, self-hosted runner requirements (selfhosted-ec2-ubuntu-22-arm-4core for CI vs. babylon-gateway-arm for releases — two separate ARM pools), GitHub environment gates (Postman, release), and third-party services (Docker Hub, SonarCloud, Postman, Jenkins, a Cloudflare-fronted webhook dispatcher).

Details

Also flags a few things found while cataloging, in the "Notes" section of the README itself rather than changing behavior here:

  • postman.yml and pr-namespace-deletion.yml both use a hardcoded literal AWS role ARN instead of the secrets.GH_BABYLON_GATEWAY_SECRETS_READ_ACCESS_ROLE reference main.yml uses for the same role — worth reconciling separately.
  • ephemeral-deploy-and-test only triggers a Jenkins job; a green check there means the job was triggered, not that it passed.
  • publish-typescript-sdk.yml explicitly unsets NODE_AUTH_TOKEN/NPM_CONFIG_USERCONFIG before npm publish, so its actual publish auth source isn't visible in the workflow file itself.

Testing

Documentation-only change — no workflow behavior modified. Verified the documented triggers, environment gates (Postman, release), self-hosted runner labels, and secret names directly against the current .github/workflows/*.yml and .github/actions/*/action.yml files.

Catalogs every workflow's trigger, the release sequence, and each job's
external dependencies (secrets, AWS roles/Secrets Manager paths,
self-hosted runners, GitHub environment gates, third-party services),
mirroring the same reference doc added to babylon-node.
@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown

Docker tags
docker.io/radixdlt/private-babylon-ng-database-migrations:HEAD-4790488-arm64

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown

Docker tags
docker.io/radixdlt/private-babylon-ng-gateway-api:HEAD-4790488-arm64

@github-actions

github-actions Bot commented Sep 6, 2026 •

Copy link
Copy Markdown

Docker tags
docker.io/radixdlt/private-babylon-ng-data-aggregator:HEAD-4790488-arm64

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

Development

Successfully merging this pull request may close these issues.

1 participant