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 según 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.
• Verifique que sus scripts (start, build) estén bien definidos en su archivo package.json.
• Si modifica la estructura de su proyecto, piense en ajustar la carpeta de ejecución y los comandos asociados.
• Importante: El puerto de escucha definido en el Manager debe corresponder imperativamente al utilizado en el código de la aplicación.

Acceder a la configuración

Cada sitio dispone de un tablero de control dedicado para controlar la aplicación (iniciar, detener, reiniciar), 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 bajo Configuración avanzada:
   
4. Haga clic en la pestaña Node.js para acceder a los ajustes:
   

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 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. Este es el método recomendado para desplegar 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 un build) y seguir el 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 quedarse vacío.

Comando de inicio

Esta instrucción inicia su servidor. Debe ser idéntica a la utilizada 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 deseada de Node.js 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 guardados sus cambios 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 build) se tengan en cuenta.

En caso de dificultad al inicio, puede consultar la consola de ejecución o referirse a esta otra guía para la solución de problemas.