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 tu alojamiento.
• Probar sus modificaciones en local antes de aplicarlas en producción.
• Verificar que sus scripts (start, build) estén bien definidos en su archivo package.json.
• Si modificas la estructura de tu proyecto, recuerda ajustar la carpeta de ejecución y los comandos asociados.
• El puerto de escucha definido en el Manager debe coincidir exactamente con el utilizado en el código de la aplicación.

Acceder a la configuración

Cada sitio tiene un panel de control dedicado para gestionar 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 producto en el Manager Infomaniak (¿Necesita ayuda?).
2. Haga clic directamente en el nombre asignado al producto correspondiente.
3. Puede abrir la consola, detener el proyecto (se aplicará una página de mantenimiento) o reiniciarlo.
4. Para acceder a los parámetros avanzados, 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.

Consulte este otro guía en caso de problema.

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 su aplicación, es decir, donde se encuentra su archivo package.json.

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

./

o si su aplicación está en un subdirectorio llamado app:

./app

o si se encuentra en una carpeta backend:

./backend

Comando de construcción (opcional)

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

Por ejemplo, puede indicar:

npm install && npm run build

o, si usas yarn :

yarn install && yarn build

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

Comando de inicio

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

Por ejemplo, puede indicar:

node index.js

npm start

o

yarn start

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

Puerto de escucha

Su aplicación debe escuchar en un puerto específico que se define en el Manager. Este puerto se transmite a su aplicación a través de una variable de entorno PORT.
Ejemplo en su 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.