Reporch IDE
배포 시작하기
현재 워크스페이스 또는 Git branch·commit을 선택하고 빌드 설정을 검토해 새 배포를 만듭니다.
개요
Reporch IDE의 새 배포 화면에서는 어떤 코드를 배포할지, 어떤 명령으로 빌드할지, 어떤 환경 변수를 전달할지를 한 번에 정합니다. 소스는 현재 워크스페이스 또는 연결된 Git의 branch·commit 중에서 선택할 수 있습니다.
시작하기 전에
- 프로젝트가 워크스페이스 터미널에서 정상적으로 설치·빌드·실행되는지 확인합니다.
- Git 소스를 사용한다면 필요한 변경이 원격 branch 또는 선택할 commit에 반영됐는지 확인합니다.
- 프로젝트가 요구하는 환경 변수를 워크스페이스 설정에 등록합니다.
- 배포 결과가 정적 사이트인지, 장시간 실행되는 웹 애플리케이션인지 구분합니다.
실행 단계
1. 배포 화면 열기
현재 워크스페이스에서 배포를 열고 새 배포를 선택합니다. 활성 워크스페이스가 없으면 소스와 프로젝트 설정을 확정할 수 없습니다.
2. 소스 확인하기
현재 워크스페이스를 선택하면 현재 파일 상태를 기준으로 배포합니다. Git 소스를 선택하면 표시된 저장소, branch와 commit이 의도한 버전인지 확인합니다.
3. 프로젝트 기본값 입력하기
프로젝트 이름과 Application preset을 확인합니다. 모노레포라면 Root Directory를 애플리케이션이 있는 폴더로 바꿉니다. 단일 프로젝트의 기본값은 ./입니다.
4. Build and Output Settings 검토하기
영역을 펼쳐 Build Command, Output Directory, Install Command를 확인합니다. 프리셋이 자동으로 채운 값이 프로젝트의 실제 script와 맞을 때는 불필요하게 덮어쓰지 않습니다.
5. 환경 변수 선택하기
Environment Variables에서 이번 애플리케이션이 사용하는 키만 선택합니다. 각 키의 scope와 target이 배포 목적과 맞는지 확인합니다.
6. 배포 실행하기
Deploy를 한 번 선택합니다. 생성된 배포의 실시간 로그에서 의존성 설치, 빌드와 릴리즈 단계를 순서대로 확인합니다.
7. 결과 검증하기
완료 상태가 되면 제공된 URL을 열어 핵심 경로를 확인합니다. 배포 상세의 Summary, Source, Deployment ID와 로그를 함께 기록하면 문제를 다시 찾기 쉽습니다.
빌드 설정 예시
| 항목 | 의미 | 확인 기준 |
|---|---|---|
| Application preset | 프레임워크별 기본 빌드 규칙 | 실제 프로젝트 프레임워크와 일치 |
| Root Directory | 배포할 앱의 기준 폴더 | 설정 파일과 소스가 있는 폴더 |
| Install Command | 의존성 설치 명령 | lockfile에 맞는 패키지 매니저 사용 |
| Build Command | 프로덕션 산출물 생성 명령 | 로컬/IDE 터미널에서 성공한 명령 |
| Output Directory | 정적 산출물이 생성되는 폴더 | 프레임워크 설정의 실제 출력 경로 |
예상 결과
- 새 배포 기록에 선택한 Source와 고유한 Deployment ID가 표시됩니다.
- 설치와 빌드가 완료되면 배포 URL과 완료 상태가 제공됩니다.
- 제공된 URL에서 핵심 페이지와 서버 동작이 실제로 확인됩니다.
배포 상태 읽기
- 대기/준비 중: 배포 recipe와 실행 환경을 준비하는 단계입니다.
- 빌드 중: 설치와 빌드 명령이 실행 중입니다. 로그의 첫 오류를 기준으로 진단합니다.
- 완료: URL이 생성됐습니다. 완료 상태만 보지 말고 실제 페이지와 API를 확인합니다.
- 실패: 로그의 종료 코드와 첫 번째 실패 명령을 확인합니다.
문제 해결
- 설치 실패: lockfile과 Install Command의 패키지 매니저가 일치하는지 확인합니다.
- 빌드 명령을 찾지 못함: preset,
package.jsonscript와 Root Directory를 확인합니다. - 산출물을 찾지 못함: 실제 빌드 결과 폴더와 Output Directory가 같은지 확인합니다.
- 배포는 성공했지만 앱이 오류를 냄: 누락된 환경 변수와 런타임 로그를 확인합니다.
- 이전 코드가 배포됨: 선택한 branch·commit 또는 현재 워크스페이스의 저장 상태를 다시 확인합니다.