Proqramçı alətləri: API tokenləri, REST API, CLI və «Xətanı izah et».
Lazımi icazələrlə API tokenləri yaradın, REST API vasitəsilə skriptlərdən və CI-dan tətbiqlərlə işləyin; tezliklə təqdim olunacaq rivervo komanda sətri və uğursuz yerləşdirmələrin süni intellektlə izahı.
Paneldə tətbiqlərlə etdiyiniz bütün əməliyyatları skriptlə də yerinə yetirmək olar — CI-dan yerləşdirmə, skriptdən dəyişənlər, terminalda jurnal.
API tokenləri
Hesab parametrləri → API tokenləri → Token yarat. Tokenə ad verin (harada istifadə olunduğunu, məsələn, «GitHub Actions») və onun nə edə biləcəyini seçin:
| İcazə | Nəyə imkan verir |
|---|---|
| Yalnız baxış | tətbiqlər, yerləşdirmələr və onların jurnalı, işləmə jurnalı, domenlər |
| Baxış və yerləşdirmə | baxış, həmçinin yerləşdirmə, geri qaytarma və yenidən başlatma |
| Tam giriş | yerləşdirmə, həmçinin dəyişənlər (baxış və dəyişdirmə) və domenlər (əlavə etmə, silmə) |
Tokenin müddətini də təyin edə bilərsiniz — 30, 90 və ya 365 gündən sonra və ya müddətsiz.
- Token bir dəfə göstərilir — onu dərhal kopyalayın.
- Token Sizin icazələrinizlə işləyir. Başqasının hesabında o, Sizin tətbiqdəki rolunuzla işləyir, üstəlik tokenin öz icazə səviyyəsi də tətbiq olunur. Ətraflı: Tətbiqə giriş.
- Eyni anda 20 tokenədək saxlaya bilərsiniz. Ləğv et tokeni dərhal dayandırır.
- Tokenləri hər şəxs özü yaradır.
REST API
API OpenAPI 3.1 formatında sənədləşdirilib: api.rivervo.com/api/v1/openapi.json. Onu Postman, Insomnia və ya kod generatoruna idxal edin.
Əsas ünvan: https://api.rivervo.com/api/v1. Tokeni bearer token kimi göndərin:
curl -H "Authorization: Bearer $RIVERVO_TOKEN" https://api.rivervo.com/api/v1/appsİmkanlar:
| Metod və yol | Nə edir | İcazə |
|---|---|---|
GET /apps | tətbiqləriniz və onların servisləri | baxış |
GET /apps/{id} | bir tətbiq | baxış |
GET /apps/{id}/deployments | onun yerləşdirmələri | baxış |
POST /apps/{id}/deployments | yerləşdirmə: son commit-i yığmaq və ya {"rebuild": false} ilə işləyən versiyanı yenidən yerləşdirmək | yerləşdirmə |
GET /apps/{id}/deployments/{deployment} | yığım jurnalı ilə birlikdə yerləşdirmə | baxış |
POST /apps/{id}/deployments/{deployment}/rollback | həmin versiyaya qayıtmaq | yerləşdirmə |
POST /apps/{id}/restart | yenidən başlatmaq | yerləşdirmə |
GET /apps/{id}/logs | saytın, fon prosesinin və ya cədvəlin işləmə jurnalı | baxış |
GET, PUT, PATCH /apps/{id}/env | dəyişənlərə baxmaq, onları əvəz etmək və ya yeniləmək | tam |
GET /apps/{id}/domains | domenlər | baxış |
POST /apps/{id}/domains, DELETE /apps/{id}/domains/{name} | domen əlavə etmək və ya silmək | tam |
- Başqasının hesabı: Sizə giriş verilmiş hesabın tətbiqləri ilə işləmək üçün
X-Account: <the account's customer ID>başlığını (hesabın müştəri ID-si) əlavə edin. - Limitlər: hər şəxs üçün dəqiqədə 120 sorğu, onlardan 30-u dəyişiklik. Limit aşıldıqda API
Retry-Afterilə429cavabını qaytarır. - Dil: mesajlar standart olaraq ingilis dilindədir; Azərbaycan və ya rus dili üçün
Accept-Language: azvə yarugöndərin. - API ilə dəyişdirilmiş dəyişənlər, paneldə olduğu kimi, tətbiqə növbəti yerləşdirmədə çatır — bunun üçün
{"rebuild": false}kifayətdir.
rivervo komanda sətri — tezliklə
Yerləşdirmə, jurnal, dəyişənlər və geri qaytarma üçün komanda sətri aləti hazırlanır. O, eyni API tokenlərindən istifadə edəcək:
rivervo login # tokeni yapışdırın
rivervo deploy shop # son commit-i yığın və yerləşdirməni izləyin
rivervo logs shop -f # tətbiqin çıxışını izləyin
rivervo env set shop API_URL=https://example.com
rivervo rollback shop # əvvəlki versiyaya qayıdınCI-da alət tokeni RIVERVO_TOKEN dəyişənindən oxuyur, yeni versiya yayıma çıxmadıqda isə deploy xəta ilə başa çatır, ona görə ondan pipeline-ı dayandırmaq üçün istifadə etmək olar. Alət dərc olunanadək eyni əməliyyatları REST API ilə yerinə yetirə bilərsiniz.
«Xətanı izah et»
Yerləşdirmə başa çatmadıqda və ya servis işləməyi dayandırdıqda jurnalın yanında Xətanı izah et düyməsi görünür. O, jurnalın son sətirlərini oxuyur və Sizin dilinizdə izah edir:
- Ehtimal olunan səbəb — nə baş verib;
- Necə düzəltmək olar — texnologiyanıza uyğun konkret addımlar.
İzah jurnal əsasında süni intellekt tərəfindən yazılır; dəyişiklik etməzdən əvvəl onu yoxlayın. Göndərişdən əvvəl dəyişənlərinizin bütün dəyərləri, həmçinin açar, şifrə və ya tokenə bənzəyən bütün məlumatlar jurnalda gizlədilir. Kodunuz və dəyişənlərinizin özü heç vaxt göndərilmir.
Hər şəxs gündə 10-a qədər yeni izah ala bilər; eyni jurnal üçün artıq hazırlanmış izah yenidən ödənişsiz göstərilir.