This guide covers packaging host setup, release commands, runtime configuration, and RPM use. The release contract defines the authoritative build and publication rules.
Run the pipeline on a CentOS Stream 10 x86_64 host. Install Node.js 26 or later and npm 12 or later.
Install Docker, GnuPG, RPM build tools, createrepo_c, and Google Chrome.
The pipeline packages the official Node.js Linux x64 binary archive. It does not compile Node.js from source. The packaging host needs network access to Node.js, npm, CentOS, and the configured repository application.
Run npm test for Jest tests, lint, format, dependency, and Eliware convention checks.
Run npm test -- tests/conductor.test.mjs to run one focused test file.
Run npm test -- tests/conductor.test.mjs tests/prepare-release.test.mjs to run multiple test files.
Run npm run lint, npm run format:check, or npm run audit to run one validation stage.
Run npm run format to format maintained files.
Run npm ci from the repository root. Configure the signing key and repository access before a wet run.
Keep the private key, webhook URL, and registry credentials outside Git.
Set these environment variables when their defaults do not match the host:
| Variable | Default | Requirement and use |
|---|---|---|
NODEJS_REPOSITORY_URL |
https://nodejs.eliware.org |
Optional. Use the HTTPS root of the repository application. |
NODEJS_REPOSITORY_ROOT |
/eliware/nodejs-repository |
Optional. Set the local repository data path. |
NODEJS_SIGNING_KEY |
None | Required for publication. Set the 40-character signing key fingerprint. |
NODEJS_GNUPGHOME |
/var/lib/eliware/nodejs-signing/gnupg |
Optional. Set the GnuPG home that contains the private signing key. |
NODEJS_SOURCE_DIR |
.state/sources in this checkout |
Optional. Set the verified source archive cache path. |
NODEJS_CONDUCTOR_STATE_ROOT |
/var/lib/eliware/nodejs-packaging/conductor |
Optional. Set the conductor lock and state path. |
CHROME_BIN |
/usr/bin/google-chrome |
Optional. Set the Chrome executable used to create release cards. |
CONDUCTOR_DISCORD_WEBHOOK |
None | Required for wet conductor runs when DISCORD_WEBHOOK is unset. |
DISCORD_WEBHOOK |
None | Required for wet conductor runs when CONDUCTOR_DISCORD_WEBHOOK is unset. |
NODEJS_REPOSITORY_GIT_REMOTE |
origin |
Optional. Set the Git remote for the repository data push. |
NODEJS_REPOSITORY_GIT_BRANCH |
main |
Optional. Set the target branch for the repository data push. |
NODEJS_REPOSITORY_GIT_USER_NAME |
Eliware |
Optional. Set the commit author name for repository data. |
NODEJS_REPOSITORY_GIT_USER_EMAIL |
[email protected] |
Optional. Set the commit author email for repository data. |
NODEJS_CONDUCTOR_LOG_DIR |
Set by the conductor | Internal. Names the directory for command logs. |
NODEJS_CONDUCTOR_RUN_ID |
Set by the conductor | Internal. Identifies the active run and its published logs. |
NODEJS_CONDUCTOR_SERVICE |
Unset | Internal. The bin/conductor-service.mjs launcher sets this value to true. |
The systemd unit sets repository, signing, state, and Chrome values in its unit file.
The unit reads webhook values from /etc/eliware/nodejs-packaging/release.env.
Set NODEJS_SIGNING_KEY and NODEJS_GNUPGHOME when you run repository rollback.
Run one mode at a time from the repository root:
npm run conductor -- --dry-run
npm run conductor -- --wet-runThe dry run checks the newest stable Node.js 26 release, npm latest, and the CentOS Stream 10 base image digest. It reports if a build is needed without publishing artifacts. The wet run requires a Discord webhook and starts release work when an input changed.
The conductor builds an RPM and image when Node.js or npm changes. It reuses the published RPM when only the base image changes. It skips builds when all three inputs match the published release. It sends Discord messages after passed checkpoints and after the release finishes.
The systemd timer starts daily at 13:00 UTC. This is 8:00 AM Eastern Standard Time and 9:00 AM Eastern Daylight Time. The unit runs a dry-run preflight before the wet run.
Install and enable the timer:
sudo cp systemd/nodejs-packaging.service /etc/systemd/system/
sudo cp systemd/nodejs-packaging.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now nodejs-packaging.timerCheck the timer and unit with systemctl list-timers nodejs-packaging.timer and systemctl status nodejs-packaging.service.
Read unit logs with journalctl -u nodejs-packaging.service.
Find the newest stable Node.js 26 release:
npm run release:discoverDownload and verify the Node.js archive and npm package. The prepare command defaults to the newest stable Node.js 26 and npm latest.
npm run release:preparePass --version 26.x.y to select a Node.js release. Pass --npm-version x.y.z to select an npm version.
Pass --allow-older true only when you must prepare an older stable Node.js 26 release. Use both options in this command. Replace the sample version with the older stable release to prepare.
npm run release:prepare -- --version 26.13.1 --allow-older trueBuild an RPM from the verified release input:
npm run release:rpm -- --version 26.x.yPass --release-input PATH to use a release input at a different path. Pass --output PATH to set the RPM output directory.
The default output directory is artifacts/rpms/<version>/.
Create a repository candidate:
npm run release:repository -- --version 26.x.yPass --rpm-dir PATH to select the RPM record directory. Pass --output PATH to select the candidate output path.
The default candidate path is under artifacts/repositories/.
Publish the candidate to the mounted repository:
npm run release:publish -- --version 26.x.y --candidate PATH --repository /eliware/nodejs-repositorySet NODEJS_SIGNING_KEY and, when needed, NODEJS_GNUPGHOME before publication.
The publisher signs the RPM, repository metadata, release manifest, and provenance.
It activates a complete immutable generation after validation.
Commit and push changed repository data with the standalone launcher node bin/commit-publish-repository.mjs.
Configure the signed repository on a CentOS Stream 10 x86_64 host:
sudo rpm --import https://nodejs.eliware.org/keys/RPM-GPG-KEY-ELIWARE-NODEJS
sudo tee /etc/yum.repos.d/eliware-nodejs.repo >/dev/null <<'EOF'
[eliware-nodejs]
name=Eliware Node.js 26
baseurl=https://nodejs.eliware.org/el10/x86_64/stable/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://nodejs.eliware.org/keys/RPM-GPG-KEY-ELIWARE-NODEJS
EOF
sudo dnf install eliware-node26The RPM provides node, npm, and npx. It replaces CentOS AppStream nodejs26 during installation.
The package installs Node.js under /opt/nodejs/26/<version>/ and links /opt/nodejs/26/current to the active version.
Check the installed versions:
node --version
npm --version
npx --versionUpdate the package with sudo dnf upgrade eliware-node26. The RPM owns the bundled npm version.
Keep global npm updates and package data under /var/lib/eliware/nodejs26/global.
It adds that directory's bin folder and npm prefix through /etc/profile.d/eliware-nodejs26.sh.
Run npm -g install npm@latest to update npm without changing RPM-owned files.
Run npm link from a local package repository to add its commands to the global prefix.
Pull latest, a tag that follows the newest published stable Node.js 26 image:
docker pull ghcr.io/eliware/centos10-node26:latest
docker run --rm ghcr.io/eliware/centos10-node26:latest node --versionUse a version tag to select a fixed release, such as ghcr.io/eliware/centos10-node26:26.13.1.
The latest tag follows the newest published stable Node.js 26 image.
Use this image in a Dockerfile with FROM ghcr.io/eliware/centos10-node26:latest.
Set NODEJS_REPOSITORY_URL to the HTTPS root for the Node.js HTTP application.
Build and smoke-check the local image:
NODEJS_REPOSITORY_URL=https://nodejs.eliware.org npm run release:image -- --version 26.x.yAdd --push to publish the versioned image and update the latest tag in GHCR. The build checks
Node.js, npm, and npx before it pushes both tags. Both tags point to the same image digest. Use the
version tag to keep an image version fixed.
The command writes image details to artifacts/images/<version>/image.json.
Publish an image record after the repository has published the matching Node.js release:
npm run release:record-image -- artifacts/images/<version>/image.jsonSet NODEJS_SIGNING_KEY and, when needed, NODEJS_GNUPGHOME before this command.
The image record must include a passed runtime check and a registry digest.
The RPM record is written to artifacts/rpms/<version>/. Repository candidates are written to artifacts/repositories/.
Check network access to nodejs.org, npm, and the repository application when discovery or downloads fail.
Check the configured GnuPG home, private key, and fingerprint when signing fails.
Check Docker access and GHCR login when an image build or push fails.
Check the systemd environment file and webhook value when a wet conductor run fails during preflight.
Keep signing keys, webhook URLs, registry credentials, and runtime state outside Git. Keep published repository files read-only for the Node.js HTTP application.