Jelikož se JavaScript stal jedním z nejoblíbenějších programovacích jazyků pro tvorbu webových aplikací, mnoho našich zákazníků si tento jazyk oblíbilo.
Ale k vytváření škálovatelných aplikací pro prohlížeče a servery často chtějí používat Node.js.
Toto rockstar open-source multiplatformní prostředí umožňuje rychlý vývoj aplikací, což vede k vysoké produktivitě, a tedy rychlejšímu nasazení.
Web Hosting Magic nabízí škálovatelný a bezpečný webhosting, který naši zákazníci často popisují jako „skvělou alternativu k VPS “.
Náš selektor Node.js vám jako vývojáři JavaScriptu umožňuje mít webový prostor a zdroje potřebné pro vaši aplikaci a zároveň minimalizovat starosti se správou aplikací.
Jak nainstalovat aplikaci Node.js pomocí selektoru Node.js
Výběr node.js je komponenta CloudLinux, která každému uživateli umožňuje snadno vytvářet aplikace Node.js, zvolit verzi Node.js a další parametry pro aplikace podle jeho potřeb.
Díky přívětivému uživatelskému rozhraní sjednocuje všechny funkce na jednom místě a umožňuje velmi snadnou správu.
V době psaní tohoto článku náš Node.js Selector podporuje Node.js verze 11.x, 12.x, 14.x a další verze, které přijdou po tomto.
Node.js Selector má oproti ručnímu nasazení mnoho výhod.
Umožňuje spouštění několika různých aplikací pod stejným uživatelem, k nimž lze přistupovat z „Setup Node.js App ” ve vašem účtu cPanel.
Phusion cestující se používá pro předávání aplikací, takže nebudete muset nastavovat žádná přesměrování .htaccess, abyste řekli webovému serveru, aby přeposílal na port aplikace.
Se selektorem Node.js se o všechny tyto věci postará za vás.
Chcete-li začít, přejděte na cPanel → Sekce softwaru → Vyberte Node.js Version .
Zobrazí se stránka Web Applications a v seznamu uvidíte několik sloupců.
App URI:URI aplikace včetně domény.
- Kořenový adresář aplikace:kořenový adresář aplikace vzhledem k domovu uživatele.
- Režim:může to být výroba nebo vývoj.
- Stav:spuštěno/zastaveno – zobrazuje, zda je aplikace spuštěna či nikoli, a verzi aplikace.
- Akce:umožňuje spustit, restartovat, zastavit, upravit a odebrat konkrétní aplikaci.
Vytvořte účet cPanel
Než budete moci přistupovat a používat cPanel pro svá nasazení Node.js, musíte mít účet cPanel.
Chcete-li vytvořit účet cPanel, navštivte https://dashboard.webhostingmagic.com/cart.php?gid=1 a vyberte hostingový balíček.
Náš systém vás provede procesem, který vám zabere méně než 5 minut, než získáte přihlašovací údaje k cPanel.
Jak vytvořit aplikaci Node.js
Než budete moci nakonfigurovat aplikaci Node.js, budete muset tuto aplikaci dostat na váš server cPanel.
K nahrání kopie aplikace na váš server můžete jednoduše použít SFTP.
Nebo můžete také použít nativní podporu Git cPanel ke klonování úložiště na váš server a nasadit jej odtud.
V následujícím příkladu byla použita nativní podpora Git cPanel ke klonování aplikace na server a jejímu nasazení.
Klonujte aplikaci
- Přihlaste se do cPanel.
- V podokně Soubory vidíte rozhraní terminálu cPanel (cPanel – Home – Advanced – Terminal).
- Kliknutím na něj zobrazíte, kde můžete vytvořit úložiště Git.
- Nyní se vraťte na Github a klonujte pomocí HTTPS pomocí webové adresy URL. Aby byla data vaší aplikace v bezpečí, nezapomeňte je neklonovat ani nenahrávat do složky public_html, protože samotný kód je tak potenciálně přístupný z webu. Náš systém se snaží udržet vaše data v bezpečí a během implementace není podmínkou, aby byla data vaší aplikace veřejně přístupná.
Klonování na server cPanel ze soukromého úložiště Github
Soukromá úložiště vyžadují přístup SSH. Chcete-li naklonovat soukromě hostované vzdálené úložiště, musíte provést další kroky.
Pro přístup k příkazovému řádku z rozhraní cPanel můžete použít terminálové rozhraní cPanel (cPanel – Home – Advanced – Terminal).
Vygenerujte klíč SSH
Pokud jste jej ještě nenakonfigurovali, spusťte následující příkaz pro vygenerování klíče SSH:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
V tomto příkladu „uživatelské jméno “ představuje uživatelské jméno účtu cPanel a „example.com ” představuje název domény.
Po spuštění tohoto příkazu vás systém vyzve k zadání přístupové fráze.
Nezadávejte přístupové heslo.
Pokračujte stisknutím klávesy Enter.
Ověřte, že je klíč k dispozici
Chcete-li potvrdit, že klíč existuje a je ve správném umístění, spusťte následující příkaz:
cat ~/.ssh/id_rsa.pub
Zaregistrujte si náš klíč SSH u hostitele soukromého úložiště
Chcete-li zaregistrovat klíč SSH na GitHubu, proveďte následující kroky:
- Přihlaste se ke svému účtu GitHub.
- Přejděte do svého soukromého úložiště.
- V pravém horním rohu stránky klikněte na Nastavení. Zobrazí se nová stránka.
- V levé postranní nabídce klikněte na možnost Nasadit klíče. Zobrazí se nová stránka.
- V pravém horním rohu stránky klikněte na Přidat klíč nasazení. Zobrazí se nová stránka.
- Zadejte údaje o klíči SSH:
- Do textového pole Název zadejte zobrazovaný název klíče.
- Do textového pole Klíč vložte celý klíč SSH.
Pokud chcete odeslat kód z účtu cPanel do účtu GitHub, vyberte možnost „Povolit přístup pro zápis ” zaškrtávací políčko.
Pokud toto políčko nezaškrtnete, můžete nasadit změny pouze z vašeho úložiště GitHub do úložiště hostovaného cPanel.
- Klikněte na Přidat klíč.
Všimněte si, že někteří hostitelé repozitáře vám neumožňují konfigurovat přístup pro zápis pro vaše přístupové klíče.
Informace o tom, jak zaregistrovat svůj klíč SSH u jiného hostitele soukromého úložiště (Bitbucket, GitLab atd.), naleznete na webu nebo v dokumentaci tohoto hostitele.
Otestujte klíč SSH
Chcete-li otestovat klíč SSH, spusťte následující příkaz.
ssh -T [email protected]
kde „example.com“ představuje hostitele soukromého úložiště – např. ssh -T [email protected].
Klonujte Repo do cPanel
Chcete-li naklonovat úložiště, spusťte na účtu cPanel následující příkaz, kde „git clone [email protected]:$name/private-repo.git ” představuje adresu URL klonu soukromého úložiště:
git clone [email protected]:$name/private-repo.git
Pokud se zobrazí „Chyba:Navázání spojení WebSocket se nezdařilo v … ” když vstoupíte do rozhraní terminálu cPanel (cPanel – Home – Advanced – Terminal), znovu zkontrolujte své připojení.
Pokud používáte VPN, odpojte se a použijte normální internetové připojení.
Jakmile kliknete na „Vytvořit ” to vás vrátí zpět na stránku úložiště zobrazující úplnou cestu k nasazované aplikaci.
Tato stránka je důležitá, takže si cestu uložte pro pozdější použití.
Pro rekapitulaci:
- Vyberte verzi Node.js.
- Jako režim aplikace vyberte buď „Vývoj“ nebo „Výroba“.
- Vyberte kořen aplikace. Musí to být fyzická adresa vaší aplikace na serveru, která odpovídá jejímu URI.
- Vyberte adresu URL aplikace. Toto je odkaz HTTPS na vaši aplikaci.
- Vyplňte formulář tak, aby ukazoval na spouštěcí soubor aplikace. Můžete také přidat další proměnné prostředí kliknutím na „Přidat proměnnou“.
- Klikněte na Vytvořit.
… podrobnější vysvětlení.
Konfigurace aplikace Node.js
S aplikačními soubory umístěnými na serveru jste připraveni nakonfigurovat Node.js pro spouštění dané aplikace z webu.
Z cPanelu na stejném účtu v části „Software “, vyberte „Nastavení aplikace Node.js “.
Na této obrazovce nastavení vyberte „Vytvořit aplikaci ” zobrazíte možnosti výběru verze Node.js a také to, zda použít Vývoj nebo Produkce prostředí.
Vývoj má obecně různé aplikační háčky v kódu aplikace v závislosti na tom, jak je tato proměnná prostředí nastavena.
Obecně platí, že Production bude mít více úrovní ukládání do mezipaměti a také minimální protokolování.
U sady vývojového prostředí tedy můžete očekávat opak, s méně úrovněmi ukládání aplikací do mezipaměti a podrobnějším protokolováním a výstupem chybových zpráv.
Typickým příkladem je situace, kdy pokud se jedná o produkční prostředí, můžete vidět pouze chybovou stránku.
Ve vývoji můžete u chyby aplikace vidět úplné trasování zásobníku, což vám umožní přesně zjistit, kde se chyba uvnitř kódu stala.
Protože aplikace Node.js obecně závisí na několika proměnných prostředí, můžete je přidat pomocí „Přidat proměnnou ” v pravém dolním rohu stránky.
Proměnná produkce nebo vývoje Node.js je již nastavena samostatně v horní části pomocí „režimu aplikace “, není tedy nutné jej znovu nastavovat v sekci Proměnné prostředí.
Ve stejné nabídce můžete vybrat verzi Node.js, kterou chcete použít, a také spouštěcí soubor aplikace.
Může to být index.js , app.js, nebo libovolný počet variací; záleží na aplikaci.
Jakmile aplikaci uložíte, budete muset vyřešit její závislosti na balíčcích.
Správce balíčků NPM to provede automaticky na základě souboru package.json přibaleného k aplikaci, takže vše, co zde musíte udělat, je kliknout na tlačítko ‚NPM Install‘.
V tomto okamžiku budete vyžadovat, aby se vaše doména přeložila na IP adresu, jinak bude mít instalační skript chybu.
Pokud používáte subdoménu, ujistěte se, že byla vytvořena a že jste do svého DNS přidali všechny relevantní záznamy.
Můžete to potvrdit jednoduše spuštěním:
$ dig sub-domain.com
NPM přečte obsah souboru package.json a nainstaluje potřebné balíčky do virtuálního prostředí specifického pro danou aplikaci.
Pokud jste obeznámeni s příkazovým řádkem, můžete podle pokynů v horní části stránky získat přístup k příkazům „npm“ a „node“ a provést další změny ručně, což umožňuje velké množství přizpůsobení.
Node.js Application Deployment
V tomto okamžiku budete mít aplikaci nakonfigurovanou a nainstalované moduly Node.js, takže jste připraveni aplikaci spustit.
Naše systémy cPanel to velmi usnadňují.
Na stejné stránce, kde jste nakonfigurovali aplikaci, klikněte na „Spustit skript JS ”
Tím se spustí spouštěcí soubor aplikace, který jste definovali dříve během instalace.
Protože aplikace Node.js mají několik různých možností, může to vyvolat další nabídku s různými možnostmi, které lze vybrat v závislosti na aplikaci, kterou používáte.
Obecně platí, že budete chtít vybrat „Start ” další možnost.
Nakonec můžete vybrat „Otevřít ” možnost navštívit vaši stránku a zobrazit vaši aplikaci!
Jak spustit aplikaci Node.js
Chcete-li spustit zastavenou aplikaci, postupujte takto:
Klikněte na tlačítko Start ikonu ve sloupci Akce v řádku zastavené aplikace.
Po dokončení akce se ikona Start změní na ikonu Stop.
Jak zastavit aplikaci Node.js
Chcete-li zastavit spuštěnou aplikaci, postupujte takto:
Klikněte na tlačítko Zastavit ikonu ve sloupci Akce v řádku spuštěné aplikace.
Po dokončení akce se ikona Stop změní na ikonu Start.
Jak spustit aplikaci Node.js
Chcete-li aplikaci restartovat, postupujte takto:
Klikněte na tlačítko Restartovat ikonu ve sloupci Akce v řádku spuštěné aplikace.
Aktuální řádek bude zablokován a po dokončení procesu bude odblokován.
Jak odebrat aplikaci Node.js
Chcete-li aplikaci odebrat, postupujte takto:
Klikněte na ikonu „Bin“ ve sloupci Akce v konkrétním řádku aplikace.
v potvrzovacím okně klikněte na Souhlasím, chcete-li zahájit odstraňování, nebo na tlačítko Zrušit pro zavření vyskakovacího okna.
Po dokončení akce bude aplikace odstraněna z tabulky Webové aplikace a zobrazí se vyskakovací okno s potvrzením.
Jak upravit aplikaci Node.js
Chcete-li upravit aplikaci, postupujte takto:
Klikněte na ikonu tužky ve sloupci Akce v konkrétním řádku aplikace.
Otevře se karta aplikace.
V tuto chvíli můžete:
restartujte aplikaci – klikněte na Restartovat tlačítko.
- zastavit Node.js – klikněte na tlačítko Zastavit Node.js.
- spustit skript JavaScript – kliknutím na tlačítko Spustit skript JS spusťte příkaz zadaný v části Skripty souboru package.json. Zadejte název skriptu, který se má spustit, plus případné parametry a poté klikněte na OK.
- odebrat aplikaci – klikněte na tlačítko Odstranit a ve vyskakovacím okně potvrďte akci.
- změnit verzi Node.js – z rozbalovací nabídky vyberte verzi Node.js.
- změnit režim aplikace – z rozevírací nabídky vyberte režim aplikace. Dostupné režimy jsou Výroba a Vývoj.
zadat kořen aplikace — zadejte do pole fyzickou adresu aplikace na serveru, která odpovídá jejímu URI. - určete adresu URL aplikace – do pole zadejte odkaz HTTP/HTTPS na aplikaci.
- určete spouštěcí soubor aplikace – zadejte jako soubor NAME.js.
- spusťte příkaz npm install a kliknutím na tlačítko Spustit instalaci npm nainstalujte balíčky popsané v souboru package.json.
- přidat proměnné prostředí – klikněte na Přidat proměnnou a zadejte název a hodnotu.
Jak ladit chyby v aplikaci Node.js
Direktivy jako PassengerFriendlyErrorPages a PassengerAppEnv jsou k dispozici pro použití ze souboru .htaccess.
To umožňuje uživatelům cPanelu ladit aplikaci Node.js během vývoje.
Pokud například přidáte jeden z následujících řádků do souboru .htaccess na stránce aplikace a dojde k chybě, zobrazí se tato chyba:
PassengerAppEnv development
nebo
PassengerFriendlyErrorPages on