환경변수

서비스 설정값과 비밀값을 안전하게 저장하고 다음 배포에 적용합니다.

이 문서에서 다루는 내용

저장과 적용

환경변수는 서비스별 production 설정으로 저장됩니다. 목록을 저장한 뒤 새 배포를 시작하면 그 배포가 저장 시점의 값을 사용합니다. 새 배포가 ACTIVE가 되면 현재 서비스에 적용된 상태로 표시됩니다.

저장 후 재배포가 필요합니다

환경변수를 저장해도 이미 실행 중인 배포는 바뀌지 않습니다. 변경된 값을 적용하려면 해당 서비스를 다시 배포해 성공 상태를 확인하세요. 실패한 배포는 적용 완료로 보지 않습니다.

현재 서비스 환경변수는 앱을 빌드할 때와 실행할 때 모두 사용될 수 있습니다. 비밀값을 Build Command에서 출력하지 말고, 브라우저에 공개되는 프레임워크 접두사를 비밀값에 사용하지 마세요.

규칙	현재 제한
키 형식	영문 또는 언더스코어로 시작하고 영문, 숫자, 언더스코어만 사용
키 길이	최대 128자
값 길이	변수 하나당 최대 4KB
개수	서비스당 최대 100개
중복	같은 서비스에서 같은 키를 중복 저장할 수 없음

Node.js · javascript

const apiToken = process.env.API_TOKEN;

if (!apiToken) {
  throw new Error("API_TOKEN이 설정되지 않았습니다.");
}

관리형 PostgreSQL은 서비스 연결 상태에 따라 DATABASE_URL 계열 변수를 추가합니다. 내부 서비스 연결은 SOMSATANG_PRIVATE_별칭_URL변수를 추가합니다. 두 기능 모두 연결을 저장한 뒤 서비스 재배포가 필요합니다.

자세한 규칙은 관리형 PostgreSQL과 내부 연결 문서에서 확인하세요.

이 문서에서