Skip to content

Latest commit

 

History

143 Commits

Folders and files

Repository files navigation

CI/CD

Description

Minimal Node Docker image. It's use is intended for kool.dev, but can fit in any other Node use-case.

Available Tags

22

24

24-nginx

26

Legacy tags

The following images have been discontinued, but still exist on Hub Docker in case you need them. We strongly advise moving to the newer versions.

Environment Variables

Variable Default Value Description
ASUSER 0 Changes the user id that executes the commands
UID 0 Changes the user id that executes the commands (ignored if ASUSER is provided)

Usage

With docker run:

docker run -it --rm kooldev/node:22 node -v

With environment variables:

docker run -it --rm -e ASUSER=500 kooldev/node:22 node -v

With docker-compose.yml:

app:
  image: kooldev/node:22
  environment:
    ASUSER: "${$UID}"

Contributing

Package manager defaults

pnpm's per-user ~/.config/pnpm/config.yaml sets storeDir to ~/.pnpm-store and packageImportMethod to copy. npm no longer receives pnpm-only or removed scripts-prepend-node-path options in .npmrc. With current pnpm, hoisting policy belongs in the project's pnpm-workspace.yaml; set shamefullyHoist: true there if required.

Run docker run --rm -v "$PWD:/app" fireworkweb/fwd:v1.0 fwd template, git diff --exit-code, and bash tests/architecture.sh to check generated contexts and download selection with the real template engine. After building an image, run sh tests/image.sh IMAGE to exercise dockerize, npm, yarn, pnpm, config resolution and ownership as root and two remapped user IDs.

Shared native publication

CI uses shared Bash/jq actions, pinned in the workflow. Native amd64/arm64 jobs build/test once. Node 24 NGINX inherits this job's tested Node parent, verified by ID and layer ancestry. The old per-run local Buildx cache export is replaced by the common Docker driver so derived images resolve fresh local parents consistently.

Only trusted master releases stage tested IDs under run/attempt-scoped tags. One publisher validates all four stable tags × both architectures before stable updates. Historical -x86_64/-aarch64 tags remain compatibility aliases, but are updated only after the full native matrix succeeds. PRs/forks/feature branches cannot log in or publish. Release runs serialize; only PR runs are canceled. On failure, rerun all jobs: no previous-attempt metadata is reused and there is no resume workflow. Stable updates are not atomic across tags.

Updating images and building locally

You must have kool installed.

This repo leverages a simple templating tool based on Laravel Blade to generate the actual building contexts for each image flavour.

You should change fwd-template.json and template folder.

After your changes, just run kool run template to compile the template and generate all version folder/files.

License

The MIT License (MIT). Please see License File for more information.

Used by

Contributors

Languages