Docker에서 NextJS 환경변수

JuHee Kim·2026년 2월 10일
  1. GitHub Actions의 front-deploy.yml에서 Docker 빌드 전에 pnpm turbo run build를 실행합니다 (라인 128~163)
    2. 이 빌드 시점에 .env.production 파일이 읽히면서 NEXTPUBLIC* 변수가 빌드 타임에 코드에 인라인됩니다
    3. Docker deploy 타겟은 이미 빌드된 결과물만 복사합니다 (Dockerfile 라인 93~127)

  즉, 흐름이 이렇습니다:

  .env.production (PostHog 키 포함, 이미 커밋됨)

pnpm turbo run build (빌드 타임에 NEXTPUBLIC* 인라인)

Docker deploy 타겟 (빌드된 파일만 복사, 런타임 env 불필요)

  Reddit/Medium 글에서 말하는 문제는 런타임에 NEXTPUBLIC 변수를 주입하려 할 때 발생하는 건데, 이 프로젝트는 빌드
타임에 .env.production에서 인라인하는 방식이라 해당되지 않습니다.

  .env.production에 PostHog 키가 이미 들어있으므로, 그대로 배포하면 됩니다.

참고:

profile
Frontend developer, interested in Data.

0개의 댓글