დეველოპერის ინსტრუმენტები: API ტოკენები, REST API, CLI და «ამ შეცდომის ახსნა».
შექმენით API ტოკენები საჭირო უფლებებით, იმუშავეთ აპლიკაციებთან სკრიპტებიდან და CI-დან REST API-ით, გამოიყენეთ rivervo-ს ბრძანებათა ხაზი და მიიღეთ AI განმარტებები წარუმატებელ განთავსებებზე.
ყველაფერი, რასაც პანელში აპლიკაციებთან აკეთებთ, სკრიპტითაც შეიძლება — განთავსება CI-დან, ცვლადები სკრიპტიდან, ლოგები თქვენს ტერმინალში.
API ტოკენები
ანგარიშის პარამეტრები → API ტოკენები → ტოკენის შექმნა. მიეცით სახელი (სად გამოიყენება, მაგ. «GitHub Actions») და აირჩიეთ, რისი უფლება ექნება:
| უფლებები | რას იძლევა |
|---|---|
| მხოლოდ წაკითხვა | აპლიკაციები, განთავსებები და მათი ლოგები, მუშაობის ლოგები, დომენები |
| წაკითხვა და განთავსება | წაკითხვა, პლუს განთავსება, ვერსიის დაბრუნება და გადატვირთვა |
| სრული წვდომა | განთავსება, პლუს ცვლადები (წაკითხვა და შეცვლა) და დომენები (დამატება, წაშლა) |
| სრული წვდომა და ტერმინალი | სრული წვდომა, პლუს ბრძანებები თქვენს საიტებზე, მათი ფაილები, Cron ამოცანები, 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 | განთავსება: უახლესი commit-ის აწყობა, ან {"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: <the account's customer ID>, რომ იმუშაოთ იმ ანგარიშის აპლიკაციებთან, რომელზეც წვდომა მოგცეს. - ლიმიტები: წუთში 120 მოთხოვნა ერთ ადამიანზე, მათ შორის 30 ცვლილება. ამის ზემოთ API პასუხობს
429-ით დაRetry-After-ით. - ენა: შეტყობინებები ნაგულისხმევად ინგლისურად მოდის; აზერბაიჯანულისთვის ან რუსულისთვის გაგზავნეთ
Accept-Language: azანru. - API-ით შეცვლილი ცვლადები აპლიკაციას მომდევნო განთავსებისას მიაღწევს, ისევე როგორც პანელში —
{"rebuild": false}საკმარისია.
ბრძანებათა ხაზი rivervo
განთავსება, ლოგები, ცვლადები და ვერსიის დაბრუნება თქვენი ტერმინალიდან, იმავე API ტოკენებით. სჭირდება Node.js 22 ან უფრო ახალი:
npm install -g rivervo
rivervo login # paste the token
rivervo deploy shop # build the latest commit and follow the deploy
rivervo logs shop -f # follow the application's output
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # back to the previous versionCI-ში ტოკენს ცვლადიდან RIVERVO_TOKEN კითხულობს, ხოლო deploy შეცდომით სრულდება, თუ ახალი ვერსია ონლაინ ვერ გავიდა, ამიტომ მისით პაიპლაინის შეჩერება შეიძლება. სანამ ის გამოქვეყნდება, იგივეს გაკეთება REST API-ით შეგიძლიათ.
«ამ შეცდომის ახსნა»
როცა განთავსება ვერ სრულდება ან სერვისი მუშაობას წყვეტს, ლოგის გვერდით ჩნდება ღილაკი ამ შეცდომის ახსნა. ის კითხულობს ლოგის ბოლო სტრიქონებს და თქვენს ენაზე გეუბნებათ:
- სავარაუდო მიზეზი — რა მოხდა არასწორად;
- როგორ გამოვასწოროთ — კონკრეტული ნაბიჯები თქვენი სტეკისთვის.
განმარტებას AI წერს ლოგის საფუძველზე; რამის შეცვლამდე გადაამოწმეთ. გაგზავნამდე ლოგში იმალება თქვენი ცვლადების ყველა მნიშვნელობა და ყველაფერი, რაც გასაღებს, პაროლს ან ტოკენს ჰგავს. თავად თქვენი კოდი და ცვლადები არასოდეს იგზავნება.
თითოეულ ადამიანს დღეში მაქსიმუმ 10 ახალი განმარტების მოთხოვნა შეუძლია; იმავე ლოგისთვის უკვე შექმნილი განმარტება ხელახლა უფასოდ ჩანს.
Rivervo MCP
აპლიკაციებთან მუშაობა AI ასისტენტებიდანაც შეგიძლიათ Rivervo MCP-ით — ის მუშაობს Claude-თან, ChatGPT-თან, Cursor-თან, VS Code-თან და სხვა აპლიკაციებთან, რომლებიც MCP-ს უჭერენ მხარს: ჰკითხეთ განთავსებებზე, ლოგებსა და შეცდომებზე საუბრისას და მიანდეთ ასისტენტს განთავსება ან წინა ვერსიაზე დაბრუნება. ტოკენი არ გჭირდებათ; შედიხართ თქვენი Rivervo-ს ანგარიშით. იხილეთ Rivervo MCP.