Skip to content

Curate the 1.22.0 changelog - #7787

Open
CharlieTLe wants to merge 1 commit into
cortexproject:masterfrom
CharlieTLe:release-1.22-pr-e-changelog-curation
Open

Curate the 1.22.0 changelog#7787
CharlieTLe wants to merge 1 commit into
cortexproject:masterfrom
CharlieTLe:release-1.22-pr-e-changelog-curation

Conversation

@CharlieTLe

Copy link
Copy Markdown
Member

Groundwork for the v1.22.0 release (rc.0 scheduled 2026-09-12 per RELEASE.md). Gets the
unreleased section into the shape RELEASE.md asks for before the release-1.22 cut,
so operators reading the release notes actually see the changes that affect them.

CHANGELOG.md only.

Mechanical

  • Delete the stale duplicate of #7375, which already shipped in 1.21.0 as #7370
    (byte-identical text, only the PR number differs).
  • Re-sort into CHANGEFEATUREENHANCEMENTBUGFIX per RELEASE.md. The
    section previously opened with a FEATURE sitting above three CHANGEs.
  • Correct the gRPC entry: the bump landed at v1.82.1 (go.mod confirms), not v1.79.3.
  • Fold follow-up PRs into the entry they belong to: #5449 #7687, #7302 #7458,
    #7691 #7505 #7740, #7437 #7434 #7716 #7726, #7460 #7719.

Missing user-facing entries

From ./tools/release/check-changelog.sh v1.21.1...master. Everything else it lists is
correctly omitted (CI, tests, docs, dependabot).

  • #7513 — Alertmanager: removal of the legacy state-file migration.
  • #7514cortex_ingester_head_metric_names.
  • #7559DoBatch cleanup callback deadlock on panic.

Reclassified as CHANGE

These are breaking changes that were filed as BUGFIX/ENHANCEMENT, so they would not
have appeared in the upgrade notes:

  • #7587 sign-key validation — its own text already says "fail at process startup; audit
    your configs before upgrading".
  • #7767 + #7768 Alertmanager per-tenant *_file rejection — merged into one entry;
    tenant configs that previously loaded are now rejected.
  • #7649 time_takentime_taken_ms — renames and re-units a slow-query-log field.

Kept in place, with operator impact noted

  • #7637 alpine → distroless. Not config or API, so not a CHANGE by house convention,
    but the image has no shell — noted that shell-based probes, init scripts and
    kubectl exec workflows need adjusting.
  • #7717 / #7738 500 → 499. A genuine bugfix, but it deflates
    cortex_request_duration_seconds{status_code="500"} and changes SLO math.

Result

7 CHANGE / 14 FEATURE / 37 ENHANCEMENT / 34 BUGFIX = 92 entries (from 91).

Merging this first keeps the other release-prep PRs from all conflicting at the top of the
file.

Get the unreleased section into the shape RELEASE.md asks for before the
release-1.22 cut, so operators reading the notes see the changes that affect them:

- Delete the stale duplicate of cortexproject#7375, which already shipped in 1.21.0 as cortexproject#7370.
- Re-sort into CHANGE -> FEATURE -> ENHANCEMENT -> BUGFIX.
- Correct the gRPC entry: the bump landed at v1.82.1, not v1.79.3.
- Fold follow-up PRs into the entry they belong to.
- Add three missing user-facing entries: cortexproject#7513, cortexproject#7514 and cortexproject#7559.
- Reclassify as CHANGE the entries that break existing configs or log consumers:
  the sign-key validation (cortexproject#7587), the Alertmanager per-tenant *_file rejections
  (cortexproject#7767, cortexproject#7768, now one entry) and the time_taken -> time_taken_ms rename (cortexproject#7649).
- Note the operator impact of the distroless base image (cortexproject#7637) and of the
  500 -> 499 reclassification (cortexproject#7717).

Signed-off-by: Charlie Le <charlie_le@apple.com>
@dosubot dosubot Bot added the type/chore Something that needs to be done; not a bug or a feature label Aug 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/S type/chore Something that needs to be done; not a bug or a feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant