시작하기

프로젝트의 서비스: 웹 서비스, 워커, 예약 작업.

프로젝트에 백그라운드 워커, 예약 작업, 추가 웹 서비스, 데이터베이스, Valkey를 추가하세요. 프로젝트 코드, 다른 저장소 또는 준비된 이미지에서 만들 수 있고, 이름으로 서로 연결되며 요금은 한 번에 청구됩니다.

4 분 소요

프로젝트는 프로세스 하나로 끝나지 않습니다. 메인 애플리케이션 옆에서 큐 워커, 야간 작업, 별도 API, 데이터베이스를 각각 자체 리소스를 가진 서비스로 실행할 수 있으며, 요금은 한 번에 청구됩니다.

서비스는 애플리케이션의 개요 → 서비스 → 서비스 추가에 있습니다. 프로젝트당 서비스는 최대 10개입니다. 메인 서비스를 먼저 시작해야 하며 프로젝트 구독이 활성 상태여야 합니다(무료 체험 포함).

서비스 종류

종류설명
웹 서비스또 다른 사이트 또는 API — 공개 주소가 있거나 내부 전용
백그라운드 워커항상 실행: 큐, Horizon, Celery, 컨슈머
예약 작업일정에 따라 시작(cron 형식, UTC)해 작업을 마치고 중지
PostgreSQL, MySQL, Valkey관리형 데이터베이스 — 데이터베이스 참고
NATS, RabbitMQ이벤트와 큐를 위한 메시지 브로커, 내부 전용 — 이벤트와 큐 참고

공개 주소 또는 내부 전용

웹 서비스를 추가할 때 접근 방식을 선택합니다. 미리 선택된 항목은 없습니다.

  • 공개 주소 — 인터넷에서 https://<name>.rivervo.app로 열리며, 자체 도메인을 연결할 수 있습니다.
  • 내부 전용 — 인터넷 주소와 도메인이 없고, 애플리케이션의 다른 서비스만 접근할 수 있습니다. 사이트 뒤의 API, 관리용 백엔드, 검색 엔진에 알맞습니다.

백그라운드 워커, 예약 작업, 데이터베이스는 공개되지 않으므로 선택 항목이 없습니다. 나중에 서비스의 설정 → 공개 주소에서 변경할 수 있습니다. 서비스 간 통신을 참고하세요.

코드 출처

이 프로젝트의 코드

같은 코드를 다른 방식으로 시작합니다. 큐 워커, 스케줄러, WebSocket 서버(예: Laravel Reverb), 모노레포의 폴더, 별도 API 등입니다.

  • 명령은 필수입니다. 서비스가 실행할 명령으로, 예를 들어 php artisan queue:work 또는 node worker.js입니다.
  • 웹 서비스는 $PORT의 포트에서 수신해야 합니다.
  • 예약 작업에는 cron 형식(UTC)의 일정도 필요합니다. 예: */5 * * * *.
  • 메인 서비스의 새 버전은 이 서비스들에도 배포되므로 항상 같은 코드로 실행됩니다.

다른 저장소

연결된 Git 계정의 다른 저장소에서 웹 서비스나 백그라운드 워커를 만듭니다. 브랜치를 따로 지정하고, 필요하면 프로젝트 폴더와 빌드 및 시작 명령도 지정합니다(필드를 비워 두면 자동 감지 값을 사용합니다). 배포와 버전이 따로 관리되며 해당 브랜치에 푸시할 때마다 배포됩니다. 서비스용 브랜치 미리보기는 아직 제공되지 않습니다.

준비된 이미지

Docker Hub, GitHub Container Registry 또는 다른 레지스트리의 준비된 이미지(Docker 이미지)로 웹 서비스나 백그라운드 워커를 만듭니다. 예: nginx:1.27 또는 ghcr.io/org/app:tag.

  • 포트 — 이미지가 수신하는 포트입니다. $PORT로도 전달됩니다.
  • 명령 — 선택 사항입니다. 비워 두면 이미지에 정의된 대로 시작합니다.
  • 비공개 레지스트리 — 사용자 이름과 비밀번호 또는 액세스 토큰입니다. 암호화되어 저장되고 이미지 다운로드에만 사용되며 다시 표시되지 않습니다.
  • 자동 배포가 켜져 있으면 하루에 한 번 태그가 더 새로운 버전을 가리키는지 확인하고 배포합니다. 배포 탭의 이미지 다시 다운로드로 바로 실행할 수도 있습니다.

Kafka(템플릿)

서비스 추가의 Kafka는 원클릭 프리셋입니다. 공식 Apache Kafka 이미지(3.9)로 ZooKeeper 없이 KRaft 모드의 단일 브로커 서비스를 만듭니다. 개발 용도와 중간 정도의 부하에 알맞습니다.

  • 내부 전용 — 공개 주소와 외부 접근이 없으며 애플리케이션의 서비스만 접근할 수 있습니다.
  • 애플리케이션의 다른 코드 서비스는 KAFKA_BROKERS=<service name>:9092와 RIVERVO_<NAME>_URL=<service name>:9092를 받습니다.
  • 토픽은 처음 사용할 때 자동으로 만들어집니다.
  • 메모리 1GB · CPU 코어 1개 · 디스크 10GB로 시작합니다. 준비된 이미지로 만든 다른 서비스처럼 리소스와 변수를 변경할 수 있습니다.
  • 데이터는 서비스 디스크의 데이터 폴더에 보관됩니다.

제공되지 않는 것:

  • 브로커 1개 — 복제가 없으며 모든 토픽의 복제 계수는 1입니다.
  • 관리형 Kafka 백업 없음. 매일 백업은 Kafka가 실행되는 동안 데이터 폴더를 파일로 복사합니다. 일관된 Kafka 백업이 아니므로, 복원 후 최근 메시지가 없거나 Kafka가 시작할 때 로그를 복구해야 할 수 있습니다.
  • 유지 관리 시간, 외부 접근, Kafka UI가 없습니다.
  • Kafka 업그레이드는 직접 해야 합니다. 서비스의 설정에서 이미지를 변경하세요.

백업과 연결 변수가 자동으로 설정되는 큐와 이벤트가 필요하면 이벤트와 큐의 NATS와 RabbitMQ를 참고하세요.

이름으로 서로 연결

프로젝트의 서비스는 비공개 네트워크에서 이름으로 통신합니다. api라는 서비스는 다른 서비스에서 api로, db라는 데이터베이스는 db로, 메인 서비스는 web으로 접근할 수 있습니다. 프로젝트 서비스 간 트래픽은 트래픽으로 계산되지 않습니다.

모든 웹 서비스에는 http://api:8080과 같은 내부 주소가 표시되고, 다른 서비스는 이 주소를 RIVERVO_API_URL 변수로 받습니다. 작동 방식, 내부 전용 서비스, 인스턴스 여러 개, 타임아웃은 서비스 간 통신을 참고하세요.

모든 서비스는 데이터베이스 연결을 포함한 프로젝트 변수와 함께 자체 변수도 받으며, 자체 변수가 프로젝트 변수보다 우선합니다. 환경 변수를 참고하세요.

리소스와 요금

서비스마다 메모리, CPU, 디스크가 따로 있으며 요금은 다른 애플리케이션과 같습니다. 월 기준 메모리 GB당 ₩8,810, **CPU 코어당 ₩5,873**이며, 메모리 1GB당 디스크 10GB가 포함되고 초과분은 **GB당 ₩220**입니다. 서비스의 메모리는 최대 8GB입니다.

서비스를 추가하면 요금이 프로젝트 청구액에 더해지며, 이번 달은 남은 기간만큼만 청구됩니다. 프로젝트가 무료 체험 중이면 새 서비스는 체험이 끝날 때까지 무료입니다.

개요에는 프로젝트의 모든 서비스를 합한 월 요금이 프로젝트 합계로 표시됩니다.

애플리케이션 안의 워커

항상 별도 서비스가 필요한 것은 아닙니다. 메인 애플리케이션의 프로세스 탭에는 다음이 있습니다.

  • 백그라운드 워커 — 사이트 옆에서 오래 실행되는 프로세스를 최대 5개까지 둘 수 있습니다(예: 큐 워커). 애플리케이션의 리소스를 함께 사용하며 배포할 때마다 재시작합니다.
  • 예약 명령 — 일정에 따라 실행되는 명령을 최대 10개까지 둘 수 있습니다(cron 형식, UTC). 출력은 로그의 스케줄에 있습니다.
  • 콘솔 — 실행 중인 애플리케이션 안에서 변수와 데이터베이스를 그대로 사용해 일회성 명령을 실행합니다. 명령은 최대 15분 동안 실행할 수 있으며, 대화형 명령(tinker, 셸)은 여기서 지원되지 않습니다.

워커에 자체 리소스가 필요할 때는 별도 서비스가 더 낫습니다. 큐 작업이 많아도 사이트가 느려지지 않습니다.

서비스 변경

서비스 목록에서 서비스를 엽니다. 설정에서 명령, 일정, 이미지 또는 브랜치, 리소스를 관리하며, 변경 사항을 저장하면 서비스가 그 설정으로 재시작합니다. 서비스마다 로그와 모니터링도 따로 있습니다.

아직 해결되지 않았나요?

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

지원팀에 문의