nodejs / nodejs/Release

Node.js 27: `current` & `latest` floating tags

Open
#1,171 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
4.4k
Forks
675
Avg merge
22h 29m
Merged PRs (30d)
1

Description

Situation

Node.js images on Docker Hub make use of floating tags:

  • current (including variations like current-bookworm-slim)
  • latest

which are both floated up to the latest node:26.x.x* as each succeeding Node.js 26.x version is released.

According to the phase diagram in the README here in this repo, when Node.js 26.x transitions into its Active LTS phase there is no longer any current version.

Users of the current tag would be stuck at the last non-LTS version of Node.js 26.x and would jump to Node.js 27.x 6 months later when Node.js 27.x exits its Alpha phase.

Suggestion

This was also raised in https://github.com/tj/n/issues/847#issuecomment-4233488364 with the proposal for the n Node.js version manager, defining the tags as follows:

  • current highest non-alpha release
  • latest highest release (may include alpha)

This seems like a good general definition for Docker images and Node.js version managers.

Perhaps there is some way to incorporate this into the phase naming used in this repo?

Users of Docker images and Node.js version managers would benefit if there is consistency in alias names across utilities.

Would that be consistent with the planned usage for https://nodejs.org/dist/latest/ with Node.js 27.x?

There is no alias https://nodejs.org/dist/current/ defined at this time.

An alternate tag naming scheme would be to leave current and latest defined as the highest non-alpha release, and introduce a new tag, for example next, that points to the highest release, which could be an alpha release or it could be a non-alpha release when there is no alpha phase open. In the latter case current, latest and next would point to the same release.

Other

There is a generic issue https://github.com/nodejs/docker-node/issues/2524 open to plan for building Node.js Docker images based Node.js 27 Alpha releases. This is currently in the planning stage, and no changes have been made so far to any processes to deal with the future Node.js 27 release line in that repo.

cc: @shadowspawn @nschonni

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the phase diagram in the repository README, then review the linked n discussion and nodejs/docker-node issue #2524 for related tag and Node.js 27 planning. Determine whether the release-phase naming should define current, latest, or a new alias, and consider consistency with nodejs.org/dist/latest/. Done means an agreed convention for these aliases.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, node.js
Domain
release
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.