이 문서에서 다루는 내용
설정 항목
- 항목
- GitHub Branch
- 언제 설정하나요?
- 실제 GitHub 브랜치 중 배포 소스를 고를 때
- 예시
- main, production
- 항목
- Root Directory
- 언제 설정하나요?
- 모노레포에서 앱이 하위 폴더에 있을 때
- 예시
- apps/web
- 항목
- Build Command
- 언제 설정하나요?
- 기본 감지 명령을 바꿔야 할 때
- 예시
- pnpm build
- 항목
- Start Command
- 언제 설정하나요?
- 앱 실행 명령을 자동으로 찾을 수 없을 때
- 예시
- node server.js
- 항목
- Healthcheck Path
- 언제 설정하나요?
- 기본 경로 대신 별도 상태 확인 URL을 쓸 때
- 예시
- /health
- 항목
- Auto Deploy
- 언제 설정하나요?
- 연결 브랜치 push마다 자동 배포할 때
- 예시
- 켜기 또는 끄기
| 항목 | 언제 설정하나요? | 예시 |
|---|---|---|
| GitHub Branch | 실제 GitHub 브랜치 중 배포 소스를 고를 때 | main, production |
| Root Directory | 모노레포에서 앱이 하위 폴더에 있을 때 | apps/web |
| Build Command | 기본 감지 명령을 바꿔야 할 때 | pnpm build |
| Start Command | 앱 실행 명령을 자동으로 찾을 수 없을 때 | node server.js |
| Healthcheck Path | 기본 경로 대신 별도 상태 확인 URL을 쓸 때 | /health |
| Auto Deploy | 연결 브랜치 push마다 자동 배포할 때 | 켜기 또는 끄기 |
저장과 현재 배포 적용 상태
- 표시
- 저장 전 변경사항
- 의미
- 화면에서 편집했지만 서버에 저장하지 않은 상태
- 해야 할 일
- 변수 또는 설정 탭에서 저장
- 표시
- 배포 적용 대기
- 의미
- 저장됐지만 현재 운영 중인 ACTIVE 배포와 다른 상태
- 해야 할 일
- 배포 준비하기로 이동한 뒤 새 배포 시작
- 표시
- 현재 서비스에 적용
- 의미
- 새 배포가 성공해 ACTIVE가 된 설정
- 해야 할 일
- 공개 URL에서 실제 동작 확인
| 표시 | 의미 | 해야 할 일 |
|---|---|---|
| 저장 전 변경사항 | 화면에서 편집했지만 서버에 저장하지 않은 상태 | 변수 또는 설정 탭에서 저장 |
| 배포 적용 대기 | 저장됐지만 현재 운영 중인 ACTIVE 배포와 다른 상태 | 배포 준비하기로 이동한 뒤 새 배포 시작 |
| 현재 서비스에 적용 | 새 배포가 성공해 ACTIVE가 된 설정 | 공개 URL에서 실제 동작 확인 |
성공한 새 배포가 기준입니다
배포 요청을 만들거나 실패한 것만으로는 적용 완료가 되지 않습니다. 새 배포가 ACTIVE가 되어야 환경변수와 빌드·실행 설정이 현재 서비스에 적용된 것으로 표시됩니다.
변수나 설정 탭의 배포 준비하기는 배포 탭으로 이동하는 버튼입니다. 배포 탭에서 기본 확인을 마친 뒤 변경 N개 적용을 눌러야 실제 새 배포가 생성됩니다.
입력 규칙
- Root Directory는 저장소 안의 상대 경로만 사용합니다. 절대 경로나 상위 폴더 이동은 허용되지 않습니다.
- Build Command와 Start Command는 한 줄 명령으로 입력합니다.
- Healthcheck Path는 /로 시작해야 합니다. 앱이 인증 없이 빠르게 응답할 수 있는 경로를 권장합니다.
- Root Directory, Build Command, Start Command, Healthcheck Path를 저장한 뒤 새 배포가 성공해야 실행 중인 서비스에 반영됩니다.
- Auto Deploy 설정은 저장 즉시 이후 GitHub push부터 적용되며 별도 재배포가 필요하지 않습니다.
서비스 리소스
서비스 CPU와 메모리는 플랜의 전체 리소스 안에서 배분됩니다. 현재 고객 화면에서 리소스를 직접 변경하는 기능은 제공하지 않으며, 앱 특성에 맞는 조정이 필요하면 지원 채널로 문의하세요.
플랜과 리소스 한도 보기