환경 변수 · Nitroship 문서

프로덕션과 프리뷰 값을 분리하고 비밀 값의 배포 시점 적용을 이해합니다.

환경 변수는 앱마다 production과 preview 대상을 나누어 관리합니다. ntro env 명령은 --app <id|slug> 또는 현재 디렉터리의 앱 연결이 필요합니다.

ntro env add API_ENDPOINT preview --app my-app --no-sensitive
ntro env add API_KEY production --app my-app
ntro env ls --app my-app

env add는 값을 터미널에서 입력받습니다. 기본값은 민감한 secret이며, 읽을 수 있는 일반 값에는 --no-sensitive를 지정합니다. 이미 같은 이름·대상이 있으면 오류가 나고 --force를 사용해야 덮어씁니다. 비대화형 입력에서는 production|preview 대상을 명시합니다.

배포는 생성되는 시점의 해당 대상 환경 변수 스냅샷을 사용합니다. 값을 바꾸어도 이미 생성된 배포에는 적용되지 않으므로 새로 배포해야 합니다. 비밀 값은 목록에서 가려지며 env pull이나 env run으로 다시 가져올 수 없습니다.

ntro env pull .env.local --environment preview --app my-app
ntro env run --environment preview --app my-app -- npm run dev
ntro env rm API_KEY production --app my-app

pull은 기본적으로 .env.local에 프리뷰의 읽을 수 있는 값만 쓰고 기존 파일을 덮으려면 --yes가 필요합니다. rm은 대상 생략 시 존재하는 양쪽 대상에서 제거하고 확인을 요청합니다. REST PUT /v1/apps/{appId}/env는 전체 목록 교체이므로 API를 직접 사용할 때는 유지할 항목까지 함께 보내야 합니다.