Yerləşdirmələr, önizləmələr və geri qaytarma.

Tətbiq yayıma çıxdıqdan sonra dəyişiklikləri dərc etmək üçün panelə nadir hallarda ehtiyac olur: branch-a push edirsiniz və yeni versiya avtomatik yayıma çıxır. Bu məqalədə bununla bağlı bütün imkanlar izah olunur — Yerləşdirmələr bölməsi, Önizləmələr, Proseslər bölməsi və Parametrlərdəki bir neçə ayar.

Hər push-da avtomatik yerləşdirmə

Tətbiqin branch-ına edilən hər push son commit-i yığır və yerləşdirir. Yeni versiya işləyən versiyanın yanında işə düşür və ziyarətçiləri yalnız cavab verməyə başladıqdan sonra qəbul edir; işə düşməzsə, əvvəlki versiya işləməyə davam edir, biz isə Sizə e-poçtla (Telegram qoşulubsa, oradan da) xəbər veririk.

Başqa yığım hələ növbədə gözləyərkən edilən push həmin yığıma qoşulur, ona görə ardıcıl push-lar uzun növbə yaratmır.

Bu funksiyanı Parametrlər → Hər push-u yerləşdir ayarı ilə söndürə bilərsiniz. Söndürüldükdə yerləşdirməni paneldən, API ilə və ya yerləşdirmə linki ilə başladırsınız.

Paneldən yerləşdirmə

Yerləşdirmələr bölməsində bütün yerləşdirmələr göstərilir: onu nəyin başlatdığı (push, panel, geri qaytarma, yerləşdirmə linki), commit, müddət və status. Yığımın tam jurnalını görmək üçün yerləşdirməni seçin.

Yenidən yerləşdir iki seçim təklif edir:

• Son commit-i yığ — branch-dakı ən yeni kodu götürür və yığır.
• İşləyən versiyanı yenidən yerləşdir — dəyişdirilmiş dəyişənləri yeni yığım olmadan tətbiq edir. Dəyişənlər bölməsində dəyişiklik etdikdən sonra bu seçimdən istifadə edin.

Aç düyməsinin yanındakı menyuda həmin iki əməliyyat, həmçinin Yenidən başlat var.

Geri qaytarma

Son 5 uğurlu versiyadan istənilən birinə qayıda bilərsiniz. Yerləşdirmələr bölməsində lazım olan versiyada Geri qaytar düyməsini basın və təsdiqləyin. Əvvəlki versiya cari versiyanın yanında işə düşür və cavab verməyə başladıqdan sonra onu əvəz edir — yeni yığım aparılmır.

Geri qaytarma verilənlər bazasındakı dəyişiklikləri ləğv etmir. Buraxılış verilənlər bazasının strukturunu dəyişibsə, bazanı da bərpa edin — ətraflı: Verilənlər bazaları.

Branch önizləmələri

Hər hansı digər branch-a edilən push öz önizləməsini alır — dəyişiklikləri yayımdan əvvəl yoxlaya biləcəyiniz ayrıca ünvan. Önizləmələri Önizləmələr bölməsində açın.

• Eyni anda 3 önizləməyədək, qiymətə daxildir.
• 7 gün ərzində yeni push olmayan önizləmə silinir. Həmin branch-a növbəti push-dan sonra yenidən yaradılır.
• Önizləmələr yalnız onlar üçün nəzərdə tutulmuş dəyişənləri alır — ətraflı: Mühit dəyişənləri.
• Önizləmələr layihənin əsas servisi üçün yaradılır, digər servisləri üçün yaradılmır.

Önizləmələr üçün şifrə

Önizləmələr bölməsində Önizləmələr üçün şifrə → Şifrə tələb et. İstifadəçi adını və şifrəni (ən azı 8 simvol) daxil edin. Bundan sonra önizləmələri yalnız şifrəni bilənlər aça bilər; tətbiqin özü hamı üçün açıq qalır.

Buraxılış əmri (miqrasiyalar)

Proseslər bölməsi → Buraxılış əmri. Bu əmr hər yerləşdirmədə, yeni versiya ziyarətçiləri qəbul etməzdən əvvəl bir dəfə icra olunur — adətən verilənlər bazası miqrasiyaları üçün. Əmr uğursuz olarsa, yerləşdirmə dayanır və cari versiya işləməyə davam edir, beləliklə, xətalı miqrasiya ziyarətçilərinizə təsir etmir.

Belə əmri olan freymvorklar üçün əmri özümüz təklif edirik:

Tövsiyə olunan əmrdən istifadə et seçimi bu əmri saxlayır; öz əmrinizi də daxil edə və ya Yoxdur seçə bilərsiniz. Dəyişikliklər növbəti yerləşdirmədən qüvvəyə minir.

Yığım parametrləri

Parametrlər → Yığım parametrləri bölməsində müəyyən etdiyimiz dəyərləri dəyişə bilərsiniz:

• Quraşdırma əmri — məsələn, npm ci
• Yığım əmri — məsələn, npm run build
• İşə salma əmri — tətbiqinizi işə salan əmr. Tətbiq $PORT dəyişənindəki portu dinləməlidir.
• Nəticə qovluğu — statik saytlar üçün yığılmış faylların olduğu qovluq.
• Layihə qovluğu — bir neçə layihədən ibarət repozitoriya üçün.

Müəyyən etdiyimiz dəyərdən istifadə etmək üçün sahəni boş saxlayın. Növbəti yerləşdirmə yeni parametrlərlə yığılır; İndi yığ onu dərhal başladır.

Yerləşdirilən Budaq (branch) da Parametrlər bölməsində təyin olunur.

Yerləşdirmə linkləri

Parametrlər → Yerləşdirmə linkləri → Link yarat. Yerləşdirmə linki şəxsi ünvandır: başqa xidmət ona POST sorğusu göndərdikdə branch-ınızın son commit-i yığılır və yerləşdirilir. Adi istifadə nümunəsi — materialı dərc etdikdən sonra saytı yenidən yığan CMS.

curl -X POST "<paneldəki linkin ünvanı>"

• Ünvan bir dəfə göstərilir — linki yaradarkən onu kopyalayın. Ünvanı bilən hər kəs yerləşdirməni başlada bilər, ona görə onu gizli saxlayın.
• Hər link üçün saatda 10 yerləşdirməyədək. Yığım hələ gözləyərkən gələn sorğu ona qoşulur.
• Ləğv et ünvanı dərhal dayandırır; onu çağıran xidmətlərə bundan sonra yeni ünvan lazım olacaq.

Texniki xidmət rejimi

Parametrlər → Texniki xidmət rejimi → Texniki xidmət səhifəsini göstər. Ziyarətçilər tətbiq əvəzinə mesajınız olan qısa səhifə görür; mesajı boş saxlasanız, «Saytda kiçik təkmilləşdirmələr aparırıq. Bir az sonra yenidən baxın.» mətni göstərilir.

Tətbiqin özü işləməyə davam edir, ona görə yenidən açmazdan əvvəl bütün funksiyaları yoxlaya bilərsiniz. Sizin üçün şəxsi link onu açan cihazda tətbiqi 12 saat ərzində adi qaydada göstərir. Yeni link yeni keçid yaradır; köhnə link işləməyi dayandırır.

Tətbiqi ziyarətçilər üçün yenidən açmaq üçün ayarı söndürün.

Yerləşdirmələr barədə bildirişlər

Yerləşdirmə başa çatmadıqda Sizə e-poçt (Telegram qoşulubsa, Telegram mesajı da) göndəririk. Hadisələri komandanıza da çatdırmaq üçün — yeni versiya yayıma çıxdı, yerləşdirmə başa çatmadı, servis dayandı və ya yenidən işləyir, yaddaş və ya prosessor yüklənməsi yüksəkdir, ehtiyat nüsxə, verilənlər bazasının diski — Parametrlər → Komanda üçün bildirişlər bölməsində Slack, Discord və ya öz webhook-unuzu əlavə edin. Webhook mesajları JSON formatındadır və bir dəfə göstərilən gizli açarla imzalanır; imza X-Rivervo-Signature başlığında ötürülür.