Skip to content

(internal) release: build v8.1.2687 - #499

Closed
sourcegraph-bot-2 wants to merge 6 commits into
mainfrom
internal/release-v8.1.2687
Closed

sourcegraph-bot-2 wants to merge 6 commits into
mainfrom
internal/release-v8.1.2687

Conversation

@sourcegraph-bot-2

Copy link
Copy Markdown
Contributor

Test plan: automated release PR, CI will perform additional checks

michaellzc and others added 6 commits October 21, 2026 11:54
…orker (#493)

Backports #492 so 8.1.x patch releases use the same releaseworker-owned
"Update main" flow as main. This is an unchanged cherry-pick: remove the
old finalize PR creation and exclude update-main branches from promote
steps.

Requires sourcegraph/sourcegraph#17347 to be deployed before the next
release. Companion backports are deploy-sourcegraph-helm#974 and the
deploy-sourcegraph-docker backport of #1443.

Co-authored-by: Warren Gifford <warrenbruceg@gmail.com>
…ation retry-safe (#498)

Backport ff33932 from #497

The v8.1.1335 promotion ran finalize twice in this repo, and the build
the release worker monitors lost:

| Build | Commit | Started by | Promote finalize |
|---|---|---|---|
|
[#1197](https://buildkite.com/sourcegraph/deploy-sourcegraph-k8s/builds/1197)
| `e84e57b` "release: v8.1.1335" (internal config commit) | creating
`promote/release-v8.1.1335` | **passed** at 07:09: tagged the promote
branch head `6a0aebb`, pushed `release-v8.1.1335`, promoted on the
release registry |
|
[#1201](https://buildkite.com/sourcegraph/deploy-sourcegraph-k8s/builds/1201)
| `6a0aebb` "promote-release: v8.1.1335" | push | **failed** 4×: `fatal:
tag 'v8.1.1335' already exists` |

Creating the promote branch from the internal branch builds the internal
config commit, and `--config-from-commit` accepts its config, so that
build runs the promote jobs too. Its finalize tags whatever the promote
branch head is when it gets there. Build #1201 is the one the release
worker monitors, so the promote workflow failed and never closed the
release PRs or opened the "Update main" PR. Those were done by hand:
#494 and #495 are closed, and #496 is the "Update main" PR. Helm failed
the same way (sourcegraph/deploy-sourcegraph-helm#979). Docker avoided
it only because the extra build was cancelled by a newer push.

This is the same change as sourcegraph/deploy-sourcegraph-helm#979 and
sourcegraph/deploy-sourcegraph-docker#1449:

- **Promote jobs run only for the promote config commit.** `(promote)
Release: test` and `finalize` now also require `build.message =~
/^promote-release:/`. Both the release worker and this repo's
`release.yaml` manual flow write that message.
- **`git:tag` is retry-safe.** If `vX` already points at the promote
branch head, it skips creating the tag and continues. If it points
anywhere else, it fails. The release registry's promote endpoint already
treats re-promoting as a no-op (200), so a retried finalize now succeeds
end to end.

## How this was tested

- **Job conditions.** I checked the old and new conditions against this
repo's real v8.1.1335 promote-branch commits. Before, every commit ran
the promote jobs. After, only `6a0aebb` "promote-release: v8.1.1335"
runs them; `e84e57b` "release: v8.1.1335" (build #1197) and the three
image-update commits skip them. This PR's Buildkite build validates that
the pipeline, with its new conditionals, uploads.
- **`git:tag`.** I extracted the step from this repo's `release.yaml`,
stubbed `gh` and `buildkite-agent`, and ran it in fresh clones against a
scratch bare remote:
- **First finalize:** exits 0; the tag and `release-vX` are on the
promote head.
- **Retry or duplicate:** exits 0 with "already points at … not
recreating it".
- **Tag on another commit:** exits 1 with a message naming both commits.
- **Control:** `main`'s step on the retry case exits 128 with `fatal:
tag 'v9.9.9' already exists`.

## Rollout

Buildkite reads `pipeline.yaml` and `release.yaml` from the commit it
builds, so patch releases need this on their `X.Y.x` branch. It's
labelled `backport 8.1.x`; both files are identical on `8.1.x`, so the
backport applies cleanly.
{"version":"v8.1.2687","inputs":"server=v8.1.2687","type":"patch"}
@sourcegraph-bot-2
sourcegraph-bot-2 requested a review from a team October 29, 2026 19:29
@sourcegraph-buildkite

Copy link
Copy Markdown
  • 🟢 Internal release is ready for promotion!
  • ⚠️ Do not close/merge the pull request or delete the associated branch if you intend to promote it.

@sourcegraph-buildkite

Copy link
Copy Markdown

@marcleblanc2
marcleblanc2 deleted the internal/release-v8.1.2687 branch October 30, 2026 01:28
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.

4 participants