Skip to content

Commit eb435b4

Browse files
committed
docs: add release availability information
1 parent 893a038 commit eb435b4

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ The official Node.js docker image, made with love by the node community.
2727
- [`node:bookworm`](#nodebookworm)
2828
- [`node:trixie`](#nodetrixie)
2929
- [`node:slim`](#nodeslim)
30+
- [Release Availability](#release-availability)
3031
- [License](#license)
3132
- [Supported Docker versions](#supported-docker-versions)
3233
- [Supported Node.js versions](#supported-nodejs-versions)
@@ -227,6 +228,25 @@ in an environment where *only* the Node.js image will be deployed and you have
227228
space constraints, we highly recommend using the default image of this
228229
repository.
229230

231+
## Release Availability
232+
233+
This repo automatically triggers a process to build new `node` images when Node.js releases
234+
become available. The build processes can take several hours to complete.
235+
236+
Images may initially appear on [Docker Hub](https://hub.docker.com/_/node)
237+
with incomplete or missing OS/ARCH listings as the build process first publishes a tag
238+
and then backfills each architecture when ready.
239+
During this time, if you try to pull the image, you may see an error
240+
message "no matching manifest". In this case, check back later.
241+
(See [Docker Library FAQs](https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what)
242+
for a detailed description of the complex build process.)
243+
244+
For Node.js security releases, Debian-based `node` images may be published in advance
245+
of Alpine-based images. To build an Alpine-based `node` image requires
246+
a `musl` build. This may not initially be ready at Node.js release time.
247+
When processing non-security Node.js releases, the build process will wait for
248+
the `musl` build before proceeding with Debian- and Alpine-based images.
249+
230250
## License
231251

232252
[License information](https://github.com/nodejs/node/blob/main/LICENSE) for

0 commit comments

Comments
 (0)