Koa.js-solmusovelluksen määrittäminen Ubuntu 16.04 LTS:ssä

Tässä opetusohjelmassa opimme määrittämään Koa.js-verkkosovelluksen tuotantoa varten Node.js:n avulla. Linkitämme myös esimerkkiverkkotunnuksen käänteisellä välityspalvelimella Apachen avulla ja opimme hallitsemaan sitä asianmukaisen prosessinhallinnan avulla. Pidemättä puhetta, aloitetaan.

Lyhyt kuvaus Node.js-, Koa.js- ja Apachesta

Node.js on nopea, monialustainen JavaScript-kehys, joka perustuu Chromen V8-moottoriin. Sitä käytetään sekä työpöytä- että palvelinsovelluksissa, ja se on kuuluisa yksisäikeisestä tapahtumasilmukan käsittelystään. Node.js sisältää pakettirekisterin nimeltä Node Package Manager (NPM), joka isännöi yli puoli miljoonaa pakettia. NPM-paketit (tai moduulit) ovat Node.js:n ydinrunko, koska ne ovat yhteisölähtöisiä koodeja, joista voi olla hyötyä Node.js-sovelluksessasi. Koa.js-sovelluksessamme Node.js on sen toiminnan ydin.

Koa.js on minimalistinen verkkokehys, joka on rakennettu Node.js-alustalle. Sen on tehnyt sama tiimi suositun Express.js-kehyksen takana, ja sen tavoitteena on minimoida entisestään jo ennestään minimalistinen Express.js-kehys sulkemalla väliohjelmistot pois sen ytimestä. Koa.js:n tärkein ominaisuus on se, että takaisinsoittoja ei ole. Koa.js on rakennettu ES6-pohjaisille generaattoreille ja ES6-ominaisuuksille, kuten Promises.

Apache on suosittu avoimen lähdekoodin verkkopalvelin, jota käytetään web-palvelimien peruslähtökohtana. Tässä opetusohjelmassa käytämme Apachea käänteisenä välityspalvelimena, jonka avulla voimme linkittää sovelluksemme esimerkkiverkkotunnukseen. Jos sinulla ei ole verkkotunnusta, tämä opetusohjelma toimii edelleen sinulle, sillä ainoa ero on, että verkkosivusto toimii VPS-IP-osoitteellasi verkkotunnuksen sijaan.

Node.js:n määrittäminen

Kuten missä tahansa Node.js-kehyksessä, sinun on asennettava Node.js VPS:ään. Tämän opetusohjelman vuoksi oletan, että Node.js on jo asennettu järjestelmääsi. Jos ei, voit seurata ohjeita täällä .

Sovellushakemistomme määrittäminen

Meidän on luotava kansio, joka sisältää sovelluksemme ydintiedostot.

mkdir site

Voit vapaasti korvata sitesen millä tahansa muulla nimellä, jonka haluat hakemistoon. Seuraavaksi meidän on alustettava Node.js-pakettitiedostomme. Vaihda juuri luomaasi hakemistoon, suorita npm initja täytä kehotteet. Loppujen lopuksi sen pitäisi näyttää suunnilleen tältä:

{
  "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"
}

Koa.js:n asentaminen

Nyt kun hakemistomme on määritetty, voimme jatkaa Koa.js:n asentamista. Kirjoita nykyiseen työhakemistoon /siteseuraava.

npm install koa

Tämä lataa Koa.js-moduulin NPM:stä ja asentaa sen projektihakemistoomme tulevaa käyttöä varten. Seuraavaksi luomme mallisovellustiedoston, joka sisältää sovelluskoodimme. Voit tehdä tämän luomalla index.jstiedoston.

nano index.js

Kun olet tiedoston sisällä, luo mallisovellus.

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

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

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

Tallenna ja sulje tiedosto. CTRL+ X.

Haluamme varmistaa, että sovelluksemme toimii oikein. Käynnistä se suorittamalla node index.js, ja näet Website is livekonsolissa.

Apachen asennus

Nyt kun tiedämme, että verkkosivustomme toimii, voimme jatkaa Apachen ja sen riippuvuuksien asentamista.

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

Jotta voisimme käyttää Apachesta löytyvää käänteistä välityspalvelinta, meidän on otettava käyttöön tarvittavat moduulit.

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

Jotkut näistä moduuleista voivat olla jo käytössä, mutta on aina hyvä tarkistaa ne uudelleen.

Nyt meidän on muokattava Apachen oletusasetustiedostoa.

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

Täällä meidän on lisättävä lohko sovelluksellemme.

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

    ServerName localhost
</VirtualHost>

Tallenna tiedosto, CTRL+ X.

Saatat huomata, että käytämme 3000porttia meidän ProxyPassja ProxyPassReverseIP: n porttina . Koska kyseessä on sama portti, jossa käytämme Koa.js-sovellustamme, on välttämätöntä syöttää oikea portti.

Kun muutokset on tehty, meidän on käynnistettävä Apache uudelleen ja käynnistettävä Koa.js-sovellus uudelleen.

sudo systemctl restart apache2

Tämä varmistaa, että määritystiedostomme on aktiivinen ja valmis toimimaan, kun käynnistämme Koa.js-sovelluksen. Kun Apache on käynnistetty uudelleen, siirry takaisin sivustohakemistoosi ja käynnistä Koa.js-sovellus kuten teimme aiemmin. Siirry verkkoselaimessa kohtaan http://yourdomain, tai http://yourip:ja näet "Hello World".

Sovelluksemme hallinta systemd:llä

Nyt kun olemme käsitelleet Koa.js-mallisovelluksen luomisen perusteet, ymmärrämme, että tuotantoympäristössä sovelluksen käynnistäminen nykyisellään on epäkäytännöllistä. Prosessipäällikkö on ehdottomasti edellytys. Siinä systemd tulee peliin. Yksinkertaisesti sanottuna systemd koostuu ohjelmistoista, jotka tarjoavat rakennuspalikoita Linux-järjestelmälle. Kuten "init", se tarjoaa järjestelmän käyttäjien prosessien hallintaan järjestelmän käynnistyksen jälkeen. Sovelluksemme tapauksessa systemd antaa meille mahdollisuuden käynnistää verkkosivustomme automaattisesti järjestelmän uudelleenkäynnistyksen jälkeen, jos jokin tapahtuma häiritsee järjestelmän käytettävyyttä. Se tarjoaa myös joukon työkaluja, jotka voivat olla hyödyllisiä sovelluksemme hallinnassa. Parasta on, että se on sisäänrakennettu Ubuntu 16.04 LTS:ään, joten meidän ei tarvitse asentaa lisäohjelmistoja.

Luo järjestelmäpalvelu

Kaikki mitä tarvitsemme sovelluksemme käynnistämiseen, on tiedostossa nimeltä service. Se sisältää tietoja sovelluksestamme, kuten sen nimen, hakemiston, ympäristön ja paljon muuta. Luo järjestelmätiedostomme avaamalla tekstieditori.

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

Muokkaa ja tallenna tiedosto näin.

[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

Korvaa youruserpalvelimesi käyttäjätunnuksella. Tässä on lyhyt yhteenveto tärkeistä kentistä:

• After - Tämä kehottaa systemdiä odottamaan, kunnes verkkoliitäntä on valmis ennen sovelluksemme käynnistämistä.
• Environment- Täällä voimme määrittää ympäristömuuttujat sovelluksellemme. Node.js-porttimme on yksi niistä.
• Type - Tämä ilmoittaa systemdille, että sovelluksemme voidaan vain käynnistää ilman käyttöoikeuksia ja vastaavia.
• User- Tämä kertoo systemdille, että haluamme suorittaa sovelluksen käyttäjätunnuksellamme, mikä on suositeltavaa. Sovellusten käyttäminen pääkäyttäjänä voi johtaa moniin tietoturvariskeihin.
• ExecStart - Pohjimmiltaan komento, jota systemd suorittaa käynnistääkseen sovelluksemme, samalla tavalla kuin käynnistimme sen manuaalisesti aiemmin.
• Restart- Kertoo systemdille, millä ehdoilla sovelluksemme on käynnistettävä uudelleen. Tässä tapauksessa haluamme käynnistää verkkosivustomme uudelleen virheen sattuessa.

Käynnistä järjestelmäpalvelu

Olemme nyt valmiita käynnistämään järjestelmäpalvelumme.

sudo systemctl daemon-reload

Tämä on tarpeen aina, kun systemd-palvelutiedosto muuttuu, jotta systemd rekisteröi uudet muutokset.

Aloita sitten hakemuksesi.

sudo systemctl start site

Siirry sivustolle selaimessasi uudelleen ja varmista, että kaikki toimii.

Tärkeimmät järjestelmän hallintatoiminnot

• stop - Pysäyttää sovelluksen kokonaan.
• restart - Pysäyttää sovelluksen ja käynnistää sen uudelleen uudessa prosessissa.
• enable - Käskee systemdiä käynnistämään sovelluksen aina, kun käynnistät tietokoneen.
• status - Näyttää tietoja parhaillaan käynnissä olevasta sovelluksesta, kuten käytettävyyden, sovelluksen tilan ja paljon muuta.

Jos haluat käyttää jotakin näistä toiminnoista, suorita seuraava.

systemctl <function> site

Johtopäätös

Olemme onnistuneesti määrittäneet Koa.js-sovelluksen ja oppineet kääntämään sen välityspalvelimen takaisin sekä hallitsemaan sitä systemd:llä. Olet nyt valmis laajentamaan hakemustasi ja tukemaan tätä esimerkkiä. Jos haluat tietää lisää Koa.js:sta ja muista asioista, joita voit tehdä, vieraile heidän verkkosivustollaan saadaksesi hyödyllistä tietoa. Tämän lisäksi, jos haluat oppia lisää systemd:n ​​prosessinhallinnasta, lue sen dokumentaatio täältä . Lopuksi, jos haluat lisätietoja Apachen käänteisestä välityspalvelimesta, tutustu niihin täällä .