Skip to content

[v26.x backport] doc: promote Alpine Linux to tier 2 support - #66353

Open
MikeMcC399 wants to merge 1 commit into
nodejs:v26.x-stagingfrom
MikeMcC399:backport-63737-to-v26.x
Open

MikeMcC399 wants to merge 1 commit into
nodejs:v26.x-stagingfrom
MikeMcC399:backport-63737-to-v26.x

Conversation

@MikeMcC399

Copy link
Copy Markdown
Contributor

Backports #63737 to v26.x

kernel >= 6.12, musl >= 1.2.5 updated to align with lowest supported version Alpine Linux 3.21
see https://alpinelinux.org/releases/
see https://alpinelinux.org/posts/Alpine-3.21.0-released.html

Alpine 3.22 listed as example version

PR-URL: #63737
Reviewed-By: Matteo Collina matteo.collina@gmail.com
Reviewed-By: Rafael Gonzaga rafael.nunu@hotmail.com
Reviewed-By: Robert Nagy ronagy@icloud.com
Reviewed-By: Chengzhong Wu legendecas@gmail.com
Reviewed-By: Ruy Adorno ruy@vlt.sh
Reviewed-By: Joyee Cheung joyeec9h3@gmail.com
Reviewed-By: Richard Lau richard.lau@ibm.com
Reviewed-By: Ulises Gascón ulisesgascongonzalez@gmail.com
Reviewed-By: James M Snell jasnell@gmail.com
Reviewed-By: Mike McCready 66998419+MikeMcC399@users.noreply.github.com

Background

Ancestors in main branch need to be skipped for backporting to v26.x:

Node.js does not support a platform version if a vendor has expired support for it.
The lowest Alpine Linux version supported is v3.21 according to https://alpinelinux.org/releases/, so
minimum versions are aligned to Alpine v3.21 and are bumped to:

kernel >= 6.12, musl >= 1.2.5

Documentation backport needed as reference for the support description in nodejs/docker-node for Alpine Linux x64 images. Docker documentation needs to move from describing these builds as "Experimental" to categorizing them as falling under "Tier 2" support - see musl builds for Alpine.

kernel >= 6.12, musl >= 1.2.5 updated to align with
lowest supported version Alpine Linux 3.21
see https://alpinelinux.org/releases/
see https://alpinelinux.org/posts/Alpine-3.21.0-released.html

Alpine 3.22 listed as example version

Signed-off-by: Stewart X Addison <sxa@ibm.com>
PR-URL: nodejs#63737
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com>
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
Reviewed-By: Ruy Adorno <ruy@vlt.sh>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
Reviewed-By: Richard Lau <richard.lau@ibm.com>
Reviewed-By: Ulises Gascón <ulisesgascongonzalez@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Mike McCready <66998419+MikeMcC399@users.noreply.github.com>
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/build
  • @nodejs/tsc

@nodejs-github-bot nodejs-github-bot added build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation. v26.x Issues that can be reproduced on v26.x or PRs targeting the v26.x-staging branch. labels Sep 27, 2026
@MikeMcC399 MikeMcC399 added the semver-minor PRs that contain new features and should be released in the next minor version. label Sep 27, 2026
@MikeMcC399
MikeMcC399 requested a review from sxa September 27, 2026 16:47
@MikeMcC399
MikeMcC399 marked this pull request as ready for review September 27, 2026 16:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build Issues and PRs related to Node.js builds or CI infrastructure. doc Issues and PRs related to Node.js documentation. semver-minor PRs that contain new features and should be released in the next minor version. v26.x Issues that can be reproduced on v26.x or PRs targeting the v26.x-staging branch.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants