개발자 도구: API 토큰, REST API, CLI, “이 오류 설명”.
필요한 권한 범위로 API 토큰을 만들고, REST API로 스크립트와 CI에서 애플리케이션을 다루고, rivervo 명령줄을 사용하고, 실패한 배포에 대한 AI 설명을 받는 방법을 안내합니다.
관리 패널에서 애플리케이션으로 하는 모든 작업은 스크립트로도 할 수 있습니다. 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를 참고하세요.