.env

.env 파일은 빌드/개발 시간 환경 변수를 지정한다.

이 파일을 .gitignore 파일에 추가해야 비밀 정보가 저장소에 푸시되는 것을 방지할 수 있다.

 

개발, 빌드 및 생성 시간

Nuxt CLI에는 개발 모드와 nuxi build 및 nuxi generate 실행 시 dotenv 지원이 내장되어 있다.

 

프로세스 환경 변수 외에도 프로젝트 루트 디렉터리에 .env 파일이 있으면 개발, 빌드 및 생성 시 자동으로 로드된다. 여기에 설정된 모든 환경 변수는 nuxt.config 파일 및 모듈 내에서 액세스할 수 있다.

 

.env

MY_ENV_VARIABLE=hello

.env 에서 변수를 제거하거나 .env  파일을 완전히 제거해도 이미 설정된 값은 해제되지 않는다.

 

사용자 정의 파일

다른 파일을 사용하려는 경우(예: .env.local 또는 .env.production 사용)  nuxi 사용 시 --dotenv 플래그를 전달한다.

 

터미널

npx nuxi dev --dotenv .env.local

개발 모드에서 .env  업데이트 시, Nuxt 인스턴스는 자동으로 다시 시작되어 process.env 에 새 값을 적용한다.

 

프러덕션 미리보기

서버가 구축된 후에는 서버를 실행할 때 환경 변수를 설정해야 합니다.
이 시점에서는 .env 파일을 읽을 수 없다. 이를 수행하는 방법은 환경마다 다르다.

로컬 프로덕션 미리보기 목적으로 이 명령을 사용하면 편의를 위해 .env 파일이 process.env 에 로드되므로 nuxi 미리보기를 사용하는 것이 좋다. 이 명령을 사용하려면 패키지 디렉터리에 종속성을 설치해야한다.

또는 터미널을 사용하여 환경 변수를 인수로 전달할 수도 있다. 예를 들어 Linux 또는 macOS에서는 다음과 같다.

 

터미널

DATABASE_HOST=mydatabaseconnectionstring node .output/server/index.mjs

 

순수 정적 사이트의 경우 프로젝트가 사전 렌더링된 후에는 런타임 구성을 설정할 수 없다.

참고) Docs > Guide > Going Further > Runtime Config

 

빌드 시 설정된 환경 변수를 사용하고 싶지만 나중에 이를 업데이트하는 데 신경 쓰지 않는 경우(또는 앱 내에서 반응적으로만 업데이트하면 되는 경우) appConfig가 더 나은 선택일 수 있다. nuxt.config(환경 변수 사용) 및 프로젝트의 ~/app.config.ts 파일 내에서 appConfig를 정의할 수 있다.

참고) Docs > Guide > Directory Structure > App Config