დაწყება

დეველოპერის ინსტრუმენტები: API ტოკენები, REST API, CLI და «ამ შეცდომის ახსნა».

შექმენით API ტოკენები საჭირო უფლებებით, იმუშავეთ აპლიკაციებთან სკრიპტებიდან და CI-დან REST API-ით, გამოიყენეთ rivervo-ს ბრძანებათა ხაზი და მიიღეთ AI განმარტებები წარუმატებელ განთავსებებზე.

3 წთ კითხვა

ყველაფერი, რასაც პანელში აპლიკაციებთან აკეთებთ, სკრიპტითაც შეიძლება — განთავსება 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 version

CI-ში ტოკენს ცვლადიდან RIVERVO_TOKEN კითხულობს, ხოლო deploy შეცდომით სრულდება, თუ ახალი ვერსია ონლაინ ვერ გავიდა, ამიტომ მისით პაიპლაინის შეჩერება შეიძლება. სანამ ის გამოქვეყნდება, იგივეს გაკეთება REST API-ით შეგიძლიათ.

«ამ შეცდომის ახსნა»

როცა განთავსება ვერ სრულდება ან სერვისი მუშაობას წყვეტს, ლოგის გვერდით ჩნდება ღილაკი ამ შეცდომის ახსნა. ის კითხულობს ლოგის ბოლო სტრიქონებს და თქვენს ენაზე გეუბნებათ:

  • სავარაუდო მიზეზი — რა მოხდა არასწორად;
  • როგორ გამოვასწოროთ — კონკრეტული ნაბიჯები თქვენი სტეკისთვის.

განმარტებას AI წერს ლოგის საფუძველზე; რამის შეცვლამდე გადაამოწმეთ. გაგზავნამდე ლოგში იმალება თქვენი ცვლადების ყველა მნიშვნელობა და ყველაფერი, რაც გასაღებს, პაროლს ან ტოკენს ჰგავს. თავად თქვენი კოდი და ცვლადები არასოდეს იგზავნება.

თითოეულ ადამიანს დღეში მაქსიმუმ 10 ახალი განმარტების მოთხოვნა შეუძლია; იმავე ლოგისთვის უკვე შექმნილი განმარტება ხელახლა უფასოდ ჩანს.

Rivervo MCP

აპლიკაციებთან მუშაობა AI ასისტენტებიდანაც შეგიძლიათ Rivervo MCP-ით — ის მუშაობს Claude-თან, ChatGPT-თან, Cursor-თან, VS Code-თან და სხვა აპლიკაციებთან, რომლებიც MCP-ს უჭერენ მხარს: ჰკითხეთ განთავსებებზე, ლოგებსა და შეცდომებზე საუბრისას და მიანდეთ ასისტენტს განთავსება ან წინა ვერსიაზე დაბრუნება. ტოკენი არ გჭირდებათ; შედიხართ თქვენი Rivervo-ს ანგარიშით. იხილეთ Rivervo MCP.

ჯერ კიდევ გაქვთ კითხვები?

მოგვწერეთ ჩატში — AI მაშინვე გპასუხობთ, საჭიროებისას კი ინჟინერი უერთდება, დღე-ღამის ნებისმიერ დროს.

მხარდაჭერასთან დაკავშირება