Esta guía explica cómo ajustar la configuración de un sitio Node.js alojado en la infraestructura de Infomaniak para adaptar el comportamiento de su aplicación según su evolución, sus dependencias o sus preferencias técnicas.

Requisitos previos

• Instalar un sitio Node.js en su alojamiento.
• Pruebe sus modificaciones localmente antes de aplicarlas en producción.
• Verifique que sus scripts (start, build) estén bien definidos en su archivo package.json.
• Si modifica la estructura de su proyecto, recuerde ajustar la carpeta de ejecución y los comandos asociados.
• El puerto de escucha definido en el Manager debe corresponder exactamente al utilizado en el código de la aplicación.

Acceder a la configuración

Cada sitio dispone de un panel de control dedicado para controlar la aplicación (iniciar, detener, reiniciar), consultar la consola de ejecución, gestionar las versiones de Node.js, configurar los dominios y activar los certificados SSL:

1. Haga clic aquí para acceder a la gestión de su sitio en el Manager de Infomaniak (¿necesita ayuda?).
2. Haga clic directamente en el nombre asignado al sitio en cuestión.
3. Puede abrir la consola, detener el proyecto (se aplicará una página de mantenimiento) o reiniciarlo.
4. Haga clic en Gestionar bajo Configuración avanzada:
   
5. Haga clic en la pestaña Node.js para acceder a los ajustes:
   

Aplicar los cambios

Para ello:

1. Guarde los cambios desde la interfaz del Manager.
2. Reinicia tu aplicación para que los cambios surtan efecto.

Consulta esta otra guía en caso de problemas.

Comandos principales

Carpeta de ejecución

La carpeta de ejecución indica la ubicación en el servidor donde se ejecutarán los comandos de construcción y lanzamiento. Debe apuntar al directorio raíz de tu aplicación, es decir, donde se encuentra tu archivo package.json.

Por ejemplo, puedes especificar para la raíz del proyecto:

./

o si tu aplicación está en una subcarpeta llamada app:

./app

o si se encuentra en una carpeta backend:

./backend

Comando de construcción (opcional)

Si tu aplicación Node.js requiere un paso de compilación antes de ejecutarse, proporciona un comando de construcción en el campo correspondiente. Este comando se ejecutará automáticamente antes de iniciar la aplicación.

Por ejemplo, puedes indicar:

npm install && npm run build

o, si usas yarn :

yarn install && yarn build

Si tu proyecto no requiere compilación, este campo puede dejarse vacío.

Comando de lanzamiento

El comando de lanzamiento corresponde a la instrucción utilizada para iniciar tu aplicación. Debe ser idéntico al que usas localmente para ejecutar el proyecto.

Por ejemplo, puedes indicar:

node index.js

npm start

o

yarn start

Este comando debe permitir iniciar directamente el servidor o el punto de entrada de tu aplicación tal como está definido en tu entorno de desarrollo.

Puerto de escucha

Tu aplicación debe escuchar en un puerto específico que se define en el Manager. Este puerto se transmite a tu aplicación a través de una variable de entorno PORT.
Ejemplo en tu código Node.js:

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Application lancée sur le port ${port}`);
});

Asegúrate de que este puerto se tenga en cuenta en tu código.

Versión de Node.js

Puede seleccionar la versión de Node.js que su sitio debe utilizar. Se recomienda usar una versión estable y siempre soportada para garantizar la seguridad y la compatibilidad de su aplicación.