nacos-download-page

name

nacos-download-page

description

Updates Nacos download page and release history from a GitHub release URL. Fetches version and MD5 from the release, updates nacos-server.mdx (stable/snapshot), migrates previous stable row to release-history.mdx, updates the top tip with release summary, and syncs all changes to other locales (e.g. en). Use when the user provides a GitHub release link to update the download page or when asked to update Nacos download/release history from a release.

Nacos Download Page Updater

Update src/content/download/{i18n}/nacos-server.mdx and src/content/download/{i18n}/release-history.mdx from a GitHub release URL. Locales: zh-cn (source), en (and any others under src/content/download/).

1. Parse the GitHub Release

• Input: User provides a GitHub release URL (e.g. https://github.com/alibaba/nacos/releases/tag/3.1.2).
• Fetch the release page (or use GitHub API) to get:
  • Version: From the release title (e.g. "Nacos 3.1.2" → 3.1.2).
  • Release date: From published_at (API) or page, format YYYY-MM-DD.
  • MD5: From assets. Only the zip package is needed:
    • Find the asset named like nacos-server-{version}.zip.
    • Find the corresponding MD5 asset (e.g. nacos-server-{version}.zip.md5 or similar). Download or fetch its content; the file content is the MD5 string (strip whitespace/newline).
  • Release notes body: Used later for the tip summary.

If no .md5 file exists in assets, leave MD5 blank or note in the table that it’s missing (follow existing pattern in the repo).

2. Classify Version and Target Section

• 3.x stable: Version matches 3.x and is not a pre-release (no ALPHA/BETA/RC in the tag/title) → update 3.x stable table in nacos-server.mdx.
• 2.x stable: Version matches 2.x and is not a pre-release → update 2.x stable table in nacos-server.mdx.
• Other (e.g. ALPHA, BETA, RC, or non-2/3): → update 快照版本 / Snapshot Versions in nacos-server.mdx.

Stable download links use https://download.nacos.io/nacos-server/nacos-server-{version}.zip. Snapshot versions often use https://github.com/alibaba/nacos/releases/download/{tag}/nacos-server-{version}.zip (tag may include suffix, e.g. 3.1.0-BETA).

3. Update nacos-server.mdx (per locale)

• Stable (3.x or 2.x):
  • Replace the single current row in the corresponding subsection (### 3.x or ### 2.x) with the new version row (Version, Binary link, Docker image link, MD5, Release notes link, Reference doc link). Keep table header and structure unchanged.
  • Docker image: [nacos/nacos-server\:v{version}](https://hub.docker.com/r/nacos/nacos-server/tags?page=1&name={version}).
  • Release notes: [发布说明](https://github.com/alibaba/nacos/releases/tag/{tag}) (zh-cn) / [Release Notes](...) (en). Use the tag from the URL (e.g. 3.1.0-BETA).
  • Reference doc: 3.x → latest/next; 2.x → v2.5 or corresponding; see reference.md.
• Snapshot:
  • Remove any existing snapshot row(s) that belong to the same major version (e.g. when adding 3.2.0-BETA, remove 3.1.0-BETA; when adding 2.5.0-ALPHA, remove any other 2.x snapshot). The snapshot table keeps at most one snapshot per major version—the one being added.
  • Add a new row for the new snapshot version. Snapshot Docker text: zh-cn “快照版本不提供镜像…” / en “Snapshots do not provide images…”; link to nacos/nacos-server:latest.

4. If This Is a 2.x or 3.x Stable Release: Update release-history.mdx

• Move the “old” stable row from nacos-server.mdx (the row that was there before your update) into release-history.mdx.
  • In release-history.mdx, tables are grouped by major version: 3.x (first table, no “Nacos 3.x” heading in zh-cn; en has “## Nacos 3.x”), 2.x (“## Nacos 2.x”), 1.x (“## Nacos 1.x”).
• Add one new row at the top of the correct major-version table:
  • Columns: 发布时间 (Release Date) | 版本 (Version) | Java版本要求 (Required Java Version) | 相关链接 (Links).
  • 发布时间: YYYY-MM-DD from the release.
  • 版本: [X.Y.Z](https://download.nacos.io/nacos-server/nacos-server-X.Y.Z.zip).
  • Java: 3.x → Java 17; 2.x → Java 8.
  • 相关链接: 发布说明 + 参考文档 (same pattern as existing rows).
• Update the “latest version” text in the intro of release-history.mdx: zh-cn “当前最新版本是 X.Y.Z” / en “the latest version is X.Y.Z” to the new stable version you just added.

5. Update the Top Tip in nacos-server.mdx

• Summarize the GitHub release notes in 1–2 short sentences (Chinese for zh-cn, English for en).

• Replace the :::tip content with (zh-cn):

  Nacos Server **{new_version}** 已发布。{新版本主要总结}。
  
  欢迎[下载和试用](#稳定版本)。
  

  For snapshot-only updates, use #快照版本 instead of #稳定版本; if both apply, use “稳定版本” or “快照版本” as appropriate.

• En locale equivalent:

  Nacos Server **{new_version}** has been released. {Short summary in English}.
  
  Feel free to [download and try it out](#stable-versions).
  

  Use #snapshot-versions when the release is snapshot-only.

6. i18n: Apply to All Locales

• Source of truth: zh-cn for structure and wording in Chinese.
• Other locales: Apply the same structural edits (tables, new row, release-history row, “latest version” text). Translate only the tip summary and any locale-specific strings (e.g. “已发布” → “has been released”, “欢迎下载和试用” → “Feel free to download and try it out”).
• Ensure every locale under src/content/download/ (e.g. en) gets the same table and link updates; only the tip and intro texts are translated.

7. Homepage Release Info (Stable-Only by Default)

When updating release download info, also check homepage release info:

• src/components/home/EarthBackground.astro (latest release note link)
• src/i18n/zh-cn/ui.ts:
  • home.introduce.nacos.notes
  • home.introduce.nacos.release.note.1
  • home.introduce.nacos.release.note.1.mobile
• src/i18n/en/ui.ts:
  • home.introduce.nacos.notes
  • home.introduce.nacos.release.note.1
  • home.introduce.nacos.release.note.1.mobile

Update policy

• Default: Update homepage release info only for stable GA releases (for example 3.2.1).
• Do NOT update homepage by default for pre-release/non-GA versions such as:
  • versions containing suffixes like -ALPHA, -BETA, -RC (case-insensitive),
  • date-suffixed tags/versions like -20260423 or other -<date> style suffixes.
• For those pre-release/non-GA versions, update homepage release info only when explicitly requested by the user/developer.

Checklist

• Fetched version, release date, zip MD5, and release notes from the GitHub release.
• Updated the correct section in nacos-server.mdx (3.x / 2.x stable or snapshot).
• If snapshot: removed any existing snapshot row of the same major version before adding the new snapshot row.
• If stable: moved previous stable row to release-history.mdx and added new row; updated “latest version” in release-history intro.
• Updated the top tip with new version and 1–2 sentence summary in nacos-server.mdx.
• Applied all edits to en (and any other locale) with translated tip/intro.
• Updated homepage release info for GA releases only; skipped pre-release homepage updates unless explicitly requested.

Reference

• File paths and table formats: reference.md.