Telepítések, előnézetek és visszaállítások.
Hogyan kerülnek élesbe a pushok, ágelőnézetek, visszatérés egy korábbi verzióra, a release parancs a migrációkhoz, buildbeállítások, telepítési hookok, karbantartási mód és jelszó az előnézetekhez.
Ha az alkalmazás már él, a változások kiadásához ritkán kell a panel: pusholj az ágra, és az új verzió magától élesbe kerül. Ez a cikk mindent bemutat, ami ehhez kapcsolódik – a Telepítések fület, az Előnézeteket, a Folyamatok fület és néhány kapcsolót a Beállítások között.
Automatikus telepítés minden pushnál
Az alkalmazás ágára érkező minden push után buildeljük és telepítjük a legújabb commitot. Az új verzió a futó mellett indul el, és csak akkor kap látogatókat, ha már válaszol; ha nem indul el, az előző verzió fut tovább, és e-mailben (valamint Telegramon, ha csatlakoztattad) szólunk.
Ha egy push akkor érkezik, amikor egy másik build még a sorban vár, az ahhoz a buildhez csatlakozik, így a gyors egymásutáni pushok nem hoznak létre hosszú sort.
Ezt kikapcsolhatod a Beállítások → Telepítés minden pushnál részen. Kikapcsolt állapotban a panelből, az API-n keresztül vagy telepítési hookkal telepítesz.
Telepítés a panelből
A Telepítések fül minden telepítést felsorol: mi indította (push, a panel, visszaállítás, telepítési hook), a commitot, mennyi ideig tartott, és mi az állapota. Kattints egy telepítésre a teljes buildnapló megtekintéséhez.
Az Újratelepítés két lehetőséget kínál:
- A legújabb commit buildelése – az ág legújabb kódját veszi, és abból buildel.
- A futó verzió újratelepítése – új build nélkül alkalmazza a módosított változókat. A Változók szerkesztése után használd.
A Megnyitás melletti menüben ugyanez a két művelet és az Újraindítás található.
Visszaállítás korábbi verzióra
Az utolsó 5 sikeres verzió bármelyikére visszatérhetsz. A Telepítések fülön kattints a kívánt verziónál a Visszaállítás gombra, és erősítsd meg. A korábbi verzió a jelenlegi mellett indul el, és amint válaszol, átveszi a helyét – új build nincs.
A visszaállítás nem vonja vissza az adatbázis-módosításokat. Ha egy kiadás megváltoztatta az adatbázis szerkezetét, az adatbázist is állítsd vissza – lásd: Adatbázisok.
Előnézetek az ágakhoz
Bármely más ágra érkező push saját előnézetet kap – egy külön címet, ahol élesítés előtt ellenőrizheted a változásokat. Az Előnézetek fülön nyithatod meg őket.
- Egyszerre legfeljebb 3 előnézet, benne van az árban.
- Az az előnézet, amelyhez 7 napig nem érkezik új push, törlődik. Az adott ágra érkező következő pushnál újra létrejön.
- Az előnézetek csak a nekik szánt változókat kapják meg – lásd: Környezeti változók.
- Előnézet a projekt fő szolgáltatásához készül, a többi szolgáltatáshoz nem.
Jelszó az előnézetekhez
Az Előnézetek fülön: Jelszó az előnézetekhez → Jelszó kérése. Adj meg egy felhasználónevet és egy jelszót (legalább 8 karakter). Ettől kezdve csak a jelszó birtokában lehet megnyitni az előnézeteket; maga az alkalmazás mindenki számára nyitva marad.
A release parancs (migrációk)
A Folyamatok fül → Release parancs. Minden telepítéskor egyszer fut le, mielőtt az új verzió látogatókat kapna – általában adatbázis-migrációkhoz. Ha hibára fut, a telepítés leáll, és a jelenlegi verzió fut tovább, így egy hibás migráció soha nem jut el a látogatóidhoz.
Azokhoz a keretrendszerekhez, amelyeknek van ilyen parancsa, javaslunk egyet:
| Keretrendszer | Javasolt release parancs |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
A Javasolt parancs használata megtartja; megadhatsz sajátot is, vagy választhatod a Nincs lehetőséget. A módosítások a következő telepítéstől érvényesek.
Buildbeállítások
A Beállítások → Buildbeállítások részen módosíthatod, amit felismertünk:
- Telepítési parancs – pl.
npm ci - Build parancs – pl.
npm run build - Indítási parancs – az alkalmazásodat elindító parancs. A
$PORTváltozóban megadott porton kell figyelnie. - Kimeneti mappa – statikus oldalaknál a buildelt fájlokat tartalmazó mappa.
- Projektmappa – több projektet tartalmazó repositoryhoz.
Hagyd üresen a mezőt, ha a felismert értéket szeretnéd használni. A következő telepítés már az új beállításokkal készül; a Buildelés most azonnal elindítja.
A Beállítások között található a telepített Ág is.
Telepítési hookok
Beállítások → Telepítési hookok → Hook létrehozása. A telepítési hook egy privát cím: amikor egy másik szolgáltatás POST kérést küld rá, az ágad legújabb commitja buildelődik és települ. Tipikus felhasználás egy CMS, amely közzététel után újraépíti az oldalt.
curl -X POST "<a hook címe a panelből>"- A cím csak egyszer jelenik meg – a hook létrehozásakor másold ki. Bárki, akinek megvan, telepítést indíthat, ezért tartsd titokban.
- Hookonként óránként legfeljebb 10 telepítés. Az a hívás, amely akkor érkezik, amikor egy build még vár, ahhoz csatlakozik.
- A Visszavonás azonnal leállítja a címet; az azt hívó szolgáltatásoknak ezután új cím kell.
Karbantartási mód
Beállítások → Karbantartási mód → Karbantartási oldal megjelenítése. A látogatók az alkalmazás helyett egy rövid oldalt látnak az üzeneteddel; ha üresen hagyod az üzenetet, ez jelenik meg: „Néhány fejlesztést végzünk. Kérjük, nézz vissza egy kicsit később.”
Maga az alkalmazás tovább fut, így az újbóli megnyitás előtt mindent ellenőrizhetsz. A Privát link neked azon az eszközön, amelyen megnyitod, 12 órán át a szokásos módon mutatja az alkalmazást. Az Új link frisset készít; a régi link ekkor megszűnik.
Kapcsold ki a kapcsolót, hogy az alkalmazás újra elérhető legyen a látogatóknak.
Értesítések a telepítésekről
E-mailt küldünk (és Telegram-üzenetet, ha csatlakoztattad), ha egy telepítés nem fejeződik be. Ha az eseményeket a csapatodnak is el szeretnéd küldeni – élesbe került egy új verzió, egy telepítés nem fejeződött be, egy szolgáltatás leállt vagy újra működik, magas memória- vagy processzorhasználat, mentés vagy adatbázislemez –, adj hozzá Slack, Discord vagy saját webhookot a Beállítások → Értesítések a csapatodnak részen. A webhook-üzenetek JSON formátumúak, és egy csak egyszer megjelenő titkos kulccsal vannak aláírva, az X-Rivervo-Signature fejlécben.