generated from ttipo/project-base
ttipo
238d0ba838
웹메일 1단계를 개발 환경에서 띄우고 운영에 올리기 위한 인프라 구성이다. - 메일 엔진 Stalwart(v0.16.27)와 개발용 Mailpit 을 compose profile `mail` 로 추가한다. 초기 설정은 mail/scripts/setup.mjs 가 맡는다 — 여러 번 실행해도 안전하고, 운영에서는 사전 검사가 실패하면 아무것도 바꾸지 않고 멈춘다 - 화면과 API 를 한 주소로 배포한다: 프론트 nginx 가 /api 를 백엔드로 넘기고, 본문 한도·시간 제한·헤더 전달을 env 와 맞춘다. nginx 가 직접 내는 오류도 표준 실패 형식이다 - 인터넷을 향한 nginx 는 edge 네트워크로 백엔드에만 닿고, DB·메일 엔진은 app-network 에 둔다 (메일 엔진의 신뢰 대역도 app-network 뿐) - Node 24.22.1·npm 11.6.2·nginx 1.30.6 을 Dockerfile 과 CI 에 한 값으로 고정한다 - 개발 호스트 포트는 127.0.0.1 로 한정하고, data/ 는 클론 때부터 사용자 소유가 되게 .gitkeep 을 추적한다 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
54 lines
2.1 KiB
Docker
54 lines
2.1 KiB
Docker
# lock(package-lock.json)을 쓰고 검사하는 npm 은 한 버전으로 고정한다.
|
|
# npm 은 버전마다 lock 의 중첩 항목(chokidar·readdirp·@emnapi 등)을 다르게 정리해서, 섞어 쓰면 lock 이 매번 바뀐다.
|
|
# 바꿀 때는 frontend/Dockerfile · .github/workflows/ci.yml 의 NPM_VERSION · docker 스킬 문서를 함께 고친다.
|
|
ARG NPM_VERSION=11.6.2
|
|
|
|
# 런타임은 Node 24 LTS — 패치까지 고정한다 (메이저 태그는 빌드할 때마다 그날의 최신 패치를 받는다).
|
|
# 갱신 규칙(일반 패치는 배포 2주 뒤, 보안 릴리스는 CI 통과 즉시)과 함께 고치는 곳은 docker 스킬 문서 "Node 버전" 참조.
|
|
ARG NODE_VERSION=24.22.1
|
|
|
|
FROM node:${NODE_VERSION}-alpine3.24 AS builder
|
|
ARG NPM_VERSION
|
|
WORKDIR /app
|
|
|
|
# 전역 설치는 root 권한이 필요하므로 USER 전환 전에 수행
|
|
RUN npm install -g npm@${NPM_VERSION}
|
|
|
|
# 개발 환경(docker-compose.dev.yml)은 이 스테이지를 그대로 구동하므로 비-root 로 전환한다.
|
|
# /app 소유권을 넘겨야 익명 볼륨(node_modules)도 node 소유로 생성되어 캐시 쓰기가 가능하다.
|
|
RUN chown node:node /app
|
|
USER node
|
|
|
|
# 재현 가능한 빌드를 위해 npm ci 사용 (lockfile 기반)
|
|
COPY --chown=node:node package*.json ./
|
|
RUN npm ci
|
|
|
|
COPY --chown=node:node . .
|
|
RUN npm run build
|
|
|
|
FROM node:${NODE_VERSION}-alpine3.24 AS production
|
|
ARG NPM_VERSION
|
|
WORKDIR /app
|
|
|
|
ENV NODE_ENV=production
|
|
|
|
# 운영 stage 도 동일 npm 버전 사용
|
|
RUN npm install -g npm@${NPM_VERSION}
|
|
|
|
# 운영용 의존성만 설치
|
|
COPY package*.json ./
|
|
RUN npm ci --omit=dev && npm cache clean --force
|
|
|
|
COPY --from=builder /app/dist ./dist
|
|
|
|
# 업로드 저장 위치(compose 의 UPLOAD_DIR=/app/uploads) — node 소유로 만들어 둔다.
|
|
# 운영 compose 는 여기에 named volume 을 붙이는데, 새 볼륨은 이 디렉터리의 소유자를 물려받아 node 가 쓸 수 있다.
|
|
# (호스트 디렉터리를 바인드 마운트하면 sudo docker compose 가 root 소유로 만들어 업로드가 실패한다)
|
|
RUN mkdir -p /app/uploads && chown node:node /app/uploads
|
|
|
|
EXPOSE 3000
|
|
|
|
# 비-root 실행 (보안 규칙)
|
|
USER node
|
|
|
|
CMD ["node", "dist/main"] |