Sign inSign up

umegatw/node

By umegatw

•Updated 25 days ago

Buildkit cache
Image
0

1.3K

umegatw/node repository overview

⁠node

Node 22 / 24 LTS core base — 純 Node runtime + pnpm + fish + tini + non-root(app uid 1000),Debian bookworm-slim base。

⁠用途

給 Node.js SSR / Nuxt / Vite / TypeScript 專案當核心 runtime base。此 image 不含 nginx / chromium,職責純粹只提供 Node 環境。需要 static serve 或 headless browser 的 caller 請用 variant:

  • 靜態檔 serve → umegatw/node-nginx 或 Caddy image
  • Headless browser (Puppeteer / Playwright) → umegatw/node-chrome

⁠Docker Hub

  • Repo: umegatw/node
  • Moving tag: 22-bookworm、24-bookworm(跟著上游 patch)
  • Immutable tag: <node-patch>-bookworm-<sha>(例:22.23.1-bookworm-a1b2c3d、24.18.0-bookworm-a1b2c3d;prod pin 用,<sha> = CI_COMMIT_SHORT_SHA)
  • Rolling tag: latest(alias 到當前 active LTS moving,本 phase = 22-bookworm)

⁠內建

  • Node 22.x / 24.x(依 tag)
  • pnpm(npm install -g)
  • fish shell(minimal alias:ls + cd)
  • tini(PID 1)
  • vim-tiny + openssh-client + git + rsync + ca-certificates + curl

⁠ENV default

只設 HOST=0.0.0.0(讓 Node 從 container 外連得到)。不預設 NODE_OPTIONS / PORT / NITRO_PORT — caller 依 framework + memory limit 自行設定。

⁠本機 build & 驗證

cd images/node
docker compose build
docker run -d --name smoke umega/node:local sleep infinity
sh smoke-test.sh
docker rm -f smoke

Node 24 版本切換:docker compose build --build-arg NODE_VERSION=24。

⁠Rollout SOP(CI)

Core base 與 variants 分開 tag 觸發、獨立 pipeline,不用 needs: 跨 tag 相依。首次或版本升級時,必須依此順序:

  1. Push build-node/YYYY/MM/DD/NNN → 等 CI 綠、Docker Hub 有 umegatw/node:22-bookworm + umegatw/node:24-bookworm
  2. Push build-node-nginx/YYYY/MM/DD/NNN → 綠(FROM umegatw/node:22-bookworm pull registry)
  3. Push build-node-chrome/YYYY/MM/DD/NNN → 綠

若 core base 未先 push,variant build 會在 FROM 階段 registry pull fail。

⁠升級 SOP

  1. docker pull node:22-bookworm-slim(or 24-bookworm-slim)
  2. docker inspect --format='{{.Config.Env}}' node:22-bookworm-slim | grep NODE_VERSION(讀新 patch version)
  3. 更新 .gitlab-ci.yml 全域 vars NODE22_PATCH_VERSION / NODE24_PATCH_VERSION
  4. 本機 docker compose build --build-arg NODE_VERSION=<新 patch> + smoke test(22 + 24 各跑一次;CI 會以 patch 版當 base,smoke-test 驗版本相符)
  5. Push CI trigger tag build-node/YYYY/MM/DD/NNN
  6. Variants 若也要吃新版,各自 push build-node-{nginx,chrome}/...

⁠Downstream 使用範例

⁠Nuxt SSR
FROM umegatw/node:22-bookworm AS build
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build

FROM umegatw/node:22-bookworm AS runtime
WORKDIR /app
COPY --from=build --chown=app:app /app/.output ./.output
ENV NODE_OPTIONS="--max-old-space-size=320"
EXPOSE 3000
CMD ["node", ".output/server/index.mjs"]
⁠Vue SPA(build 用 core base、runtime 用 Caddy)
FROM umegatw/node:22-bookworm AS build
WORKDIR /app
COPY . .
RUN pnpm install --frozen-lockfile && pnpm build

FROM caddy:2-alpine
COPY --from=build /app/dist /srv
COPY Caddyfile /etc/caddy/Caddyfile

Tag summary

Content type

Image

Digest

sha256:20649d0ce…

Size

155.8 MB

Last updated

25 days ago

docker pull umegatw/node