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

Requisitos previos

• Instalar un sitio Node.js en su alojamiento.
• Probar sus modificaciones localmente antes de aplicarlas en producción.
• Verificar que sus scripts (start, build) estén bien definidos en su archivo package.json.
• Si modifica la estructura de su proyecto, tenga en cuenta que debe ajustar la carpeta de ejecución y los comandos asociados.
• Importante: el puerto de escucha definido en el Manager debe coincidir obligatoriamente con el que se utiliza 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 (start, stop, restart), consultar los registros de ejecución, gestionar las versiones de Node.js 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. Haga clic en Gestionar los parámetros avanzados:
   
4. Haga clic en la pestaña Node.js para acceder a la configuración:
   

Comandos y automatización

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 (build) y de lanzamiento. Debe apuntar al directorio raíz de su aplicación, donde se encuentra su archivo package.json.

./          // Root directory
./app       // Subfolder named app
./backend   // Subfolder named backend

Comando de construcción (Build)

Si su aplicación requiere un paso de preparación (instalación de dependencias, compilación de TypeScript, minificación), indique aquí el comando a ejecutar. Esta es la método recomendado para implementar sus actualizaciones.

A diferencia de una ejecución manual en SSH, esta interfaz utiliza un entorno con rendimiento mejorado para garantizar una construcción rápida sin afectar los recursos de su sitio en producción. Puede encadenar varias tareas (como un git pull seguido de una construcción) y realizar un seguimiento del progreso y los registros del proceso en tiempo real directamente desde el Manager.

# Example: install dependencies and build
npm install && npm run build

# Example: update code and build with yarn
git pull && yarn install && yarn build

Nota: Si su proyecto ya está compilado o no requiere ningún paso intermedio, este campo puede permanecer vacío.

Comando de lanzamiento

Esta instrucción inicia su servidor. Debe ser idéntica a la que se utiliza en su entorno de desarrollo local para iniciar el punto de entrada de la aplicación.

# Option 1: Direct file launch
node index.js

# Option 2: Using npm script
npm start

# Option 3: Using yarn script
yarn start

Puerto de escucha

Su aplicación debe escuchar obligatoriamente en el puerto dinámico asignado por el Manager. Este puerto se transmite a su código a través de la variable de entorno PORT.

// Use the port provided by the environment
const port = process.env.PORT || 8080;

app.listen(port, () => {
  console.log(`Application started on port ${port}`);
});

Versión de Node.js

Puede seleccionar la versión de Node.js deseada en la configuración. Se recomienda priorizar una versión estable (LTS) para garantizar la seguridad y la sostenibilidad de su proyecto.

Aplicar y validar los cambios

Una vez que haya guardado sus modificaciones en el Manager, debe reiniciar su aplicación desde el panel de control para que los nuevos parámetros (nueva versión de Node, nuevo puerto o nuevo comando de construcción) se tengan en cuenta.

En caso de dificultades al iniciar, puede consultar la consola de ejecución o consultar esta otra guía para solucionar problemas.