Hvernig á að setja upp Koa.js Node forrit á Ubuntu 16.04 LTS

Í þessari kennslu munum við læra hvernig á að setja upp Koa.js vefforrit fyrir framleiðslu með því að nota Node.js. Við munum einnig tengja sýnishorn af léni, með öfugri umboði, með Apache, og læra hvernig á að stjórna því með réttum vinnslustjóra. Án frekari ummæla skulum við byrja.

Stutt lýsing á Node.js, Koa.js og Apache

Node.js er hröð JavaScript rammi sem byggir á V8 vél Chrome. Það er notað bæði í skjáborðs- og netþjónaforritum og er frægt fyrir einþráða atburðalykkju meðhöndlun. Node.js er með pakkaskrá sem kallast Node Package Manager (NPM), sem hýsir yfir hálfa milljón pakka. NPM pakkar (eða einingar) eru kjarninn í Node.js, þar sem þeir eru samfélagsdrifinn kóða sem getur verið gagnlegur í Node.js forritinu þínu. Í Koa.js appinu okkar er Node.js kjarninn í hlutverki þess.

Koa.js er naumhyggjulegur veframmi, byggður á Node.js pallinum. Gert af sama teymi á bak við hið vinsæla Express.js ramma, markmið þess er að lágmarka enn frekar lágmarks Express.js rammann með því að útiloka millihugbúnað frá kjarna hans. Helsti eiginleiki Koa.js er sú staðreynd að það eru engar hringingar. Koa.js er byggt á ES6-undirstaða rafala og ES6 eiginleika, eins og loforð.

Apache er vinsæll opinn vefþjónn, notaður sem grunnur upphafspunktur fyrir netþjóna. Í þessari kennslu munum við nota Apache sem öfugt umboð, sem gerir okkur kleift að tengja forritið okkar við sýnishornslén. Ef þú ert ekki með lén mun þessi kennsla samt virka fyrir þig, eini munurinn er sá að vefsíðan mun keyra á VPS IP þinni, í stað léns.

Uppsetning Node.js

Eins og með hvaða Node.js ramma sem er, þá þarftu að setja upp Node.js á VPS þinn. Fyrir sakir þessarar kennslu mun ég gera ráð fyrir að þú hafir nú þegar Node.js uppsett á vélinni þinni. Ef ekki, geturðu einfaldlega fylgst með leiðbeiningunum hér .

Að setja upp forritaskrána okkar

Við þurfum að búa til möppu sem mun innihalda kjarnaskrár forritsins okkar.

mkdir site

Ekki hika við að skipta siteút fyrir annað nafn sem þú vilt fyrir möppuna. Næst þurfum við að frumstilla Node.js pakkaskrána okkar. Skiptu yfir í möppuna sem þú varst að búa til, keyrðu npm init, og kláraðu leiðbeiningarnar. Að lokum ætti það að líta einhvern veginn svona út:

{
  "name": "site",
  "version": "1.0.0",
  "description": "Koa.js Site",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "yourname",
  "license": "ISC"
}

Að setja upp Koa.js

Nú þegar við höfum sett upp möppuna okkar getum við haldið áfram að setja upp Koa.js. Í núverandi vinnuskrá, /site, sláðu inn eftirfarandi.

npm install koa

Þetta mun hlaða niður Koa.js einingunni frá NPM og setja hana upp í verkefnaskránni okkar til notkunar í framtíðinni. Næst munum við búa til sýnishorn af umsóknarskránni okkar sem mun geyma forritskóðann okkar. Til að gera það skaltu búa til index.jsskrá.

nano index.js

Þegar þú ert inni í skránni skaltu búa til sýnishornsforrit.

const Koa = require('koa');
const app = new Koa();

app.use(async ctx => {
     ctx.body = 'Hello World';
 });

app.listen(3000);
console.log('Website is live!')

Vistaðu og lokaðu skránni. CTRL+ X.

Við viljum ganga úr skugga um að forritið okkar gangi rétt. Til að ræsa það skaltu keyra node index.js, og þú munt sjá Website is liveí stjórnborðinu.

Að setja upp Apache

Nú þegar við vitum að vefsíðan okkar er virk, getum við haldið áfram að setja upp Apache og ósjálfstæði þess.

sudo apt install -y libapache2-mod-proxy-html libxml2-dev

Til þess að nota öfuga proxy eiginleika sem finnast í Apache, verðum við að virkja nauðsynlegar einingar.

a2enmod proxy
a2enmod proxy_http
a2enmod proxy_ajp
a2enmod rewrite
a2enmod deflate
a2enmod headers
a2enmod proxy_balancer
a2enmod proxy_connect
a2enmod proxy_html

Sumar þessara eininga kunna að hafa þegar verið virkjaðar, en það er alltaf gott að athuga þær.

Nú þurfum við að breyta sjálfgefna stillingarskránni fyrir Apache.

sudo nano /etc/apache2/sites-enabled/000-default.conf

Hér þurfum við að bæta við blokk fyrir umsókn okkar.

<VirtualHost *:*>
    ProxyPreserveHost On
    ProxyPass / http://0.0.0.0:3000/
    ProxyPassReverse / http://0.0.0.0:3000

    ServerName localhost
</VirtualHost>

Vistaðu skrána, CTRL+ X.

Þú gætir tekið eftir því að við erum að nota port 3000sem tengi fyrir okkar ProxyPassog ProxyPassReverseIP. Þar sem það er sama gátt og við erum að keyra Koa.js forritið okkar á, er mikilvægt að við setjum inn rétta höfnina.

Þegar breytingarnar eru komnar, þurfum við að endurræsa Apache og endurræsa Koa.js forritið okkar.

sudo systemctl restart apache2

Þetta mun tryggja að stillingarskráin okkar sé virk og tilbúin til að virka þegar við ræsum Koa.js forritið okkar. Þegar Apache hefur verið endurræst skaltu fara aftur í vefsvæðisskrána þína og ræsa Koa.js forritið eins og við gerðum áður. Í vafranum þínum, farðu að http://yourdomain, eða http://yourip:, og þú munt sjá „Halló heimur“.

Stjórna umsókn okkar með systemd

Nú þegar við höfum farið yfir grunnatriði þess að búa til sýnishorn af Koa.js forriti, gerum við okkur grein fyrir því að í framleiðsluumhverfi er óframkvæmanlegt að hefja forritið eins og við erum núna. Ferlastjóri er vissulega krafa. Það er þar sem systemd kemur við sögu. Í einföldu máli samanstendur systemd af hugbúnaði sem veitir byggingareiningar fyrir Linux kerfi. Svipað og „init“ býður það upp á kerfi til að stjórna notendaferlum eftir ræsingu kerfisins. Þegar um er að ræða forritið okkar gerir systemd okkur kleift að ræsa vefsíðuna okkar sjálfkrafa eftir að kerfið hefur verið endurræst, ef það er atburður sem truflar spennutíma kerfisins. Það býður einnig upp á sett af verkfærum sem geta komið sér vel þegar þú stjórnar forritinu okkar. Það besta er sú staðreynd að það er innbyggt í Ubuntu 16.04 LTS, svo við þurfum ekki að setja upp neinn viðbótarhugbúnað.

Búðu til kerfisbundna þjónustu

Allt sem við þurfum til að hefja forritið okkar mun vera að finna í skrá sem heitir service. Það geymir upplýsingar um appið okkar, svo sem nafn þess, skrá, umhverfi og fleira. Til að búa til kerfisskrána okkar skaltu opna textaritil.

sudo nano /lib/systemd/system/site.service

Breyttu og vistaðu skrána svona.

[Unit]
Description=desc here
Documentation=https://example.com
After=network.target

[Service]
Environment=NODE_PORT=3000
Type=simple
User=youruser
ExecStart=/usr/bin/node /home/[youruser]/site/index.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Skiptu út youruserfyrir notandanafn netþjónsins þíns. Hér er stutt yfirlit yfir mikilvægu svæðin:

• After - Þetta upplýsir systemd um að bíða þar til netviðmótið er tilbúið áður en forritið okkar hefst.
• Environment- Hér getum við tilgreint umhverfisbreytur fyrir forritið okkar. Node.js höfnin okkar er ein af þeim.
• Type - Þetta upplýsir systemd um að hægt sé að ræsa appið okkar, án þess að skipta sér af notendaréttindum og slíku.
• User- Þetta segir systemd að við viljum keyra forritið undir notendareikningnum okkar, sem mælt er með. Að keyra forrit sem rótnotandi getur leitt til margra öryggismála.
• ExecStart - Í meginatriðum skipunin sem systemd mun keyra til að ræsa forritið okkar, svipað og við byrjuðum það handvirkt áður.
• Restart- Segir systemd við hvaða aðstæður á að endurræsa forritið okkar. Í þessu tilviki viljum við endurræsa vefsíðuna okkar ef upp kemur villa.

Byrjaðu kerfisþjónustuna

Við erum nú tilbúin að hefja systemd þjónustu okkar.

sudo systemctl daemon-reload

Þetta er nauðsynlegt þegar kerfisþjónustuskrá breytist til að systemd geti skráð allar nýjar breytingar sem gerðar eru.

Byrjaðu síðan umsókn þína.

sudo systemctl start site

Farðu aftur á síðuna í vafranum þínum til að ganga úr skugga um að allt virki.

Lykilkerfisstjórnunaraðgerðir

• stop - Stöðvar forritið alveg.
• restart - Stöðvar forritið og ræsir það aftur undir nýju ferli.
• enable - Segir systemd að ræsa forritið í hvert skipti sem þú ræsir tölvuna þína.
• status - Sýnir upplýsingar um forritið sem er í gangi, svo sem spenntur, stöðu forrits og fleira.

Til að nota einhverja af þessum aðgerðum skaltu keyra eftirfarandi.

systemctl <function> site

Niðurstaða

Við höfum sett upp Koa.js forrit með góðum árangri og lært hvernig á að snúa umboði því, auk þess að stjórna því með systemd. Þú ert nú tilbúinn til að auka umsókn þína og byggja á þessu dæmi. Ef þú vilt fræðast meira um Koa.js og fleira sem þú getur gert með, farðu á vefsíðu þeirra fyrir frekari upplýsingar. Að auki, ef þú vilt læra meira um vinnslustjóra systemd, lestu skjölin fyrir það hér . Að lokum, ef þú vilt læra meira um andstæða umboð Apache, ekki hika við að skoða þá hér .