Configuración del Entorno

Configura los ajustes de entorno para tu instancia de Gigantics. Estos ajustes controlan cómo se comporta la aplicación basándose en el entorno de despliegue.

Variable de Entorno

La configuración principal del entorno se controla mediante la variable de entorno NODE_ENV:

# Esto típicamente no se establece en el archivo YAML sino que se controla por entorno
# NODE_ENV puede ser 'development', 'production', o 'test'

Detección de Entorno

La aplicación detecta automáticamente el entorno y ajusta el comportamiento en consecuencia:

• Desarrollo: Registro mejorado, funciones de depuración habilitadas
• Producción: Rendimiento optimizado, registro mínimo
• Prueba: Configuraciones especiales de prueba, salida mínima

Estableciendo el Entorno

Usando Variables de Entorno

# Establecer entorno a producción
export NODE_ENV=production
./gig start
 
# Establecer entorno a desarrollo
export NODE_ENV=development
./gig start
 
# Establecer entorno a prueba
export NODE_ENV=test
./gig start

Usando Línea de Comandos

# Iniciar en modo desarrollo
NODE_ENV=development ./gig start
 
# Iniciar en modo producción
NODE_ENV=production ./gig start
 
# Iniciar en modo prueba
NODE_ENV=test ./gig start

Línea de Comandos en Windows

# Establecer variable de entorno en Windows
set NODE_ENV=production
gig.exe start
 
# O establecerla solo para un comando
set NODE_ENV=production && gig.exe start

Comportamientos Específicos por Entorno

Entorno de Desarrollo

• Clave de encriptación predeterminada: 'my-secret-key'
• Nivel de registro: 'silly'
• Salida de depuración mejorada
• Credenciales SMTP de desarrollo

Entorno de Producción

• Genera clave de encriptación aleatoria segura
• Nivel de registro: 'http'
• Configuraciones de rendimiento optimizadas
• Requiere configuración SMTP adecuada

Entorno de Prueba

• Configuraciones especiales de prueba
• Nivel de registro: 'test'
• Configuraciones de prueba aisladas

Mejores Prácticas

1. Siempre Establecer el Entorno: Establece explícitamente NODE_ENV en producción
2. Consistencia del Entorno: Asegura que todos los componentes de la aplicación se ejecuten en el mismo entorno
3. Configuración por Entorno: Usa diferentes archivos de configuración para distintos entornos
4. Seguridad: Nunca uses configuraciones de desarrollo en producción

Probando la Configuración del Entorno

Para verificar la configuración del entorno:

1. Comprobar el entorno actual:

   echo $NODE_ENV

2. Iniciar la aplicación con un entorno específico:

   NODE_ENV=development ./gig start

3. Revisar los registros para verificar que se aplican los ajustes específicos del entorno

Usando Múltiples Archivos de Configuración

Puedes crear archivos de configuración específicos para cada entorno:

• config/default.yaml - Configuración base
• config/development.yaml - Sobrescrituras para desarrollo
• config/production.yaml - Sobrescrituras para producción
• config/test.yaml - Sobrescrituras para pruebas

Iniciar con archivos de configuración específicos:

# Usar configuración de desarrollo
./gig start -c config/development.yaml
 
# Usar configuración de producción
./gig start -c config/production.yaml