배포, 미리보기, 롤백.
푸시가 배포되는 방식, 브랜치 미리보기, 이전 버전으로 되돌리기, 마이그레이션용 릴리스 명령, 빌드 설정, 배포 훅, 점검 모드, 미리보기 비밀번호를 안내합니다.
애플리케이션이 실행된 뒤에는 변경 사항을 배포하려고 관리 패널을 열 일이 거의 없습니다. 브랜치에 푸시하면 새 버전이 자동으로 배포됩니다. 이 문서에서는 그와 관련된 모든 것, 즉 배포 탭, 미리보기, 프로세스 탭과 설정의 몇 가지 스위치를 다룹니다.
푸시할 때마다 자동 배포
애플리케이션 브랜치에 푸시할 때마다 최신 커밋을 빌드해 배포합니다. 새 버전은 실행 중인 버전 옆에서 시작되고 응답하기 시작한 뒤에만 방문자를 받습니다. 시작되지 않으면 이전 버전이 계속 실행되며 이메일(Telegram을 연결했다면 Telegram)로 알려 드립니다.
다른 빌드가 아직 대기열에 있는 동안 푸시하면 그 빌드에 합쳐지므로, 푸시를 연달아 해도 대기열이 길어지지 않습니다.
설정 → 푸시마다 배포에서 이 기능을 끌 수 있습니다. 끄면 관리 패널, API 또는 배포 훅으로 배포합니다.
관리 패널에서 배포
배포 탭에는 모든 배포가 표시됩니다. 배포를 시작한 원인(푸시, 관리 패널, 롤백, 배포 훅), 커밋, 소요 시간, 상태를 볼 수 있습니다. 배포를 누르면 전체 빌드 로그가 표시됩니다.
재배포에는 두 가지 선택지가 있습니다.
- 최신 커밋 빌드 — 브랜치의 최신 코드를 가져와 빌드합니다.
- 실행 중인 버전 다시 배포 — 새로 빌드하지 않고 변경된 변수를 적용합니다. 변수를 수정한 뒤에 사용하세요.
열기 옆 메뉴에도 같은 두 가지 동작과 재시작이 있습니다.
롤백
최근 성공한 5개 버전 중 하나로 되돌릴 수 있습니다. 배포 탭에서 원하는 버전의 롤백을 누르고 확인하세요. 이전 버전이 현재 버전 옆에서 시작되어 응답하면 전환되며, 새로 빌드하지 않습니다.
롤백해도 데이터베이스 변경은 되돌려지지 않습니다. 릴리스에서 데이터베이스 구조를 변경했다면 데이터베이스도 복원하세요. 데이터베이스를 참고하세요.
브랜치 미리보기
다른 브랜치에 푸시하면 자체 미리보기가 만들어집니다. 변경 사항을 배포하기 전에 확인할 수 있는 별도 주소입니다. 미리보기 탭에서 여세요.
- 동시에 최대 3개의 미리보기가 요금에 포함되어 있습니다.
- 7일 동안 새 푸시가 없는 미리보기는 삭제됩니다. 해당 브랜치에 다시 푸시하면 새로 만들어집니다.
- 미리보기는 미리보기용 변수만 받습니다. 환경 변수를 참고하세요.
- 미리보기는 프로젝트의 메인 서비스에만 만들어지며, 다른 서비스에는 만들어지지 않습니다.
미리보기 비밀번호
미리보기 탭에서 미리보기 비밀번호 → 비밀번호 요구. 사용자 이름과 비밀번호(8자 이상)를 입력하세요. 그 뒤로는 비밀번호를 아는 사람만 미리보기를 열 수 있으며, 애플리케이션 자체는 누구나 이용할 수 있습니다.
릴리스 명령 (마이그레이션)
프로세스 탭 → 릴리스 명령. 배포할 때마다 새 버전이 방문자를 받기 전에 한 번 실행되며, 보통 데이터베이스 마이그레이션에 사용합니다. 실패하면 배포가 중단되고 현재 버전이 계속 실행되므로, 잘못된 마이그레이션이 방문자에게 영향을 주는 일은 없습니다.
릴리스 명령이 있는 프레임워크에는 명령을 추천해 드립니다.
| 프레임워크 | 추천 릴리스 명령 |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
추천 명령 사용을 선택하면 그대로 유지되며, 직접 명령을 입력하거나 없음을 선택할 수도 있습니다. 변경 사항은 다음 배포부터 적용됩니다.
빌드 설정
설정 → 빌드 설정에서 자동 감지된 항목을 변경할 수 있습니다.
- 설치 명령 — 예:
npm ci - 빌드 명령 — 예:
npm run build - 시작 명령 — 애플리케이션을 시작하는 명령.
$PORT의 포트에서 수신해야 합니다. - 출력 폴더 — 정적 사이트의 경우 빌드된 파일이 있는 폴더.
- 프로젝트 폴더 — 여러 프로젝트가 있는 저장소용.
필드를 비워 두면 자동 감지된 값을 사용합니다. 다음 배포는 새 설정으로 빌드되며, 지금 빌드를 누르면 바로 시작합니다.
설정에서는 배포할 브랜치도 지정합니다.
배포 훅
설정 → 배포 훅 → 훅 만들기. 배포 훅은 비공개 주소입니다. 다른 서비스가 이 주소로 POST 요청을 보내면 브랜치의 최신 커밋을 빌드해 배포합니다. 게시 후 사이트를 다시 빌드하는 CMS가 대표적인 사용 예입니다.
curl -X POST "<관리 패널의 훅 주소>"- 주소는 한 번만 표시되니 훅을 만들 때 복사하세요. 주소를 가진 사람은 누구나 배포를 시작할 수 있으므로 비공개로 보관하세요.
- 훅당 시간당 최대 10회 배포. 빌드가 대기 중일 때 들어온 호출은 그 빌드에 합쳐집니다.
- 폐기를 누르면 주소가 즉시 중지되며, 이 주소를 호출하던 서비스에는 새 주소가 필요합니다.
점검 모드
설정 → 점검 모드 → 점검 페이지 표시. 방문자에게는 애플리케이션 대신 메시지가 담긴 짧은 페이지가 표시됩니다. 메시지를 비워 두면 “서비스 개선 작업을 진행하고 있습니다. 잠시 후 다시 방문해 주세요.”가 표시됩니다.
애플리케이션 자체는 계속 실행되므로 다시 공개하기 전에 모든 것을 확인할 수 있습니다. 나만 쓰는 비공개 링크를 열면 해당 기기에서 12시간 동안 애플리케이션이 평소처럼 표시됩니다. 새 링크를 누르면 새 링크가 만들어지고 이전 링크는 더 이상 작동하지 않습니다.
스위치를 끄면 애플리케이션이 다시 방문자에게 공개됩니다.
배포 알림
배포가 완료되지 않으면 이메일(Telegram을 연결했다면 Telegram 메시지)로 알려 드립니다. 새 버전 배포, 배포 미완료, 서비스 중지 또는 복구, 높은 메모리나 프로세서 사용량, 백업, 데이터베이스 디스크 같은 이벤트를 팀에도 보내려면 설정 → 팀 알림에서 Slack, Discord 또는 직접 만든 웹훅을 추가하세요. 웹훅 메시지는 JSON이며, 한 번만 표시되는 시크릿으로 서명되어 X-Rivervo-Signature 헤더에 담깁니다.