A tárolóból történő telepítés akkor megy zökkenőmentesen, ha az alkalmazás néhány egyszerű szabályt követ: egyértelmű indítás, a porton hallgatás, a titkok környezeti változóban és tiszta függőségek. Ez az útmutató ezeket veszi sorra, a Montavio Node.js tárhelyéhez igazítva.
A lépések a rendelés utáni teendőktől a hibás kiadás visszaállításáig vezetnek. Az egyes beállításokat az ügyfélkapuban végzed; ha valami eltér, a csomagoldal és a súgó az irányadó.
1. Készítsd elő az alkalmazást
- A package.json tartalmazzon egyértelmű start szkriptet, és a függőségek a dependencies alatt legyenek, ne csak a devDependencies között.
- Add meg az engines mezőben a támogatott Node.js főverziót (26, 24 vagy 22), és helyben ugyanazzal teszteld.
- A lock-fájl (package-lock.json vagy hasonló) legyen a tárolóban, hogy a build ugyanazt telepítse, amit te teszteltél.
- A node_modules és a titkos fájlok (.env) ne kerüljenek a tárolóba.
{
"scripts": { "start": "node server.js" },
"engines": { "node": ">=22" }
}2. Hallgass a megadott porton
A platform a portot környezeti változóban adja át, ezért ne égess be fix számot. Ha nincs megadva (például helyi fejlesztésnél), használj tartalék értéket.
const port = process.env.PORT || 3000;
app.listen(port, () => console.log(`Listening on ${port}`));3. Titkok környezeti változóban
- Gyűjtsd ki, milyen beállításokat olvas az app: adatbázis-kapcsolat, API-kulcsok, session-titok.
- Add meg őket az ügyfélkapuban a környezeti változók között, és szükség esetén indítsd újra az alkalmazást.
- Az adatbázis csatlakozási adatait az ügyfélkapuban egyszer mutatjuk meg, ezért mentsd el biztonságos helyre.
- A kódban soha ne legyen jelszó vagy kulcs, és ha mégis kikerült, cseréld ki.
4. Tároló és hozzáférés
| Helyzet | Teendő |
|---|---|
| Nyilvános tároló | Add meg a tároló címét és az ágat (branch), majd tedd közzé. |
| Privát tároló | Add hozzá az alkalmazáshoz kapott publikus kulcsot a tárolóhoz telepítési kulcsként, csak olvasási joggal. |
| Új kulcs kell | Kérj újat; a régi kulcs ekkor érvénytelenné válik, ezért cseréld ki a tárolóban is. |
5. Saját domain és HTTPS
- Add hozzá a domaint az alkalmazáshoz az ügyfélkapuban, és állítsd be a DNS-rekordot a kapott utasítás szerint.
- Ellenőrizd parancssorból, hogy a név a megadott címre mutat (lásd a DNS-ellenőrzés útmutatót).
- A tanúsítványt a rendszer állítja ki és újítja meg; nyisd meg az oldalt HTTPS-en, és ellenőrizd az átirányításokat.
6. Ha a telepítés vagy az indítás hibás
| Hibajelenség | Valószínű ok | Mit ellenőrizz? |
|---|---|---|
| A build leáll | Hiányzó függőség vagy nem támogatott Node.js-verzió | Build-napló, engines mező, lock-fájl |
| Az app elindul, de nem érhető el | Fix porton vagy csak localhoston hallgat | A process.env.PORT használata, a hallgatási cím |
| Az app azonnal leáll | Hiányzó környezeti változó vagy kezeletlen hiba | Futásidejű napló az ügyfélkapuban |
| Adatbázishiba | Rossz csatlakozási adat vagy hiányzó tábla | Környezeti változók, phpMyAdmin |
| Memóriahiba | A csomag memóriakerete kevés | Memóriahasználat, nagyobb csomag |
7. Visszaállás hibás kiadás után
Ha az új verzió hibás, ne javítgass az éles környezetben: állj vissza az előző kiadásra az ügyfélkapuban. Az utolsó néhány verziót megőrizzük, ezért a visszaállítás nem igényel új buildet a tárolódból.
