np-dms/lcbp3

Fork 0

Files

T

admin 008f0fd7ab

CI / CD Pipeline / build (push) Successful in 8m9s

Details

CI / CD Pipeline / deploy (push) Successful in 11m32s

Details

260505:1218 chore(node): upgrade to v24.15.0 LTS

- Update Docker base images: node:22-alpine → node:24-alpine
- Add engines.node >=24.0.0 to package.json files
- Create .nvmrc files with 24.15.0
- Update CI workflow to use node-version: 24.15.0
- Fix jest-e2e.json for uuid@13 ES Module compatibility

Validation:
- Backend unit tests: 340/340 passed
- Frontend unit tests: 137/137 passed
- Frontend build: successful (39 static pages)

2026-05-05 12:18:05 +07:00

3.2 KiB

Raw Blame History

Quick Start: Node.js v24.15.0 Upgrade

Prerequisites

Node.js v24.15.0 installed locally (via nvm หรือโหลดจาก nodejs.org)
pnpm 9.x (npm i -g pnpm@9)
Docker Desktop (สำหรับ test container builds)

Local Development Upgrade

1. อัพเดท Node.js เวอร์ชัน

# ใช้ nvm (recommended)
nvm install 24.15.0
nvm use 24.15.0
node --version  # ตรวจสอบ v24.15.0

# หรือดาวน์โหลดจาก nodejs.org โดยตรง
# https://nodejs.org/download/release/v24.15.0/

2. รีเจนเนอเรท lockfile

# Backend
cd backend
rm -rf node_modules pnpm-lock.yaml
pnpm install

# Frontend  
cd frontend
rm -rf node_modules pnpm-lock.yaml
pnpm install

3. รันเทสต์

# Backend
cd backend
pnpm test
pnpm run test:e2e

# Frontend
cd frontend
pnpm test

4. Build Docker Images (Local Test)

# Backend
cd backend
docker build -t nap-dms-backend:v24-test .

# Frontend
cd frontend  
docker build -t nap-dms-frontend:v24-test .

Rollback Procedure

หากพบปัญหาใน production:

# 1. Revert Dockerfile กลับไป node:22.20.0-alpine
git checkout HEAD~1 -- backend/Dockerfile frontend/Dockerfile

# 2. Revert package.json engines field
git checkout HEAD~1 -- backend/package.json frontend/package.json

# 3. Revert .nvmrc
git checkout HEAD~1 -- backend/.nvmrc frontend/.nvmrc

# 4. Rebuild และ redeploy
git commit -m "chore(node): rollback to v22.20.0"

Verification Checklist

ก่อน commit:

node --version แสดง v24.15.0
backend/.nvmrc มีค่า 24.15.0
frontend/.nvmrc มีค่า 24.15.0
backend/package.json engines.node เป็น >=22.0.0 (หรือ 24.15.0)
frontend/package.json engines.node เป็น >=22.0.0 (หรือ 24.15.0)
backend/Dockerfile FROM เป็น node:24.15.0-alpine3.21
frontend/Dockerfile FROM เป็น node:24.15.0-alpine3.21
.gitea/workflows/ci-deploy.yml node-version เป็น 24.15.0
Backend start ได้ไม่มี error (pnpm start:dev)
Frontend build สำเร็จ (pnpm build)
100% tests pass (backend + frontend)
Docker build สำเร็จทั้ง backend และ frontend

Common Issues

Native Module Build Failures

# ถ้า bcrypt/sharp build ไม่ผ่าน
cd backend
pnpm rebuild
# หรือ
npm rebuild bcrypt --build-from-source

pnpm Lockfile Issues

# ถ้ามีปัญหา lockfile
rm -rf node_modules pnpm-lock.yaml
pnpm install

Docker Build Cache

# เคลียร์ cache ถ้า Docker build มีปัญหา
docker build --no-cache -t nap-dms-backend:v24-test .

Next Steps

หาก local test ผ่านหมด:

Commit changes: git commit -m "chore(node): upgrade to v24.15.0"
Push to branch: git push origin 103-node-upgrade
Create PR/MR to main branch
Wait for CI/CD to pass
Deploy to staging for validation
Schedule production deployment

3.2 KiB Raw Blame History