feat: Node.js 27.0.0-alpha.0.0.0 by nschonni · Pull Request #2678 · nodejs/docker-node

nschonni · 2026-10-30T18:59:15Z

Description

Adds the new Node.js 27 Alpha release.

Motivation and Context

Converts the stackbrew as a first step to make the external file calls a bit easier.
Drops local version.json metadata for the source of truths upstream in the nodejs/Release and individual release's index.json metadata.

Testing Details

Example Output(if appropriate)

Types of changes

Documentation
Version change (Update, remove or add more Node.js versions)
Variant change (Update, remove or add more variants, or versions of variants)
Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
Other (none of the above)

Checklist

My code follows the code style of this project.
My change requires a change to the documentation.
I have updated the documentation accordingly.
I have read the CONTRIBUTING.md document.
All new and existing tests passed.

nschonni · 2026-10-30T21:38:21Z

@MikeMcC399 here is what the stackbrew will add for the new alpha release (with the rest of the file unchanged.

Tags: 27.0.0-alpha.0.0.0-alpine3.23
Architectures: amd64, arm64v8
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/alpine3.23

Tags: 27.0.0-alpha.0.0.0-alpine3.24
Architectures: amd64, arm64v8
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/alpine3.24

Tags: 27.0.0-alpha.0.0.0-bookworm
Architectures: amd64, arm64v8, ppc64le
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/bookworm

Tags: 27.0.0-alpha.0.0.0-bookworm-slim
Architectures: amd64, arm64v8, ppc64le
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/bookworm-slim

Tags: 27.0.0-alpha.0.0.0-trixie
Architectures: amd64, arm64v8, ppc64le, s390x
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/trixie

Tags: 27.0.0-alpha.0.0.0-trixie-slim
Architectures: amd64, arm64v8, ppc64le, s390x
GitCommit: 3bd48058ca58ebb613646bd1aa225f44032e47e4
Directory: 27/trixie-slim

Still need to resolve the buildmatrix version comparison issue

nschonni · 2026-10-30T23:04:51Z


 const getFullNodeVersionFromDockerfile = (file) =>
-  fs.readFileSync(file, 'utf8').match(/^ENV NODE_VERSION=(\d*\.*\d*\.\d*)/m)[1];
+  fs.readFileSync(file, 'utf8').match(/^ENV NODE_VERSION=(\S*)/m)[1];


tried to use a real semver regex, but figured out that those are multi-match, and this was "good enough"

nschonni · 2026-10-30T23:09:48Z

+    let tags;
+
+    if (isAlpha) {
+      // Only push explicit variants during the Alpha phase


Made a call not to include any plain 27, 27.0.0, etc tags during the Alpha, and only have specific versions that people are explictly opting into.

nschonni · 2026-10-30T23:11:02Z

+    }
+  },
  "26": {
-    "start": "2026-05-05",


This wasn't used, and was copy/pasted from the nodejs/Release values anyway.
There are sometimes gaps there, but that isn't fixed by have a value here

MikeMcC399 · 2026-10-31T09:27:09Z

@nschonni

I wasn't expecting this to happen so fast, so thanks for putting this together!

I like that there are no floating tags for this Alpha release! As you know this is still very much in general discussion with lots of different opinions! (nodejs/node#67135 & nodejs/Release#1171)

I'm not sure if Alpine Linux 3.23 should be included in 27 Alpha as this will be short-lived. Alpine Linux plans for new releases every May and November, so I'd expect an Alpine Linux 3.25 in the next weeks, which we'd want to transition to and then drop Alpine Linux 3.23.

There should also be some documentation added to the README about Alpha.

I'm also not sure if we should release this one, or just treat it as a dry-run exercise and wait for the next Alpha release. There hasn't been any user specifically asking for an Alpha Docker build so far.

There is no release plan in https://github.com/nodejs/Release/issues for Node.js 27 Alpha, but I'd expect a 2-week cadence like previous current versions have had, which would mean Nov 11, 2026 for the next one. Maybe @sxa from the releasers team can help us understand the plans?

MikeMcC399

I already left some comments about the Alpha release.

I'm wondering if the stackbrew enhancement commit should be extracted into its own PR, since this is a general improvement which helps also for other release lines, not just the 27 Alpha.

MikeMcC399 · 2026-10-31T14:41:36Z

Also I just discovered that there is no published link to the documentation. nodejs/nodejs.org#9254

nschonni · 2026-10-31T15:49:40Z

Yeah, I started this PR as a small stackbrew one, but ended up morphing it into the 27 one, since I needed that part to test out how it would handle the Alpha concept.
Might push a last cleanup for my own comments, but I can also open a separate PR without the bump in parallel

nschonni · 2026-10-31T16:11:43Z

I think this could likely land as-is with the minimal v27.
Maybe the outstanding question, is whether a new minimal alpha tag should be introduced. Don't think a wide array of new alpha-* tags are needed, but if people want to start seeing if the latest in CI, we might need a few.

MikeMcC399

I'm OK for going ahead with releasing Node.js Docker images with pinned tags based on 27.0.0-alpha.0.0.0

Decisions about floating tags still need more discussion.

MikeMcC399 · 2026-11-02T13:03:26Z

+      "alpine3.23": [
+        "amd64",
+        "arm64v8"
+      ],


I think we could drop alpine3.23 for Node.js 27 Alpha since it will get dropped in the next weeks anyway if Alpine Linux releases 3.25 and we move to building only 3.24 / 3.25. alpine3.23 certainly won't make it through to when Node.js 27.0.0 moves to current status in April 2027, so there wouldn't be much value in testing it.

Not a blocker - just a comment.

yeah, all the images/tags will be deleted with each new Alpha release, so it would get deleted pretty shortly anyway

Any published images with their tags would stay on Docker Hub, but there aren't any floating tags right now, so that makes it less of an issue.

nschonni · 2026-11-02T15:25:44Z

@nodejs/docker it would be good to get some more reviews on this one, since it's a larger change to the releases in this repo

nschonni commented Oct 30, 2026

View reviewed changes

Comment thread .github/workflows/official-pr.yml Resolved

nschonni force-pushed the stackbrew-mod branch 2 times, most recently from 3638075 to 5b2f058 Compare October 30, 2026 21:31

nschonni changed the title ~~chore: convert stackbrew to MJS~~ feat: Node.js 27.0.0-alpha.0.0.0 Oct 30, 2026

nschonni mentioned this pull request Oct 30, 2026

Node.js 27: current & latest floating tags nodejs/Release#1171

Closed

nschonni force-pushed the stackbrew-mod branch 2 times, most recently from 4f35f28 to 565be84 Compare October 30, 2026 23:01

nschonni commented Oct 30, 2026

View reviewed changes

nschonni marked this pull request as ready for review October 30, 2026 23:11

nschonni requested a review from a team October 30, 2026 23:11

MikeMcC399 reviewed Oct 31, 2026

View reviewed changes

nschonni added 2 commits October 31, 2026 11:52

chore: convert stackbrew to MJS

5cb0eeb

feat: Node.js 27.0.0-alpha.0.0.0

c4620c7

nschonni force-pushed the stackbrew-mod branch 2 times, most recently from 1b385f3 to da3c47d Compare October 31, 2026 15:56

nschonni mentioned this pull request Oct 31, 2026

build: modify stackbrew and CI to support Alphas #2681

Open

12 tasks

nschonni added 2 commits October 31, 2026 15:44

feat: handle alpha versions with minimal tags

f724207

ci: allow the full Alpha string in the build matrix

a26b642

nschonni force-pushed the stackbrew-mod branch from da3c47d to a26b642 Compare October 31, 2026 19:44

bricss mentioned this pull request Nov 1, 2026

Node 27 builds 📦 nodejs/unofficial-builds#255

Closed

MikeMcC399 requested a review from sxa November 2, 2026 07:37

MikeMcC399 approved these changes Nov 2, 2026

View reviewed changes

MikeMcC399 requested a review from a team November 2, 2026 07:41

MikeMcC399 reviewed Nov 2, 2026

View reviewed changes

Conversation

nschonni commented Oct 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Motivation and Context

Testing Details

Example Output(if appropriate)

Types of changes

Checklist

Uh oh!

Uh oh!

nschonni commented Oct 30, 2026

Uh oh!

nschonni Oct 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

nschonni Oct 30, 2026

Choose a reason for hiding this comment

Uh oh!

nschonni Oct 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 commented Oct 31, 2026

Uh oh!

MikeMcC399 left a comment

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 commented Oct 31, 2026

Uh oh!

nschonni commented Oct 31, 2026

Uh oh!

nschonni commented Oct 31, 2026

Uh oh!

MikeMcC399 left a comment

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 Nov 2, 2026

Choose a reason for hiding this comment

Uh oh!

nschonni Nov 2, 2026

Choose a reason for hiding this comment

Uh oh!

MikeMcC399 Nov 2, 2026

Choose a reason for hiding this comment

Uh oh!

nschonni commented Nov 2, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

nschonni commented Oct 30, 2026 •

edited

Loading

nschonni Oct 30, 2026 •

edited

Loading