Cómo configurar una aplicación de nodo Koa.js en Ubuntu 16.04 LTS

• Breve descripción de Node.js, Koa.js y Apache
• Configurando Node.js
• Configurar nuestro directorio de aplicaciones
• Instalando Koa.js
• Instalando Apache
• Administrando nuestra aplicación con systemd
• Conclusión

En este tutorial, aprenderemos cómo configurar una aplicación web Koa.js para producción, utilizando Node.js. También vincularemos un dominio de muestra, con un proxy inverso, usando Apache, y aprenderemos cómo administrarlo con un administrador de procesos adecuado. Sin más preámbulos, comencemos.

Breve descripción de Node.js, Koa.js y Apache

Node.js es un marco JavaScript multiplataforma rápido basado en el motor V8 de Chrome. Se utiliza tanto en aplicaciones de escritorio como de servidor y es famoso por su manejo de bucles de eventos de subproceso único. Node.js presenta un registro de paquetes llamado Node Package Manager (NPM), que alberga más de medio millón de paquetes. Los paquetes (o módulos) de NPM son la columna vertebral central de Node.js, ya que son códigos impulsados ​​por la comunidad que pueden ser útiles en su aplicación Node.js. En nuestra aplicación Koa.js, Node.js es la parte central de su función.

Koa.js es un marco web minimalista, construido sobre la plataforma Node.js. Hecho por el mismo equipo detrás del popular framework Express.js, su objetivo es minimizar aún más el ya minimalista framework Express.js al excluir el middleware de su núcleo. Una característica importante de Koa.js es el hecho de que no hay devoluciones de llamada. Koa.js se basa en generadores basados ​​en ES6 y características de ES6, como Promises.

Apache es un popular servidor web de código abierto, utilizado como un punto de partida muy básico para los servidores web. En este tutorial, utilizaremos Apache como proxy inverso, lo que nos permitirá vincular nuestra aplicación a un dominio de muestra. Si no tiene un dominio, este tutorial seguirá funcionando para usted, con la única diferencia de que el sitio web se ejecutará en su IP VPS, en lugar de un dominio.

Configurando Node.js

Al igual que con cualquier framework Node.js, necesitará instalar Node.js en su VPS. Por el bien de este tutorial, supondré que ya tiene Node.js instalado en su sistema. Si no, simplemente puede seguir las instrucciones aquí .

Configurar nuestro directorio de aplicaciones

Tendremos que crear una carpeta que contendrá los archivos principales de nuestra aplicación.

mkdir site

Siéntase libre de reemplazar sitecon cualquier otro nombre que desee para el directorio. A continuación, necesitaremos inicializar nuestro archivo de paquete Node.js. Cambie al directorio que acaba de crear, y ejecute npm init, y complete las indicaciones. Al final, debería verse así:

{
  "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 Koa.js

Ahora que tenemos nuestro directorio configurado, podemos proceder a instalar Koa.js. En el directorio de trabajo actual /site, escriba lo siguiente.

npm install koa

Esto descargará el módulo Koa.js de NPM y lo instalará en nuestro directorio de proyectos para uso futuro. A continuación, crearemos nuestro archivo de aplicación de muestra que contendrá nuestro código de aplicación. Para hacerlo, crea un index.jsarchivo.

nano index.js

Una vez dentro del archivo, cree una aplicación de muestra.

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

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

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

Guarde y cierre el archivo. CTRL+ X.

Queremos asegurarnos de que nuestra aplicación se ejecute correctamente. Para iniciarlo, ejecute node index.jsy verá Website is liveen la consola.

Instalando Apache

Ahora que sabemos que nuestro sitio web es funcional, podemos proceder a instalar Apache y sus dependencias.

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

Para utilizar la función de proxy inverso que se encuentra en Apache, necesitaremos habilitar los módulos necesarios.

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

Es posible que algunos de estos módulos ya estén habilitados, pero siempre es bueno verificarlos dos veces.

Ahora necesitamos editar el archivo de configuración predeterminado para Apache.

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

Aquí, tendremos que agregar un bloque para nuestra aplicación.

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

    ServerName localhost
</VirtualHost>

Guarde el archivo, CTRL+ X.

Puede notar que estamos utilizando el puerto 3000como puerto para nuestro ProxyPasse ProxyPassReverseIP. Dado que es el mismo puerto en el que estamos ejecutando nuestra aplicación Koa.js, es imprescindible que ingresemos el puerto correcto.

Una vez que los cambios estén en su lugar, necesitaremos reiniciar Apache y reiniciar nuestra aplicación Koa.js.

sudo systemctl restart apache2

Esto asegurará que nuestro archivo de configuración esté activo y listo para funcionar cuando iniciemos nuestra aplicación Koa.js. Una vez que se reinicia Apache, navegue de regreso al directorio de su sitio e inicie la aplicación Koa.js como lo hicimos anteriormente. Desde su navegador web, navegue hasta http://yourdomain, o http://yourip:, y verá "Hello World".

Administrando nuestra aplicación con systemd

Ahora que hemos cubierto los conceptos básicos de la creación de una aplicación Koa.js de muestra, nos damos cuenta de que en un entorno de producción, iniciar la aplicación tal como estamos ahora no es práctico. Un administrador de procesos es definitivamente un requisito. Ahí es donde entra en juego systemd. En términos simples, systemd consiste en un software que proporciona bloques de construcción para un sistema Linux. Similar a "init", proporciona un sistema para administrar los procesos del usuario después del inicio del sistema. En el caso de nuestra aplicación, systemd nos permite iniciar automáticamente nuestro sitio web después de reiniciar el sistema, en caso de que ocurra un evento que interrumpa el tiempo de actividad del sistema. También proporciona un conjunto de herramientas que pueden ser útiles al administrar nuestra aplicación. La mejor parte es el hecho de que está integrado en Ubuntu 16.04 LTS, por lo que no necesitamos instalar ningún software adicional.

Crear servicio systemd

Todo lo que necesitemos para iniciar nuestra aplicación estará contenido en un archivo llamado service. Contiene detalles sobre nuestra aplicación, como su nombre, directorio, entorno y más. Para crear nuestro archivo de sistema, abra un editor de texto.

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

Edite y guarde el archivo así.

[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

Reemplace yourusercon el nombre de usuario de su servidor. Aquí hay un resumen rápido de los campos importantes:

• After - Esto informa a systemd que espere hasta que la interfaz de red esté lista antes de iniciar nuestra aplicación.
• Environment- Aquí podemos especificar variables de entorno para nuestra aplicación. Nuestro puerto Node.js es uno de ellos.
• Type - Esto informa a systemd que nuestra aplicación solo puede iniciarse, sin perder los privilegios del usuario y demás.
• User- Esto le dice a systemd que queremos ejecutar la aplicación con nuestra cuenta de usuario, lo cual es recomendable. La ejecución de aplicaciones como usuario root puede generar muchos compromisos de seguridad.
• ExecStart - Esencialmente, el comando que systemd ejecutará para iniciar nuestra aplicación, de forma similar a cómo lo comenzamos manualmente antes.
• Restart- Indica a systemd en qué condiciones reiniciar nuestra aplicación. En este caso, queremos reiniciar nuestro sitio web en caso de error.

Inicie el servicio systemd

Ahora estamos listos para comenzar nuestro servicio systemd.

sudo systemctl daemon-reload

Esto es necesario cuando un archivo de servicio systemd cambia para que systemd registre cualquier cambio nuevo realizado.

Luego, inicie su aplicación.

sudo systemctl start site

Vaya al sitio en su navegador una vez más, para verificar que todo esté funcionando.

Funciones clave de gestión del sistema

• stop - Detiene la aplicación por completo.
• restart - Detiene la aplicación y la vuelve a iniciar con un nuevo proceso.
• enable - Le dice a systemd que inicie la aplicación cada vez que inicie su computadora.
• status - Muestra información sobre la aplicación actualmente en ejecución, como el tiempo de actividad, el estado de la aplicación y más.

Para usar cualquiera de estas funciones, ejecute lo siguiente.

systemctl <function> site

Conclusión

Hemos configurado con éxito una aplicación Koa.js y hemos aprendido a revertir el proxy, así como a administrarlo con systemd. Ahora está listo para expandir su aplicación y construir sobre este ejemplo. Si desea obtener más información sobre Koa.js y más cosas que puede hacer, visite su sitio web para obtener más información útil. Además de eso, si desea obtener más información sobre el administrador de procesos de systemd, lea la documentación aquí . Finalmente, si desea obtener más información sobre el proxy inverso de Apache, no dude en consultarlos aquí .