GitHub에서 첫 애플리케이션 실행하기.
GitHub를 연결하고 저장소를 고른 뒤 리소스와 주소를 선택하면 몇 분 안에 서비스를 시작할 수 있습니다. 첫 애플리케이션에는 3일 무료 체험이 제공됩니다.
애플리케이션은 사이트, API, 백그라운드 작업 등 직접 작성한 코드를 Git 저장소에서 바로 실행합니다. 서버나 호스팅 요금제를 고를 필요가 없습니다. 저장소를 선택하면 빌드와 실행 방법은 저희가 알아내고, 푸시할 때마다 자동으로 배포됩니다.
모든 작업은 새 관리 패널(rivervo.com/panel) → 애플리케이션 → 새 애플리케이션에서 진행합니다.
1. Git 계정 연결
GitHub는 항상 사용할 수 있습니다. GitHub 연결을 누르면 GitHub에서 Rivervo를 설치할 곳(개인 계정 또는 조직)과 읽을 수 있는 저장소를 묻습니다. 저장소에는 아무것도 쓰지 않습니다.
이전에 GitHub에 Rivervo를 설치했다면 GitHub에 이미 설치하셨나요? 연결하기를 누르세요.
GitLab과 Bitbucket은 사용 가능한 경우 저장소 목록 위에 추가 버튼으로 표시됩니다. 연결 방법은 같습니다. Rivervo가 저장소를 읽고 자동 배포용 웹훅을 추가하도록 허용하면 됩니다. 코드는 절대 변경되지 않습니다.
2. 저장소 선택
저장소를 검색하고 배포할 저장소를 누른 다음 선택하세요.
- 브랜치 — 배포할 브랜치. 이 브랜치에 푸시할 때마다 자동으로 배포됩니다.
- 프로젝트 폴더 — 여러 프로젝트가 있는 저장소(모노레포)에만 해당합니다. 예:
apps/web. 프로젝트가 루트에 있으면 비워 두세요.
계속을 누르세요.
아직 저장소가 없나요? 또는 템플릿으로 시작을 누르면 Next.js, Laravel, Express, Flask, 정적 사이트 템플릿 중 하나로 GitHub 계정에 새 저장소를 만듭니다. 코드는 고객님의 것이며, 변경 사항은 푸시로 배포합니다.
3. 자동 감지 항목
저장소를 읽고 빌드와 시작 방법을 알아냅니다. 설정 파일을 따로 작성할 필요가 없습니다. 감지하는 항목은 다음과 같습니다.
| 스택 | 감지 기준 |
|---|---|
| Node.js | Next.js, Nuxt, SvelteKit, Astro, Express, Fastify, Koa, Hono, NestJS, lock 파일로 npm, yarn, pnpm 구분 |
| PHP | Laravel, Symfony, Slim, CodeIgniter 또는 일반 PHP(8.2–8.4) |
| Python | Django, Flask, FastAPI |
| Go | 루트의 go.mod |
| 정적 사이트 | 일반 HTML 또는 프런트엔드 빌드: Vite(React, Vue, Svelte), Create React App, Angular, Gatsby, Docusaurus, VitePress, 정적 Next.js 또는 Nuxt export |
저장소에 자체 Dockerfile이 있으면 그대로 빌드합니다. 목록에 없는 스택을 실행하는 방법이기도 합니다.
감지된 설치, 빌드, 시작 명령은 나중에 설정 → 빌드 설정에서 변경할 수 있습니다. 스택별 안내: Laravel, Node.js, Next.js, Nuxt, Python, 정적 사이트.
4. 리소스와 요금
세 개의 슬라이더로 애플리케이션에 필요한 만큼 선택하세요.
| 리소스 | 요금 | 범위 |
|---|---|---|
| 메모리 | 월 GB당 ₩8,822 | 256MB, 512MB, 이후 1GB 단위로 최대 16GB |
| CPU | 월 코어당 ₩5,882 | 1~8코어 |
| 디스크 | 메모리 1GB당 10GB 포함, 초과분은 월 GB당 ₩221 | 5~500GB, 5GB 단위 |
몇 가지 예시:
| 메모리 | CPU | 디스크 | 월 요금 |
|---|---|---|---|
| 512MB | 1코어 | 5GB | ₩10,293 |
| 1GB | 1코어 | 10GB | ₩14,704 |
| 2GB | 2코어 | 20GB | ₩29,408 |
| 4GB | 2코어 | 60GB | ₩51,465 |
슬라이더를 움직이면 관리 패널에 월 합계가 표시됩니다. 리소스는 나중에 언제든 변경할 수 있으며 애플리케이션 데이터는 유지됩니다. 모든 애플리케이션에는 프로젝트당 월 500GB 트래픽도 포함됩니다. 애플리케이션 요금 청구를 참고하세요.
5. 주소
애플리케이션에 접속하는 방식을 선택하세요. 미리 선택된 항목은 없습니다.
- 공개 주소 — HTTPS가 적용된 무료 주소
https://<name>.rivervo.app로 인터넷에서 접속할 수 있습니다. 실행 후 내 도메인을 연결할 수 있습니다. 내 도메인 연결을 참고하세요. - 내부 전용 — 인터넷 주소가 없으며 애플리케이션의 다른 서비스만 접속할 수 있습니다. 애플리케이션의 다른 서비스가 호출하는 API나 백엔드에 적합합니다. 서비스 간 통신을 참고하세요.
이름(영문 소문자, 숫자, 대시, 3~42자)을 정하면 사용 가능한지 관리 패널에서 바로 알려 드립니다. 나중에 설정 → 공개 주소에서 두 방식을 전환할 수 있습니다.
6. 실행과 무료 체험
실행을 누르고 카드를 등록하세요. 첫 번째 애플리케이션에는 3일 무료 체험이 제공됩니다. 3일 동안은 카드가 결제되지 않으며, 첫 결제는 체험이 끝날 때 이루어집니다. 이후 애플리케이션은 표시된 요금으로 매월 청구됩니다.
무료 체험은 계정당 한 번, 처음 실행하는 애플리케이션에 제공됩니다.
7. 첫 배포
실행 후 관리 패널에 각 단계가 실시간으로 표시됩니다: 코드 가져오기, 보안 검사, 빌드, 시작, 주소 활성화. 보통 몇 분이면 끝납니다. 릴리스마다 숨겨진 악성 코드가 있는지 코드를 검사하며, 악성 코드가 있는 프로젝트는 빌드하거나 실행하지 않습니다.
배포가 끝나면 열기를 눌러 실행 중인 애플리케이션으로 이동할 수 있습니다(공개 주소가 있는 애플리케이션의 경우).
실행이 완료되지 않으면 관리 패널에 해당 단계와 로그가 표시됩니다. 코드나 변수에서 원인을 고친 다음 다시 시도를 누르세요. 추가 요금은 청구되지 않습니다. 이 오류 설명을 누르면 로그에 대한 짧은 설명과 해결 방법을 알려 드립니다(개발자 도구 참고).