Skip to content

Fix the Python 1.3.0 release metadata leaked by the release automation - #897

Merged
wu-sheng merged 1 commit into
masterfrom
fix/python-1-3-0-release-metadata
Aug 15, 2026
Merged

Fix the Python 1.3.0 release metadata leaked by the release automation#897
wu-sheng merged 1 commit into
masterfrom
fix/python-1-3-0-release-metadata

Conversation

@wu-sheng

Copy link
Copy Markdown
Member

The Python 1.3.0 release commit (#896) was generated with un-interpolated GitHub Actions template syntax. The site build has failed on every scheduled run since it merged, and the metadata it published is wrong in several places.

The build failure

data/docs.yml was committed with the template literal:

commitId: ${{ steps.release.outputs.commit-id }}

docs.js interpolates that value into a shell command (execSync("./doc.sh" ... "${commitId}" ...)), so /bin/sh reports Bad substitution and the build exits 1. See the failing run: https://github.com/apache/skywalking-website/actions/runs/31878513365/job/94997629899

Both entries now point at 1bd4692f927a4c6156bc25d18d36d9cba76405df, the v1.3.0 tag commit. Re-running the exact doc.sh invocation that CI failed on now succeeds.

Other placeholder damage from the same commit

  • data/docs.yml — the v1.2.0 entry was overwritten rather than a new entry inserted, so the version dropdown lost 1.2.0 and showed 1.3.0 (no v prefix) pointing at the v1.2.0 doc path. Restores v1.2.0 and adds a proper v1.3.0 entry sharing the Latest commitId.
  • data/releases.yml — the 1.2.0 download links were replaced instead of demoted, so 1.2.0 was no longer downloadable at all. Demotes 1.2.0 to archive.apache.org and keeps v1.3.0 on closer.cgi / downloads.apache.org. Also fixes the distribution entry's missing v prefix and normalizes the date format.
  • content/events/… — the post rendered as Release Apache SkyWalking Python with the version missing from the title, description and body, a broken PyPI link (apache-skywalking//), and no changes listed. Rewritten with the actual 1.3.0 release notes. The directory is also renamed to the dashed slug convention (…-python-1-3-0) used by every other release post; the dotted URL was never deployed, since the build has been broken since the release merged.

Worth checking whatever generated #896 before the next release — it will reproduce this.

The 1.3.0 release commit (#896) was generated with un-interpolated GitHub
Actions template syntax, which broke the site build and published wrong
metadata:

- data/docs.yml carried `commitId: ${{ steps.release.outputs.commit-id }}`
  verbatim. docs.js shells that value into `./doc.sh`, so /bin/sh reported
  "Bad substitution" and the scheduled Build site workflow has failed on
  every run since the merge. Both entries now point at 1bd4692, the v1.3.0
  tag commit.
- The v1.2.0 docs entry had been overwritten rather than a v1.3.0 entry
  inserted, leaving version `1.3.0` (no v prefix) linked to the v1.2.0
  path. Restore v1.2.0 and add a proper v1.3.0 entry.
- data/releases.yml replaced the 1.2.0 download links instead of demoting
  them to archive.apache.org, so 1.2.0 was no longer downloadable. Demote
  1.2.0 and keep v1.3.0 on closer.cgi/downloads.apache.org.
- The event post rendered as "Release Apache SkyWalking Python " with an
  empty version everywhere, including a broken PyPI link
  (apache-skywalking//), and listed no changes. Rewrite it with the 1.3.0
  release notes, and rename the directory to the dashed slug convention
  used by every other release post.
@netlify

netlify Bot commented Aug 15, 2026

Copy link
Copy Markdown

Deploy Preview for skywalking-website-preview failed.

Name Link
🔨 Latest commit 2eb80a8
🔍 Latest deploy log https://app.netlify.com/projects/skywalking-website-preview/deploys/6a804c7eabc5260008e1ba94

@wu-sheng
wu-sheng merged commit 6c38cb4 into master Aug 15, 2026
1 of 5 checks passed
@wu-sheng
wu-sheng deleted the fix/python-1-3-0-release-metadata branch August 15, 2026 11:25
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