시작하기

환경 변수

직접 추가하는 변수와 Rivervo가 자동으로 설정하는 변수, 프로덕션과 미리보기의 차이, 자동 값 대체, 변경 사항이 적용되는 시점을 안내합니다.

2 분 소요

애플리케이션의 키, 비밀번호, 설정은 변수 탭에서 관리합니다. 암호화되어 저장되며, 애플리케이션에는 일반 환경 변수로 전달됩니다.

변수 직접 추가

변수 → 변수 추가에서 이름과 값을 입력하고 저장을 클릭합니다.

  • 이름에는 라틴 문자, 숫자, _를 사용할 수 있으며 숫자로 시작할 수 없습니다. 모든 이름은 고유해야 합니다.
  • 팁: .env 파일의 내용을 이름 입력란에 붙여 넣으면 모든 줄이 한 번에 추가됩니다.

변수는 빌드 단계가 아니라 애플리케이션 실행 시 전달됩니다. 변경 사항은 다음 배포 시 애플리케이션에 반영됩니다. 저장하면 패널에 지금 배포가 표시되며, 새로 빌드하지 않고 실행 중인 버전을 새 변수로 다시 배포합니다.

프로덕션과 미리보기

각 변수에는 환경이 있습니다.

환경적용 대상
프로덕션 및 미리보기실제 서비스 중인 애플리케이션과 모든 브랜치 미리보기(기본값)
프로덕션만실제 서비스 중인 애플리케이션만 — 예: 실제 결제 키
미리보기만브랜치 미리보기만 — 예: 테스트 결제 키

미리보기에는 미리보기용으로 설정된 변수만 전달됩니다. 미리보기에도 자체 변수 탭이 있어 애플리케이션에서 상속된 값을 확인할 수 있으며, 같은 이름으로 직접 값을 지정하면 해당 미리보기에서만 그 값이 대신 사용됩니다.

자동 설정

자동 설정 목록에는 Rivervo가 애플리케이션에 제공하고 최신 상태로 유지하는 변수가 표시됩니다. 직접 추가할 필요가 없습니다.

변수조건
PORT항상 — 애플리케이션이 수신하는 포트
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD프로젝트에 PostgreSQL 또는 MySQL 데이터베이스가 있는 경우
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD데이터베이스가 PostgreSQL인 경우
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT프로젝트에 Valkey가 있는 경우
RIVERVO_<NAME>_URL프로젝트의 모든 데이터베이스, Valkey, 읽기 복제본마다 서비스 이름 기준으로
RIVERVO_<NAME>_URL애플리케이션의 다른 모든 웹 서비스마다 — 내부 주소, 예: RIVERVO_API_URL=http://api:8080 (서비스 간 통신 참고)
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRET프로젝트에 오브젝트 스토리지가 있는 경우
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORELaravel 애플리케이션인 경우(Laravel 참고)

프로젝트의 첫 번째 데이터베이스에는 일반적인 이름(DATABASE_URL, DB_*)이 지정됩니다. 두 번째 데이터베이스는 자체 RIVERVO_<NAME>_URL만 추가하므로 자동으로 전환되지 않습니다. 데이터베이스를 참고하세요.

자동 값 대체

같은 이름으로 직접 추가한 변수가 자동 값을 대신합니다. 패널에는 직접 지정한 값 사용 중으로 표시됩니다. 예를 들어 DATABASE_URL을 프로젝트의 다른 데이터베이스로 지정하는 등 애플리케이션이 다른 곳을 가리키게 할 때 사용합니다.

단, PORT는 예외로 항상 Rivervo가 관리합니다.

프로젝트의 서비스

프로젝트의 모든 서비스(워커, 예약 작업, 다른 웹 서비스)는 데이터베이스를 포함한 프로젝트 변수를 받습니다. 서비스별로 변수를 따로 둘 수도 있으며, 이 값이 프로젝트 변수보다 우선합니다. 웹 서비스는 항상 자체 APP_URL을 받습니다. 모든 코드 서비스는 다른 각 웹 서비스의 내부 주소도 RIVERVO_<NAME>_URL로 받습니다. 웹 서비스를 추가하거나 이름을 바꾼 후에는 다른 서비스를 다시 배포해야 반영됩니다. 프로젝트의 서비스를 참고하세요.

값을 볼 수 있는 사람

값은 계정 소유자와 해당 애플리케이션에서 개발자 또는 관리자 역할을 가진 사람이 볼 수 있습니다. 뷰어 역할은 볼 수 없습니다. 애플리케이션 접근 권한을 참고하세요.

아직 해결되지 않았나요?

채팅으로 문의하세요. 하루 중 언제든 AI 어시스턴트가 바로 답하고, 필요하면 엔지니어가 참여합니다.

지원팀에 문의