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.
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ör | Engedélyezi |
|---|---|
| Csak olvasás | alkalmazások, telepítések és naplóik, futási naplók, domainek |
| Olvasás és telepítés | olvasás, valamint telepítés, visszaállítás és újraindítás |
| Teljes hozzáférés | telepí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ál | teljes 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/appsMit tehetsz:
| Metódus és útvonal | Mit csinál | Hatókör |
|---|---|---|
GET /apps | az alkalmazásaid és szolgáltatásaik | olvasás |
GET /apps/{id} | egy alkalmazás | olvasás |
GET /apps/{id}/deployments | a telepítései | olvasás |
POST /apps/{id}/deployments | telepítés: a legújabb commit buildelése, vagy {"rebuild": false} esetén a futó verzió újratelepítése | telepítés |
GET /apps/{id}/deployments/{deployment} | egy telepítés a buildnaplójával | olvasás |
POST /apps/{id}/deployments/{deployment}/rollback | visszatérés arra a verzióra | telepítés |
POST /apps/{id}/restart | újraindítás | telepítés |
GET /apps/{id}/logs | az oldal, egy worker vagy az ütemezés futási naplói | olvasás |
GET, PUT, PATCH /apps/{id}/env | változók olvasása, cseréje vagy frissítése | teljes |
GET /apps/{id}/domains | domainek | olvasás |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | domain hozzáadása vagy eltávolítása | teljes |
- 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
429kóddal ésRetry-Afterfejléccel válaszol. - Nyelv: az üzenetek alapértelmezés szerint angolul érkeznek; azeri vagy orosz nyelvhez küldj
Accept-Language: azvagyrufejlé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óraCI-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.