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

• Breve descrição do Node.js, Koa.js e Apache
• Configurando o Node.js
• Configurando nosso diretório de aplicativos
• Instalando o Koa.js
• Instalando o Apache
• Gerenciando nosso aplicativo com systemd
• Conclusão

Neste tutorial, aprenderemos como configurar um aplicativo Web Koa.js para produção, utilizando Node.js. Também vincularemos um domínio de amostra, com um proxy reverso, usando o Apache, e aprenderemos como 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 multiplataforma, baseada no mecanismo V8 do Chrome. Ele é usado em aplicativos de desktop e servidor e é famoso por seu tratamento de loop de eventos de thread único. O Node.js possui um registro de pacote chamado Node Package Manager (NPM), que hospeda mais de meio milhão de pacotes. Pacotes (ou módulos) do NPM são a espinha dorsal principal do Node.js., pois são códigos orientados pela comunidade que podem ser úteis no seu aplicativo Node.js. Em nosso aplicativo Koa.js, o Node.js é a parte principal de sua função.

O Koa.js é uma estrutura da web minimalista, criada na plataforma Node.js. Feito pela mesma equipe por trás da popular estrutura Express.js., seu objetivo é minimizar ainda mais a estrutura já minimalista do Express.js. excluindo o middleware de seu núcleo. Uma das principais características do Koa.js é o fato de não haver retornos de chamada. O Koa.js é construído em geradores baseados no ES6 e recursos do 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 proxy reverso, o que nos permitirá vincular nosso aplicativo a um domínio de amostra. Se você não possui um domínio, este tutorial ainda funcionará para você, com a única diferença: o site será executado no seu IP VPS, em vez de em um domínio.

Configurando o Node.js

Como em qualquer estrutura do Node.js., você precisará instalar o Node.js. no seu VPS. Para fins deste tutorial, assumirei que você já possui o Node.js instalado no seu sistema. Caso contrário, você pode simplesmente seguir as instruções aqui .

Configurando nosso diretório de aplicativos

Precisamos criar uma pasta que contenha os arquivos principais do aplicativo.

mkdir site

Sinta-se à vontade para substituir sitepor qualquer outro nome que você queira para o diretório. Em seguida, precisaremos inicializar nosso arquivo de pacote Node.js. Mude para o diretório que você acabou de criar, execute npm inite conclua as instruções. 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 projetos para uso futuro. Em seguida, criaremos nosso arquivo de aplicativo de amostra que conterá o código do 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.

Queremos garantir que nosso aplicativo seja executado corretamente. Para iniciá-lo, execute 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, precisamos 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 podem já estar ativados, mas é sempre bom checá-los.

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

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

Aqui, precisaremos adicionar um bloco para 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 a porta 3000como a porta para o nosso ProxyPasse o ProxyPassReverseIP. Como é a mesma porta em que estamos executando nosso aplicativo Koa.js, é imperativo inserir a porta correta.

Depois que as alterações forem implementadas, precisaremos reiniciar o Apache e reiniciar o 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, volte ao diretório do site e inicie o aplicativo Koa.js, como fizemos anteriormente. No seu navegador, navegue para http://yourdomain, ou http://yourip:, e você verá "Hello World".

Gerenciando nosso aplicativo com systemd

Agora que abordamos o básico da criação de um aplicativo Koa.js de amostra, percebemos que, em um ambiente de produção, iniciar o aplicativo como agora é impraticável. Um gerente de processo é definitivamente um requisito. É aí que o systemd entra em cena. Em termos simples, o systemd consiste em software que fornece blocos de construção para um sistema Linux. Semelhante ao "init", fornece um sistema para gerenciar processos do usuário após a inicialização do sistema. No caso de nosso aplicativo, o systemd nos permite iniciar automaticamente nosso site após a reinicialização do sistema, caso haja 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 ele estar embutido no Ubuntu 16.04 LTS, portanto, não precisamos instalar nenhum software adicional.

Criar serviço systemd

Tudo o que precisa para começar a nossa aplicação será 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 assim.

[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 rápido resumo dos campos importantes:

• After - Isso informa ao systemd que aguarde 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 systemd que nosso aplicativo pode ser iniciado apenas, sem exigir privilégios de usuário e tal.
• User- Isso diz ao systemd que queremos executar o aplicativo em nossa conta de usuário, o que é recomendado. A execução de aplicativos como usuário root pode levar a muitos comprometimentos de segurança.
• ExecStart - Essencialmente o comando que systemd estará executando para iniciar nosso aplicativo, semelhante à forma como o iniciamos manualmente antes.
• Restart- Diz ao systemd sob quais condições reiniciar nosso aplicativo. Nesse caso, queremos que 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 for alterado para que o systemd registre quaisquer novas alterações feitas.

Em seguida, inicie seu aplicativo.

sudo systemctl start site

Navegue para o site no seu navegador mais uma vez, para verificar se tudo está funcionando.

Principais funções de gerenciamento do sistema

• stop - Pára o aplicativo completamente.
• restart - Interrompe o aplicativo e o inicia novamente em um novo processo.
• enable - Diz ao systemd para iniciar o aplicativo sempre que você iniciar o 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

Configuramos com sucesso um aplicativo Koa.js e aprendemos como revertê-lo como proxy, além de gerenciá-lo com o systemd. Agora você está pronto para expandir seu aplicativo e aproveitar esse exemplo. Se você quiser saber mais sobre o Koa.js e mais coisas com as quais você pode fazer, visite o site deles , para obter informações mais úteis. Além disso, se você quiser saber mais sobre o gerenciador de processos do systemd, leia a documentação aqui . Por fim, se você quiser saber mais sobre o proxy reverso do Apache, fique à vontade para vê-los aqui .