Skip to content

docs: add Apache APISIX 3.21.0 release notes - #2154

Merged
kayx23 merged 4 commits into
masterfrom
docs/apisix-3.21.0-release-notes
Nov 20, 2026
Merged

kayx23 merged 4 commits into
masterfrom
docs/apisix-3.21.0-release-notes

Conversation

@kayx23

@kayx23 kayx23 commented Nov 19, 2026 •

Copy link
Copy Markdown
Member

Summary

  • add English and Chinese release notes for Apache APISIX 3.21.0
  • document the Runtime 1.4.3 / NGINX 1.31.9 security update and its compatibility impact
  • provide upgrade plans for Runtime and Admin API key validation changes
  • group security, upstream recovery, and logger delivery fixes by operator impact

Source verification

The drafts were audited against:

  • APISIX 3.20.0 tag bc1e687fdb82883f86d1bca9fa4fbd6bb433682b
  • 3.21 candidate tree 07446140f87b475330ab86f280b94eaf2aeda020
  • merged source, tests, schemas, and final release-tree behavior for every changelog PR
  • NGINX 1.31.9 security advisories and APISIX Runtime 1.4.3 integration

All 13 changelog PRs were reviewed individually. The release notes directly cover the eight changes new to 3.21.0. PRs #14162, #14163, #14181, #13723, and #14101 are omitted because their merge commits are already ancestors of the 3.20.0 tag.

Validation

  • frontmatter lint
  • git diff --check
  • English production blog compilation
  • Chinese production blog compilation
  • English/Chinese structure and terminology parity
  • independent source and editorial reviews

The language builds reported existing site-wide navigation and historical-post link warnings unrelated to these files; both client and server bundles compiled successfully.

Draft status

November 20, 2026 remains a provisional date. Under ASF release policy, the final date should be the day the artifacts become available through the public ASF download system, not merely the day they are committed to dist/release.

  • The 3.21.0 tag and GitHub release are published.
  • The ASF source artifact is committed to the release repository.
  • The public downloads.apache.org and CDN paths are still synchronizing. Before marking ready, verify the first day the source archive is publicly downloadable and adjust both date directories and descriptions if necessary.

@moonming
moonming marked this pull request as ready for review November 20, 2026 02:18
moonming
moonming previously approved these changes Nov 20, 2026
membphis
membphis previously approved these changes Nov 20, 2026
@kayx23
kayx23 dismissed stale reviews from membphis and moonming via 6019dcf November 20, 2026 02:31
@kayx23
kayx23 merged commit 85ec0eb into master Nov 20, 2026
6 checks passed
@kayx23
kayx23 deleted the docs/apisix-3.21.0-release-notes branch November 20, 2026 02:37
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