Como configurar um aplicativo de nó Koa.js no Ubuntu 16.04 LTS

Neste tutorial, aprenderemos a configurar um aplicativo da Web Koa.js para produção, utilizando o Node.js. Também estaremos vinculando um domínio de amostra, com um proxy reverso, usando o Apache, e aprenderemos a gerenciá-lo com um gerenciador de processos adequado. Sem mais delongas, vamos começar.

Breve Descrição do Node.js, Koa.js e Apache

O Node.js é uma estrutura JavaScript rápida e de plataforma cruzada baseada no mecanismo V8 do Chrome. Ele é usado em aplicativos de desktop e de servidor e é famoso por seu tratamento de loop de evento single-threaded. O Node.js possui um registro de pacotes chamado Node Package Manager (NPM), que hospeda mais de meio milhão de pacotes. Os pacotes NPM (ou módulos) são o backbone principal do Node.js, pois são códigos orientados para a comunidade que podem ser úteis em seu aplicativo Node.js. Em nosso aplicativo Koa.js, o Node.js é a parte principal de sua função.

Koa.js é um framework web minimalista, construído na plataforma Node.js. Feita pela mesma equipe por trás da popular estrutura Express.js, seu objetivo é minimizar ainda mais a estrutura Express.js já minimalista, excluindo o middleware de seu núcleo. Um recurso importante do Koa.js é o fato de não haver retornos de chamada. O Koa.js é baseado em geradores baseados no ES6 e em recursos ES6, como o Promises.

O Apache é um servidor web de código aberto popular, usado como um ponto de partida muito básico para servidores web. Neste tutorial, usaremos o Apache como um proxy reverso, o que nos permitirá vincular nosso aplicativo a um domínio de amostra. Se você não tiver um domínio, este tutorial ainda funcionará para você, com a única diferença de que o site será executado em seu IP VPS, em vez de um domínio.

Configurando o Node.js

Como em qualquer estrutura do Node.js, você precisará instalar o Node.js no seu VPS. Por causa deste tutorial, vou assumir que você já tem o Node.js instalado em seu sistema. Se não, você pode simplesmente seguir as instruções aqui .

Configurando nosso diretório de aplicativos

Nós precisaremos criar uma pasta, que conterá os arquivos principais da nossa aplicação.

mkdir site

Sinta-se à vontade para substituir sitequalquer outro nome que desejar para o diretório. Em seguida, precisaremos inicializar nosso arquivo de pacote Node.js. Altere para o diretório que você acabou de criar, execute npm inite conclua os prompts. No final, deve ser algo como isto:

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

Instalando o Koa.js

Agora que temos nosso diretório configurado, podemos instalar o Koa.js. No diretório de trabalho atual /site, digite o seguinte.

npm install koa

Isso fará o download do módulo Koa.js do NPM e o instalará em nosso diretório de projeto para uso futuro. Em seguida, criaremos nosso arquivo de aplicativo de amostra que conterá nosso código de aplicativo. Para fazer isso, crie um index.jsarquivo.

nano index.js

Uma vez dentro do arquivo, crie um aplicativo de amostra.

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

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

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

Salve e feche o arquivo. CTRL+ X.

Vamos querer ter certeza de que nosso aplicativo seja executado corretamente. Para iniciá-lo, corra node index.jse você verá Website is liveno console.

Instalando o Apache

Agora que sabemos que nosso site está funcionando, podemos instalar o Apache e suas dependências.

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

Para usar o recurso de proxy reverso encontrado no Apache, precisaremos ativar os módulos necessários.

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

Alguns desses módulos já podem ter sido habilitados, mas é sempre bom verificar novamente.

Agora precisamos editar o arquivo de configuração padrão do Apache.

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

Aqui, precisaremos adicionar um bloco para o nosso aplicativo.

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

    ServerName localhost
</VirtualHost>

Salve o arquivo, CTRL+ X.

Você pode perceber que estamos usando porta 3000como porta para nosso ProxyPasse ProxyPassReverseIP. Como é a mesma porta em que estamos executando nosso aplicativo Koa.js, é imperativo que nós digitemos a porta correta.

Uma vez que as mudanças estejam implementadas, precisaremos reiniciar o Apache e relançar nosso aplicativo Koa.js.

sudo systemctl restart apache2

Isso garantirá que nosso arquivo de configuração esteja ativo e pronto para funcionar quando iniciarmos nosso aplicativo Koa.js. Depois que o Apache for reiniciado, navegue de volta para o diretório do seu site e inicie o aplicativo Koa.js como fizemos anteriormente. No seu navegador da Web, navegue até http://yourdomain, ou http://yourip:e você verá “Hello World”.

Managing our application with systemd

Agora que abordamos os fundamentos da criação de um aplicativo Koa.js de amostra, percebemos que, em um ambiente de produção, iniciar o aplicativo como estamos agora é impraticável. Um gerente de processo é definitivamente um requisito. É aí que o systemd entra em jogo. Em termos simples, o systemd consiste em software que fornece blocos de construção para um sistema Linux. Semelhante ao “init”, ele fornece um sistema para gerenciar processos do usuário após a inicialização do sistema. No caso de nossa aplicação, o systemd nos permite iniciar nosso website automaticamente após a reinicialização do sistema, caso ocorra um evento que interrompa o tempo de atividade do sistema. Ele também fornece um conjunto de ferramentas que podem ser úteis ao gerenciar nosso aplicativo. A melhor parte é o fato de que ele é construído no Ubuntu 16.04 LTS, portanto, não precisamos instalar nenhum software adicional.

Criar serviço systemd

Tudo o que precisamos para iniciar nosso aplicativo estará contido em um arquivo chamado service. Ele contém detalhes sobre nosso aplicativo, como nome, diretório, ambiente e muito mais. Para criar nosso arquivo de sistema, abra um editor de texto.

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

Edite e salve o arquivo como este.

[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

Substitua youruserpelo nome de usuário do seu servidor. Aqui está um resumo rápido dos campos importantes:

• After – Isso informa ao sistema para esperar até que a interface de rede esteja pronta antes de iniciar nosso aplicativo.
• Environment– Aqui podemos especificar variáveis ​​de ambiente para nossa aplicação. Nossa porta Node.js é uma delas.
• Type – Isso informa ao sistema que nosso aplicativo pode ser inicializado, sem precisar de privilégios de usuário e tal.
• User– Isso informa ao systemd que queremos executar o aplicativo em nossa conta de usuário, o que é recomendado. A execução de aplicativos como o usuário raiz pode levar a muitos comprometimentos de segurança.
• ExecStart – Essencialmente, o comando que o systemd estará executando para iniciar nosso aplicativo, semelhante ao modo como iniciamos manualmente antes.
• Restart– Diz ao sistema sob quais condições reiniciar nossa aplicação. Neste caso, queremos que o nosso site seja reiniciado em caso de erro.

Inicie o serviço systemd

Agora estamos prontos para iniciar nosso serviço systemd.

sudo systemctl daemon-reload

Isso é necessário sempre que um arquivo de serviço do systemd é alterado para que o systemd registre quaisquer novas alterações feitas.

Em seguida, inicie sua inscrição.

sudo systemctl start site

Navegue para o site no seu navegador novamente para verificar se tudo está funcionando.

Key systemd gerenciando funções

• stop – Pára a aplicação completamente.
• restart – Pára o aplicativo e o inicia novamente em um novo processo.
• enable – Diz ao systemd para iniciar o aplicativo sempre que você iniciar o seu computador.
• status – Mostra informações sobre o aplicativo em execução no momento, como tempo de atividade, estado do aplicativo e muito mais.

Para usar qualquer uma dessas funções, execute o seguinte.

systemctl <function> site

Conclusão

Nós configuramos com sucesso um aplicativo Koa.js e aprendemos como inverter o proxy, bem como gerenciá-lo com o systemd. Agora você está pronto para expandir seu aplicativo e desenvolver este exemplo. Se você gostaria de saber mais sobre o Koa.js, e mais coisas que você pode fazer, visite o site deles , para mais informações úteis. Além disso, se você quiser saber mais sobre o gerenciador de processos do systemd, leia a documentação aqui . Finalmente, se você quiser saber mais sobre o proxy reverso do Apache, fique à vontade para vê-los aqui .