Integración con NGINX

NGINX es un potente servidor web que garantiza alto rendimiento y versatilidad.

Con la integración de NGINX podemos beneficiarnos de las técnicas que ofrece para resolver cuestiones de balanceo, proxy inverso, caché, seguridad, entre otras.

Instalar NGINX

Para instalar NGINX es muy sencillo; en cualquier distribución Linux debería estar disponible en sus paquetes.

En distribuciones Ubuntu o Debian:

apt install nginx

En distribuciones CentOS, Fedora o RedHat:

yum install nginx

En MacOS X está disponible en brew y en macports.

Para Windows, puede descargar el instalador en: http://nginx.org/en/download.html

Configuración

Para este ejemplo, vamos a asumir que ya tiene Netuno instalado y en ejecución en /srv/netuno.

Para configurar un nuevo sitio en NGINX, navegue hasta la carpeta de configuración:

• En las distribuciones Linux suele estar en: /etc/nginx
• MacOS X con brew: /usr/local/etc/nginx

Cree un nuevo archivo de configuración para el nuevo sitio en sites-available/netuno.

Y el contenido de este archivo será:

server {
    listen 127.0.0.1:80;
    server_name app.tu-dominio.com;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host nombre-de-tu-app-netuno.local.netu.no;
    }
    location /netuno {
        root /srv/netuno/core/web;
    }

    location /public {
        root /srv/netuno/apps/nombre-de-tu-app-netuno;
    }
}

Puede cambiar la línea donde dice listen 127.0.0.1:80 por su IP externa y el puerto correspondiente.

Y donde está nombre-de-tu-app-netuno deberá ser el nombre de tu app, como por ejemplo miapp.

Si el nombre de la aplicación contiene _, como mi_app, es porque Netuno no permite el - en el nombre de las aplicaciones. Entonces, como en las direcciones de dominio no se admite el _, debe sustituirlo por -, que Netuno convierte automáticamente en _ y encuentra la app correspondiente.

El .local.netu.no es un atajo para localhost; como alternativa se puede utilizar .localhost.

Esto se debe a que Netuno busca automáticamente una app con el nombre correspondiente al subdominio; por eso es muy importante indicar en el prefijo del Host que llega a Netuno el nombre de la aplicación.

En este ejemplo estamos asumiendo que Netuno se está ejecutando en el puerto 9000 y en la ruta /src/netuno; valide esta información y ajústela si es necesario.

El contenido web público de Netuno está en la carpeta core/web, pero no todo debe exponerse, solo la carpeta netuno.

Por lo tanto, las únicas carpetas que se exponen directamente son la carpeta core/web/netuno y la carpeta public de la aplicación correspondiente.

Activar la configuración del nuevo sitio

Ahora es necesario crear un enlace simbólico para nuestro nuevo archivo de configuración para activar nuestro nuevo sitio.

Esto se debe a que la metodología de configuración de sitios de NGINX en Linux se basa en contener los archivos de configuración dentro de la carpeta sites-available, pero lo que está activo queda definido en la carpeta sites-enabled.

Así, la creación del enlace simbólico es importante para evitar la duplicación de archivos y garantizar que cualquier cambio se realice en un único archivo.

En Linux, el enlace simbólico se crea de esta forma:

ln -s /etc/nginx/sites-available/netuno /etc/nginx/sites-enabled/netuno

Recarga de la configuración de NGINX

Recuerde que, para que esta configuración surta efecto, es necesario recargar la configuración de NGINX.

Recarga:

nginx -s reload

O reinicie:

killall nginx
nginx

O de la forma más elegante:

service nginx restart

O incluso detenga por completo el servidor y vuelva a iniciarlo:

service nginx stop
service nginx start

Puede verificar el estado de NGINX con el comando:

service nginx status

Los archivos de logs de NGINX se encuentran en la carpeta /var/log/nginx.

Dirección local ficticia

Netuno resuelve cuál es la aplicación que procesa la petición (request) basándose en el prefijo de la dirección que viene en el Host de la cabecera HTTP, y el prefijo debe contener el nombre exacto de la aplicación Netuno.

Entonces es posible utilizar una dirección ficticia solo para indicar a Netuno que debe utilizar la aplicación correcta.

Tenemos mi-app.local.netu.no, que siempre resuelve a la IP local.

La aplicación en Netuno debe ser mi_app, porque Netuno no permite el - en el nombre de las aplicaciones, y como el dominio no admite _, entonces se sustituye por -, que Netuno convierte automáticamente en _.

Como alternativa, se puede crear una dirección local, como por ejemplo mi-app.localhost; en este caso es necesario registrar esta dirección como host local, deberá forzar la resolución de la dirección en su archivo de hosts; en el caso de Linux, edite el archivo:

/etc/hosts

Y añada la línea:

127.0.0.1 mi-app.localhost

Ahora esta dirección local se puede utilizar en NGINX.

Si está en un entorno de desarrollo local, basta con comprobar en su navegador a través de la dirección:

• A través de NGINX:

http://mi-app.localhost

• Directamente a Netuno:

http://mi-app.localhost:9000

Si está en un servidor o contenedor a través de terminal, utilice el comando cURL, por ejemplo:

• A través de NGINX:

curl -v http://mi-app.localhost:9000

• Directamente a Netuno:

curl -v http://mi-app.localhost:9000

Asegúrese siempre de que donde nos referimos a mi-app deberá ser el nombre de su aplicación.

En un entorno de desarrollo local, si hay alguna corrección, principalmente del archivo hosts del sistema operativo, puede ser necesario reiniciar el navegador debido a la caché de resolución de DNS.

Si es necesario corregir alguna configuración en NGINX, no olvide recargar siempre la configuración.