Přejít na hlavní obsah

Documentation Index

Fetch the complete documentation index at: https://wiki.diversity.cz/llms.txt

Use this file to discover all available pages before exploring further.

Náš panel umožňuje snadné nasazení Node.js aplikací. Každá aplikace běží ve svém vlastním kontejneru, což zajišťuje vysokou bezpečnost a stabilitu.
Node.js aplikace jsou dostupné u balíčků Business a Ultimate, nebo v rámci individuálních Managed řešení.

​
Vytvoření webové stránky

Před nasazením samotné aplikace musíte vytvořit prostor, kde poběží.
  1. Přihlaste se do svého ovládacího panelu.
  2. Klikněte na “Weby” a poté na “Přidat web”.
  3. Zadejte svou doménu.
  4. V hlavní sekci vyberte z nabídky: Začít od nuly.

​
Konfigurace Node.js

Jakmile je web vytvořen, rozklikněte jej a přejděte na záložku “Node.js” která se nachází v sekci “Pokročilé”. Po kliknutí na “Nasazení aplikace” uvidíte následující nastavení:
Img28
  • Node Version: Vyberte požadovanou verzi Node.js (doporučujeme používat LTS verze pro maximální stabilitu).
  • Pracovní adresář: Cesta k hlavní složce aplikace (obvykle /public_html nebo kořenový adresář).
  • Spouštěcí příkaz: Příkaz, který aplikaci spouští (např. npm start).
  • Port: Port, na kterém běží vaše aplikace uvnitř kontejneru (obvykle 3000).
Img29
Panel bude přesměrovávat požadavky na konkrétní cestu (nebo celý web) do vaší aplikace Node.js běžící uvnitř kontejneru webu. Jelikož každý kontejner webu má izolovaný síťový stack, stačí, aby byl port jedinečný v rámci daného webu. Nelze použít port menší než 1024 nebo větší než 65535.
Náš systém automaticky směruje provoz na HTTPS port. Což znamená, že po nasazení aplikace můžete jít rovnou na instalovanou doménu a zobrazit si web bez nutnosti zadávání portu.

​
Nahrání kódu a instalace modulů

Své soubory nahrajte pomocí FTP nebo přes File Manager (viz návod na FTP). Poté musíte nainstalovat závislosti (balíčky) definované ve vašem package.json.
1

Nahrání souborů

Nahrajte svůj kód do zvoleného “Application Root”. Ujistěte se, že nahráváte i soubor package.json.
2

NPM Install

V panelu u nastavení Node.js najdete tlačítko “Run npm install”. To automaticky stáhne všechny potřebné moduly do složky node_modules.
3

Spuštění aplikace

Klikněte na tlačítko “Start” nebo “Restart”. Aplikace se spustí na pozadí jako služba.

​
Provozní režimy (Automatic vs. Manual)

V našem panelu si můžete vybrat ze dvou režimů běhu aplikace podle toho, zda aplikaci ladíte, nebo už je plně v provozu.

​
1. Automatický režim (Doporučeno pro produkci)

Tento režim je navržen pro stabilní běh vašeho projektu.
  • Automatický start: Aplikace se spustí sama s vybranou verzí Node.js.
  • Restart při pádu: Pokud aplikace z jakéhokoliv důvodu skončí (chyba, pád serveru), náš panel ji okamžitě restartuje.
  • Logování: Výstupy Stdout a Stderr se ukládají do souboru v domovském adresáři ve formátu persistent_app_ID.log. Tento log se promazává (cykluje) při každém startu aplikace.
  • Jak restartovat: Pokud potřebujete aplikaci vynuceně restartovat, přepněte režim z Automatic na Manual a hned zase zpět.

​
2. Manuální režim (Pro vývoj a ladění)

V tomto režimu panel aplikaci nehlídá ani nespouští.
  • Ruční ovládání: Pokud aplikace spadne, zůstane vypnutá, dokud ji sami nespustíte.
  • Bez logů: V tomto režimu se negenerují automatické logy do souboru.
  • Proxy: I v manuálním režimu bude náš server nadále přesměrovávat požadavky na vaši aplikaci (pokud je to povoleno).

​
Správa a logování

Pokud vaše aplikace nefunguje podle očekávání, nejužitečnější informace najdete v .log souborech.
  • App Logs: Přímo v panelu můžete sledovat konzoli své aplikace. To je klíčové pro ladění chyb (např. chybějící moduly nebo špatné připojení k databázi).
  • Automatický restart: Pokud aplikace spadne, systém se ji pokusí automaticky restartovat (pokud je nastavena na Automaticky - Produkční režim).

​
Tipy pro produkci

  • Package-lock.json: Vždy nahrávejte i tento soubor, abyste zajistili, že se v produkci nainstalují přesně ty samé verze balíčků, které máte u sebe v počítači.
  • Statické soubory: Pokud vaše aplikace slouží i statické soubory (obrázky, CSS), doporučujeme pro optimální výkon použít Nginx jako reverzní proxy (již nastaveno v základu panelu).
Nikdy nenahrávejte složku node_modules přímo přes FTP. Je to pomalé a může to způsobit nekompatibilitu mezi operačními systémy. Vždy instalujte pomocí příkazu přímo z SSH.