검색
← 릴리스 노트

환경 변수에 Config와 Secret 유형 도입

Vercel · 기능추가 · 2026.08.24

환경 변수를 Config 또는 Secret으로 지정하도록 바뀌고, 기존 Sensitive 항목은 Secret으로 자동 전환됩니다.

교안에 영향

예전 글에서 환경 변수의 Sensitive 토글과 `Enforce Sensitive Environment Variables` 정책을 안내했다면 더 이상 맞지 않습니다.

요약

- 환경 변수 추가·수정 시 Sensitive 토글 대신 Config 또는 Secret을 선택합니다. - 기존에 Sensitive로 표시된 환경 변수는 자동으로 Secret으로 취급되어 별도 이전 없이 계속 동작합니다. - 대시보드의 환경 변수 목록에서 각 변수의 유형과 적용 범위를 확인할 수 있습니다. - 팀 정책 Enforce Sensitive Environment Variables는 중단되고, Separate Production Secret Values 정책이 새로 추가되었습니다. - `vercel env add`와 `vercel env update`에서 `--visibility config` 또는 `--visibility secret`으로 유형을 지정할 수 있습니다.

바뀐 것

새 기능 5

  • 환경 변수 추가·수정 시 `Config` 또는 `Secret` 유형을 선택할 수 있습니다.
  • `Config` 값은 저장 후에도 권한이 있는 구성원이 읽을 수 있습니다.
  • `Secret` 값은 배포에는 제공되지만 저장 후에는 구성원이 보거나 가져올 수 없습니다.
  • 보안 설정에 `Separate Production Secret Values` 정책이 새로 추가되었습니다.
  • CLI에서 `vercel env add`와 `vercel env update`에 `--visibility config` 또는 `--visibility secret`을 사용할 수 있습니다.

개선 4

  • 각 환경 변수에 대해 환경 또는 Preview 브랜치를 선택할 수 있습니다.
  • 대시보드의 환경 변수 목록에서 각 변수의 유형과 적용 범위를 보여줍니다.
  • 기존 플래그는 그대로 사용할 수 있으며, `--visibility`를 생략하면 `--no-sensitive`는 `Config`, `--sensitive`는 `Secret`으로 매핑됩니다.
  • 환경 변수를 추가하거나 수정한 뒤 CLI 출력에서 `Visibility` 아래에 유형이 표시됩니다.

기타 3

  • 기존에 `Sensitive`로 표시된 환경 변수는 자동으로 `Secret`으로 처리되어 별도 이전이 필요 없습니다.
  • 기존 정책이 켜져 있던 팀은 새 정책 사용 여부를 확인해야 합니다.
  • 중단된 정책은 더 이상 Vercel CLI에서 강제되지 않습니다.

지원 종료 1

  • 팀 정책 `Enforce Sensitive Environment Variables`가 중단되었습니다.

원문 제목 · Environment variables now use Config and Secret types