Skip to content

docs(release): note the .NET 8 runtime requirement for ppc64le and s390x - #281

Merged
cbartz merged 1 commit into
mainfrom
docs/dotnet-runtime-requirement
Nov 13, 2026
Merged

cbartz merged 1 commit into
mainfrom
docs/dotnet-runtime-requirement

Conversation

@cbartz

@cbartz cbartz commented Nov 13, 2026

Copy link
Copy Markdown
Collaborator

The ppc64le and s390x packages need a system .NET 8 runtime, but nothing tells users. Without it the runner never connects. It loops on You must install .NET to run this application, which is how we hit it when testing GARM with these tarballs (cloudbase/garm#949).

The patches build those two arches with <SelfContained>false</SelfContained>; the other packages bundle .NET. Our runner images already install dotnet-runtime-8.0 for them, but anyone using the tarballs directly has to find that out the hard way.

This prepends a short note with the install commands to every release body:

  • The text lives in .github/release-note-canonical.md. releaseNote.md and README.md are upstream's and patch_update_main.yml copies upstream over them (cp -r upstream-runner/* .), which skips .github/.
  • release.yml reads that file before upstream's notes, so <RUNNER_VERSION> and the other placeholders still get substituted.

Checked by rendering the Create ReleaseNote script locally: the note comes first with the version filled in, followed by the upstream notes unchanged.

AI-generated message.

The ppc64le and s390x packages are built framework-dependent and need a
system .NET 8 runtime, unlike the other packages. Release notes come from
upstream's releaseNote.md, which the patch sync overwrites and which does not
mention these architectures, so prepend a fork-owned note kept under .github/.
Copilot AI lite review requested due to automatic review settings November 13, 2026 07:23

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues are identified, and the changes provide the intended runtime guidance while preserving the upstream release-note content and substitutions.

No open issues 🎉

What changed in this PR

Updates release-note generation to inform ppc64le and s390x runner users that a system .NET 8 runtime is required while preserving upstream release notes and placeholder substitution.

Changes:

  • Adds installation guidance for the .NET 8 runtime on Ubuntu 24.04 and 26.04.
  • Prepends the canonical fork-specific note to upstream release notes.
  • Keeps fork-specific documentation separate from upstream-managed files.
File Description
.github/​workflows/​release.yml Prepends the canonical fork-specific release note while preserving upstream notes and placeholder substitution.
.github/​release-note-canonical.md Documents the .NET 8 runtime requirement and installation commands for ppc64le and s390x packages.

Review effort: Lite

@cbartz
cbartz enabled auto-merge (squash) November 13, 2026 07:29
@cbartz
cbartz disabled auto-merge November 13, 2026 08:21
@cbartz

cbartz commented Nov 13, 2026

Copy link
Copy Markdown
Collaborator Author

doc change only - will force merge (CI failure is independent and should be fixed in a separate PR)

@cbartz
cbartz merged commit 8346eb6 into main Nov 13, 2026
3 of 10 checks passed
@cbartz
cbartz deleted the docs/dotnet-runtime-requirement branch November 13, 2026 08:22
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.

3 participants