Skip to content

[chore] ci: publish qa builds of release lines and tagged prs to github pages - #129

Merged
arpit-bruno merged 4 commits into
usebruno:mainfrom
arpit-bruno:ci/gh-pages-qa-builds
Nov 13, 2026
Merged

arpit-bruno merged 4 commits into
usebruno:mainfrom
arpit-bruno:ci/gh-pages-qa-builds

Conversation

@arpit-bruno

@arpit-bruno arpit-bruno commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

Ref: BRU-5035

QA builds now publish to GitHub Pages on their own. Today every deploy for QA is a manual run in the closed builder repo, so this automates that first step. Staging (regression) and production stay on the builder.

Every push to a release/** branch publishes that line to https://usebruno.github.io/bruno-api-docs/release-vX.Y.Z/. For an urgent check on a PR, scripts/pages-preview.sh <pr> tags its head preview/pr-<n> and it publishes to /pr-<n>/.

Why GitHub Pages: it comes free with the repo, so there's no AWS setup or extra keys to manage.

The build uses the same commands and Bruno.build / version.json stamp as the builder repo, so it works on 0.5.x and on the 0.6.0 package split. Each deploy only replaces its own folder and gh-pages stays a single commit, so its history doesn't grow. The run goes green only once Pages serves the new sha.

Note:

  • A tag runs the PR's own copy of the workflow, so the helper refuses PRs that change .github/. If you push a preview/pr-* tag by hand, review the PR's .github/ changes first.
  • CI-only change, so it lands on main and then merges forward into release/v0.5.1 and release/v0.6.0.
  • After merge: Settings → Pages → source gh-pages branch.

Checked by running the publish step against a local bare repo: first deploy, redeploy of the same line, and five deploys racing at once all land with one commit on gh-pages. The helper refuses this PR (it changes .github/) and pushes no tag.

@changeset-bot

changeset-bot Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: fa7b54a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@arpit-bruno arpit-bruno changed the title ci: publish qa builds of release lines and tagged prs to github pages [chore] ci: publish qa builds of release lines and tagged prs to github pages Nov 13, 2026
@arpit-bruno
arpit-bruno merged commit 9013fd7 into usebruno:main Nov 13, 2026
6 checks passed
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