시작하기

개발자 도구: API 토큰, REST API, CLI, “이 오류 설명”.

필요한 권한 범위로 API 토큰을 만들고, REST API로 스크립트와 CI에서 애플리케이션을 다루고, rivervo 명령줄을 사용하고, 실패한 배포에 대한 AI 설명을 받는 방법을 안내합니다.

3 분 소요

관리 패널에서 애플리케이션으로 하는 모든 작업은 스크립트로도 할 수 있습니다. CI에서 배포하고, 스크립트로 변수를 설정하고, 터미널에서 로그를 볼 수 있습니다.

API 토큰

계정 설정 → API 토큰 → 토큰 만들기. 이름(사용처, 예: “GitHub Actions”)을 정하고 허용할 작업을 선택하세요.

범위허용
읽기 전용애플리케이션, 배포와 그 로그, 실행 로그, 도메인
읽기 및 배포읽기와 배포, 롤백, 재시작
전체 접근배포와 변수(읽기 및 변경), 도메인(추가, 삭제)
전체 접근 및 터미널전체 접근과 웹사이트 명령 실행, 파일, 크론 작업, SSH 키, Git 배포

만료 시점도 설정할 수 있습니다. 30일, 90일, 365일 후 또는 만료 없음 중에서 선택하세요.

  • 토큰은 한 번만 표시되니 바로 복사하세요.
  • 토큰은 본인의 권한으로 작동합니다. 다른 사람의 계정에서는 애플리케이션 내 본인의 역할로 작동하며, 그 위에 토큰 범위가 적용됩니다. 애플리케이션 접근 권한을 참고하세요.
  • 토큰은 최대 20개까지 보유할 수 있습니다. 폐기를 누르면 토큰이 즉시 중지됩니다.
  • 토큰은 본인만 만들 수 있습니다. 대신 계정에 로그인한 다른 사람은 만들 수 없습니다.

REST API

API는 OpenAPI 3.1로 문서화되어 있습니다: api.rivervo.com/api/v1/openapi.json. Postman, Insomnia 또는 코드 생성기로 가져오세요.

기본 주소: https://api.rivervo.com/api/v1. 토큰은 bearer 토큰으로 보내세요.

curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/apps

사용할 수 있는 기능:

메서드와 경로기능범위
GET /apps애플리케이션과 서비스 목록읽기
GET /apps/{id}애플리케이션 하나읽기
GET /apps/{id}/deployments배포 목록읽기
POST /apps/{id}/deployments배포: 최신 커밋 빌드, 또는 {"rebuild": false}로 실행 중인 버전 다시 배포배포
GET /apps/{id}/deployments/{deployment}빌드 로그를 포함한 배포읽기
POST /apps/{id}/deployments/{deployment}/rollback해당 버전으로 되돌리기배포
POST /apps/{id}/restart재시작배포
GET /apps/{id}/logs사이트, 워커, 예약 작업의 실행 로그읽기
GET, PUT, PATCH /apps/{id}/env변수 읽기, 교체, 업데이트전체
GET /apps/{id}/domains도메인읽기
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}도메인 추가 또는 삭제전체
  • 다른 사람의 계정: 접근 권한을 받은 계정의 애플리케이션을 다루려면 X-Account: <해당 계정의 고객 ID> 헤더를 추가하세요.
  • 제한: 1인당 분당 120회 요청, 그중 변경은 30회. 초과하면 API가 Retry-After와 함께 429로 응답합니다.
  • 언어: 메시지는 기본적으로 영어로 제공됩니다. 아제르바이잔어나 러시아어로 받으려면 Accept-Language: az 또는 ru를 보내세요.
  • API로 변경한 변수는 관리 패널과 마찬가지로 다음 배포 때 애플리케이션에 적용됩니다. {"rebuild": false}면 충분합니다.

rivervo 명령줄

같은 API 토큰으로 터미널에서 배포, 로그, 변수, 롤백을 다룰 수 있습니다. Node.js 22 이상이 필요합니다.

npm install -g rivervo
rivervo login                       # 토큰 붙여넣기
rivervo deploy shop                 # 최신 커밋을 빌드하고 배포 진행 상황 보기
rivervo logs shop -f                # 애플리케이션 출력 실시간 보기
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # 이전 버전으로 되돌리기

CI에서는 RIVERVO_TOKEN 변수에서 토큰을 읽으며, 새 버전이 배포되지 않으면 deploy가 오류로 종료되므로 파이프라인 관문으로 쓸 수 있습니다. 게시되기 전까지는 REST API로 같은 작업을 할 수 있습니다.

“이 오류 설명”

배포가 완료되지 않거나 서비스가 작동을 멈추면 로그 옆에 이 오류 설명이 표시됩니다. 로그의 마지막 줄을 읽고 사용자의 언어로 알려 드립니다.

  • 예상 원인 — 무엇이 잘못되었는지
  • 해결 방법 — 사용 중인 스택에 맞는 구체적인 단계

설명은 로그를 바탕으로 AI 기능이 작성하므로, 무언가를 변경하기 전에 확인하세요. 전송 전에 모든 변수 값과 키, 비밀번호, 토큰처럼 보이는 내용은 로그에서 가려집니다. 코드와 변수 자체는 절대 전송되지 않습니다.

1인당 하루 최대 10회 새 설명을 요청할 수 있으며, 같은 로그에 이미 만든 설명은 무료로 다시 표시됩니다.

Rivervo MCP

Rivervo MCP를 통해 AI 어시스턴트에서도 애플리케이션을 다룰 수 있습니다. Claude, ChatGPT, Cursor, VS Code 등 MCP를 지원하는 앱에서 작동합니다. 대화로 배포, 로그, 오류를 물어보고 어시스턴트에게 배포나 롤백을 맡기세요. 토큰은 필요 없으며 Rivervo 계정으로 로그인합니다. Rivervo MCP를 참고하세요.

아직 해결되지 않았나요?

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

지원팀에 문의