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 site
qualquer 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 init
e 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.js
arquivo.
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.js
e você verá Website is live
no 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 3000
como porta para nosso ProxyPass
e ProxyPassReverse
IP. 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 youruser
pelo 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 .