CLI

Rerent(https://rerent.ai)는 미사용 GPU 노드 시간을 노드·시간 단위로 사고파는 마켓플레이스예요. 공급자는 빈 GPU 서버를 등록해 시간을 팔고, 구매자는 필요한 시간 창만 사서 그 위에 컨테이너(인스턴스)를 띄우고, 남는 시간은 다시 팔아요. rerent 는 그 REST API(https://rerent.ai/docs/api) 전체를 다루는 의존성 없는 단일 파일 CLI(Node 20+)이고, 이 설명서는 CLI 자신이 rerent manual 로 출력해요 — 사이트 문서(/docs/cli)와 npm README 도 같은 명세에서 생성되므로 항상 코드와 같아요.

설치·인증

npm i -g rerent-cli            # 명령 이름은 rerent · 또는 npx rerent-cli …
curl -fsSL https://rerent.ai/cli/rerent.mjs -o /usr/local/bin/rerent && chmod +x /usr/local/bin/rerent   # npm 없이
rerent login --token rlt_…     # 설정 → API 토큰에서 발급 · ~/.rerent/config.json 에 저장 (RERENT_TOKEN / RERENT_URL 환경변수가 우선)
rerent whoami

규약 — 모든 명령에 공통

• --json 을 붙이면 사람용 표 대신 API 응답 JSON 원본을 그대로 출력해요. 스크립트·에이전트는 이걸 쓰세요. 목록은 {object:"list", data:[…], has_more, cursor}, 오류는 종료 코드 1 + stderr 에 <HTTP> <code>: <message>.
• 시각(--start --end --until --from): now · "in 3h"(m/h/d/w) · tomorrow(KST 0시) · ISO(2026-09-15T09:00:00+09:00) · epoch 초. 분 단위로 내림 정렬돼요. 기간(--duration --min-runtime): 30m 1h 12h 3d 2w. --end 가 있으면 --duration 대신 써요.
• 금액은 노드·시간당 원(₩) 정수(30000 · ₩30,000 모두 됨). 노드 = SKU 가 정한 GPU 묶음(예 8× H100). GPU·시간당 값이 필요하면 SKU 의 gpus_per_node 로 나누세요.
• 자원 지정은 ID(ordr_… inst_…)나 이름(풀·템플릿·이미지·배포·워크스페이스·SKU alias) 어느 쪽이든 돼요. 자원 경로 rerent:pool:<조직>:<워크스페이스>:<이름> 도 받아요.
• 목록 필터: --tag k=v[,k2=v2](모두 만족) · --tag-key k · --workspace W · --pool P · --deployment D · --limit N — 명령이 지원하는 것만 적용돼요(각 명령의 사용법 참고).
• 태그는 --tag k=v,k2=v2 로 생성 시 붙이고 set 으로 전부 교체해요(키 ≤128자 · 값 ≤256자 · 쉼표와 = 금지 · 자원당 50개).
• 역할: 토큰의 역할이 곧 권한. admin 전부 · member 매수·인스턴스·조회(매도·토큰·클러스터 불가) · viewer 조회만(변경 명령은 403 read_only).
• 멱등성: orders create 는 자동 Idempotency-Key. 재시도가 안전해요.

흔한 흐름(에이전트용)

1. GPU 시간 사서 SSH 접속: rerent market → rerent availability --sku icn-1-h100 --duration 24h → rerent orders create --side buy --sku icn-1-h100 --start now --duration 12h --nodes 1 --max-rate 30000 --estimate(견적) → 같은 명령에서 --estimate 빼기 → rerent ssh-keys add --name laptop --file ~/.ssh/id_ed25519.pub → rerent instances create --pool default --image pytorch → rerent instances(ssh 명령 확인) 또는 rerent instances ssh <id>.
2. 항상 N대 유지(자동 매수): rerent templates create --name train --image ghcr.io/me/train:latest --mode custom --command "python train.py" → rerent deployments create --pool default --sku icn-1-h100 --target 2 --max-rate 30000 --horizon 6 --template train → rerent deployments get <name> 으로 확보율·오류 확인. 끝낼 땐 deployments set <name> --target 0 또는 rm.
3. 남는 시간 되팔기: rerent pool default(보유 스케줄) → rerent pools sellable default --sku icn-1-h100 → rerent orders create --side sell --pool default --sku icn-1-h100 --start "in 8h" --duration 4h --nodes 1 --min-rate 20000 --allow-standing --allow-partial → rerent realized.
4. 내 GPU 서버 팔기(공급자): rerent clusters create --name lab --sku icn-1-h100 --nodes gpu1.lab.internal,gpu2.lab.internal --until "in 30d" --auto-sell --price 28000 --floor 18000 → 출력된 설치 명령을 각 서버에서 sudo bash → rerent clusters get <id>(온라인 확인) → rerent clusters assignments <id> · rerent credits payout ….
5. 상태 변화 받기: rerent events --type instance.running,order.filled 폴링, 또는 rerent webhooks create --url https://my.app/hook --events instance.running 뒤 서명 검증(https://rerent.ai/docs/events).

CLI 에 없는 조합은 rerent api <METHOD> </v1/…> --data '{…}' 로 어떤 엔드포인트든 그대로 부를 수 있어요. 아래 표의 「API」열이 각 명령이 실제로 부르는 엔드포인트예요.

계정·인증·조직

토큰 하나가 조직 하나를 대표해요. 토큰 역할(admin·member·viewer)이 곧 CLI 의 권한이고, viewer 토큰은 조회(GET) 명령만 돼요.

마켓 조회(공개 · 토큰 없이 가능)

가격은 「노드·시간당 원(₩)」이에요. 시각은 분 단위 epoch 초(60의 배수)로 맞춰져요.

사기·팔기 — 주문

주문은 「SKU × 시간 창 × 노드 수 × 지정가」예요. 매수는 --max-rate(상한), 매도는 --min-rate(하한). 즉시 체결 안 되는 나머지는 기본으로 취소되고, --allow-standing 을 주면 호가에 남아요. --estimate 는 체결 없이 견적만.

• orders create — orders create 는 자동으로 Idempotency-Key 를 붙여서 네트워크 오류 뒤 같은 명령을 다시 실행해도 중복 주문이 나지 않아요(--idempotency-key 로 직접 지정 가능). 매수 주문이 한도를 넘으면 403 limit_exceeded 로 주문 없이 거절돼요.

내 컴퓨트 — 풀

산 시간은 풀에 쌓여요(기본 풀 default). 풀 단위로 인스턴스를 띄우고, 남는 시간은 풀에서 다시 팔아요. 풀 간 전송(transfers)으로 시간을 옮길 수도 있어요.

인스턴스 — 산 시간 위에서 컨테이너 돌리기

인스턴스는 풀에 배정된 노드 위에서 도는 컨테이너예요. 노드가 비어 있으면 1분 안에 시작하고, 배정이 없으면 「대기」로 남아 배정되는 순간 떠요. ssh 모드는 SSH 서버가 든 컨테이너(조직 SSH 키 자동 주입), custom 은 지정한 명령만 실행해요.

• instances create — 우선순위는 같은 풀에 노드가 모자랄 때 누가 먼저 노드를 받는지(4=critical 이 먼저). --allow-cidrs 는 SSH 접속을 허용할 IPv4 대역이고 컨테이너 sshd 규칙으로 실제 적용돼요(노출 포트에는 적용되지 않음).

자동 매수 · 배포(deployments)

배포는 「이 SKU 노드 N대를 항상 유지」하는 자동화예요. spot(기본)은 확보 기간(앞으로 H시간) 안의 빈 구간을 상한가 이하 매물에서 매 분 즉시 사고, 템플릿이 있으면 산 노드에 인스턴스를 목표 수만큼 유지해요. generic 은 매수 없이 이미 산 시간 위에서 인스턴스 수만 맞춰요(템플릿 필수). 풀×SKU 마다 배포는 하나.

• deployments create — --horizon 은 지금부터 몇 시간 앞까지 항상 확보해 둘지(1~168), --min-runtime 은 한 번에 사는 최소 길이(1분짜리 조각 매수 방지 · 시간 단위로 올림 1~24h → 응답 min_runtime_minutes/block_hours). 인스턴스 이름 템플릿은 {{nanoid(n)}} 이 필수.

워크스페이스

조직 안에서 풀·템플릿·이미지를 묶는 단위예요. 목록 명령의 --workspace W 필터가 이걸 써요. 자원 경로 rerent:pool:<조직>:<워크스페이스>:<이름> 을 id 자리에 써도 돼요.

크레딧 — 충전·출금·원장

모든 매수는 선충전 크레딧(₩)에서 나가고, 매도 대금은 수수료를 뺀 순액이 크레딧으로 들어와요. 충전은 요청 뒤 운영자가 입금을 확인하면 반영돼요.

이벤트 · 웹훅

조직에서 일어난 일(체결·인스턴스 상태·배포·노드·충전 등 18종)이 이벤트로 남고, 웹훅으로 내 서버에 POST 돼요(HMAC-SHA256 서명 · 5회 재시도). 폴링 대신 events 를, 실시간이 필요하면 웹훅을 쓰세요.

공급자 — 내 GPU 팔기(클러스터)

공급자는 클러스터(같은 SKU 의 노드 묶음)를 등록하고 각 노드에서 설치 명령 한 줄을 실행하면 끝이에요. 자동 매도(auto_sell)를 켜면 빈 시간을 정한 가격으로 계속 내놓고, 시간이 가까워질수록 하한가까지 내려가요.

그 밖에