Kezdés

Fejlesztői eszközök: API-tokenek, REST API, CLI és „Magyarázd el ezt a hibát”.

Hozz létre megfelelő hatókörű API-tokeneket, kezeld az alkalmazásokat szkriptekből és CI-ből a REST API-n és a rivervo parancssoron keresztül, és kérj AI magyarázatot a sikertelen telepítésekhez.

4 PERC OLVASÁS

Mindent, amit az alkalmazásokkal a panelben csinálsz, szkriptből is elvégezhetsz – telepítést CI-ből, változókat szkriptből, naplókat a terminálodban.

API-tokenek

Fiókbeállítások → API-tokenek → Token létrehozása. Adj neki nevet (ahol használod, pl. „GitHub Actions”), és válaszd ki, mire jogosult:

HatókörEngedélyezi
Csak olvasásalkalmazások, telepítések és naplóik, futási naplók, domainek
Olvasás és telepítésolvasás, valamint telepítés, visszaállítás és újraindítás
Teljes hozzáféréstelepítés, valamint változók (olvasás és módosítás) és domainek (hozzáadás, eltávolítás)
Teljes hozzáférés és terminálteljes hozzáférés, valamint parancsok a weboldalaidon, azok fájljai, cron feladatai, SSH-kulcsai és telepítés Gitből

Azt is beállíthatod, mikor járjon le – 30, 90 vagy 365 nap után, vagy soha.

  • A token csak egyszer jelenik meg – azonnal másold ki.
  • A token a te hozzáféréseddel működik. Más fiókjában az alkalmazásban betöltött szerepköröddel működik, és erre jön még rá a token hatóköre. Lásd: Hozzáférés egy alkalmazáshoz.
  • Legfeljebb 20 tokened lehet. A Visszavonás azonnal leállítja a tokent.
  • A tokeneidet csak te hozhatod létre: aki a nevedben jelentkezett be a fiókodba, az nem.

A REST API

Az API dokumentációja OpenAPI 3.1 formátumban érhető el: api.rivervo.com/api/v1/openapi.json. Importáld Postmanbe, Insomniába vagy egy kódgenerátorba.

Alapcím: https://api.rivervo.com/api/v1. A tokent bearer tokenként küldd:

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

Mit tehetsz:

Metódus és útvonalMit csinálHatókör
GET /appsaz alkalmazásaid és szolgáltatásaikolvasás
GET /apps/{id}egy alkalmazásolvasás
GET /apps/{id}/deploymentsa telepítéseiolvasás
POST /apps/{id}/deploymentstelepítés: a legújabb commit buildelése, vagy {"rebuild": false} esetén a futó verzió újratelepítésetelepítés
GET /apps/{id}/deployments/{deployment}egy telepítés a buildnaplójávalolvasás
POST /apps/{id}/deployments/{deployment}/rollbackvisszatérés arra a verzióratelepítés
POST /apps/{id}/restartújraindítástelepítés
GET /apps/{id}/logsaz oldal, egy worker vagy az ütemezés futási naplóiolvasás
GET, PUT, PATCH /apps/{id}/envváltozók olvasása, cseréje vagy frissítéseteljes
GET /apps/{id}/domainsdomainekolvasás
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name}domain hozzáadása vagy eltávolításateljes
  • Más fiókja: add hozzá az X-Account: <the account's customer ID> fejlécet, ha egy olyan fiók alkalmazásaival dolgozol, amelyhez hozzáférést kaptál.
  • Korlátok: személyenként percenként 120 kérés, ebből 30 módosítás. Ezen felül az API 429 kóddal és Retry-After fejléccel válaszol.
  • Nyelv: az üzenetek alapértelmezés szerint angolul érkeznek; azeri vagy orosz nyelvhez küldj Accept-Language: az vagy ru fejlécet.
  • Az API-n keresztül módosított változók – a panelhez hasonlóan – a következő telepítéssel jutnak el az alkalmazáshoz; ehhez elég a {"rebuild": false}.

A rivervo parancssor

Telepítések, naplók, változók és visszaállítások a terminálodból, ugyanazokkal az API-tokenekkel. Node.js 22 vagy újabb kell hozzá:

npm install -g rivervo
rivervo login                       # illeszd be a tokent
rivervo deploy shop                 # a legújabb commit buildelése és a telepítés követése
rivervo logs shop -f                # az alkalmazás kimenetének követése
rivervo env set shop API_URL=https://example.com
rivervo rollback shop               # vissza az előző verzióra

CI-ben a RIVERVO_TOKEN változóból olvassa a tokent, a deploy pedig hibával lép ki, ha az új verzió nem kerül élesbe, így egy pipeline feltételéül szolgálhat. Amíg nincs közzétéve, ugyanez a REST API-val is elvégezhető.

„Magyarázd el ezt a hibát”

Ha egy telepítés nem fejeződik be, vagy egy szolgáltatás leáll, a napló mellett megjelenik a Magyarázd el ezt a hibát. Elolvassa a napló utolsó sorait, és a te nyelveden megmondja:

  • Valószínű ok – mi ment félre;
  • Hogyan javítsd – konkrét lépések a te stackedhez.

A magyarázatot az AI írja a napló alapján; mielőtt bármit módosítanál, ellenőrizd. Küldés előtt a naplóból elrejtjük a változóid minden értékét és mindent, ami kulcsnak, jelszónak vagy tokennek tűnik. Magát a kódodat és a változóidat soha nem küldjük el.

Személyenként naponta legfeljebb 10 új magyarázat kérhető; az ugyanarra a naplóra már elkészült magyarázatot ingyen újra megmutatjuk.

Rivervo MCP

Az alkalmazásaidat AI asszisztensekből is kezelheted a Rivervo MCP segítségével – működik a Claude-dal, a ChatGPT-vel, a Cursorral, a VS Code-dal és más, MCP-t támogató alkalmazásokkal: kérdezz a telepítésekről, naplókról és hibákról beszélgetés közben, és bízd az asszisztensre a telepítést vagy a visszaállítást. Token nem kell; a Rivervo-fiókoddal jelentkezel be. Lásd: Rivervo MCP.

Elakadtál?

Írj nekünk chaten — az AI azonnal válaszol, és ha kell, egy mérnök is bekapcsolódik, a nap bármely szakában.

Ügyfélszolgálat