Ako nasadiť prvú Node.js aplikáciu
Tento návod prevedie celým postupom na najmenšej možnej aplikácii. Rovnako sa nasadzujú aj väčšie projekty, odlišné nastavenia nájdete v návodoch pre Next.js a NestJS.
Pripravte si aplikáciu
Aplikácia musí prijímať požiadavky na porte z premennej PORT. Tú nastavujeme my, v kóde ju len prečítate:
const express = require("express");
const app = express();
app.get("/", (req, res) => res.send("Aplikácia beží"));
app.listen(process.env.PORT || 3000);
Súbor uložte ako server.js. V package.json musí byť príkaz start:
{
"name": "moja-aplikacia",
"version": "1.0.0",
"scripts": { "start": "node server.js" },
"dependencies": { "express": "^5.0.0" }
}
Spustite npm install, aby vznikol súbor package-lock.json. Nasadenie ho potrebuje.
Vytvorte aplikáciu v paneli
- V detaile balíka na záložke Aplikácie kliknite na Vytvoriť aplikáciu.
- Zadajte názov, typ nechajte Node.js aplikácia a nastavte pamäť. Malému API stačí 256 MB, súčet všetkých aplikácií sa musí zmestiť do balíka.
Nahrajte kód
Zbaľte projekt bez priečinka node_modules, závislosti nainštalujeme na serveri:
tar -czf build.tar.gz server.js package.json package-lock.json
Na záložke Nasadenia kliknite na Nahrať build a vyberte súbor. Prijímame ZIP aj tar.gz do veľkosti 300 MB. Priebeh uvidíte v logu nasadenia po kliknutí na riadok.
Skontrolujte výsledok
Po dokončení má aplikácia stav Beží a nájdete pri nej dočasnú adresu s HTTPS. Keď sa nasadenie nepodarí, predchádzajúca verzia beží ďalej a dôvod je v logu.
Pridajte vlastnú doménu
- Na záložke Domény pridajte doménu, napríklad
moja-domena.sk. - U správcu DNS nasmerujte doménu A záznamom na IP adresu servera, ktorú uvidíte v paneli.
- Certifikát HTTPS vznikne automaticky, keď doména začne smerovať na server.
Keď niečo nefunguje
- Aplikácia neodpovedá na porte z PORT: aplikácia nepočúva na
process.env.PORT, alebo pri štarte spadla. Dôvod je na konci logu nasadenia. - V kóde chýba package-lock.json: pridajte tento súbor do archívu.
- V kóde chýba package.json: súbor musí byť v koreni archívu.
- Aplikácia sa reštartuje alebo padá: pozrite záložku Logy a v Grafoch skontrolujte, či jej stačí pamäť.
- Logy sú prázdne: v logoch je len to, čo aplikácia sama vypíše (console.log, console.error). Vypíšte aspoň správu po štarte servera.
Port a adresa
Express aj NestJS počúvajú na všetkých adresách samy. Fastify a niektoré ďalšie servery predvolene len na 127.0.0.1, vtedy nasadenie skončí chybou o porte. Nastavte im host 0.0.0.0.