Kezdés

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.

4 PERC OLVASÁS

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:

KeretrendszerJavasolt release parancs
Laravelphp artisan migrate --force
Djangopython 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 $PORT vá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.

Elakadtál?

Írj nekünk chaten — az AI azonnal válaszol, és ha kell, egy mérnök is bekapcsolódik, a nap bármely szakában.

Ügyfélszolgálat