Argumentos de Línea de Comandos

Gigantics puede configurarse usando argumentos de línea de comandos al iniciar el servidor. Estos argumentos proporcionan una forma de anular la configuración del archivo de configuración o especificar opciones en tiempo de ejecución.

Uso Básico

./gig start [opciones]

Argumentos Disponibles

Archivo de Configuración

• --config o -c - Especificar la ruta del archivo de configuración
  • Predeterminado: ./config/default.yaml
  • Ejemplo: ./gig start -c ./config/production.yaml

Modo Daemon

• --daemon o -d - Ejecutar el servidor como un proceso daemon en segundo plano
  • Predeterminado: false
  • Ejemplo: ./gig start -d

Identificador de Proceso

• --name o -n - Establecer el nombre del identificador del proceso principal
  • Ejemplo: ./gig start -n "gigantics-producción"

Anulaciones de Configuración del Servidor

• --hostname - Anular el hostname del servidor
  • Ejemplo: ./gig start --hostname=0.0.0.0
• --baseUrl - Anular la URL base del servidor
  • Ejemplo: ./gig start --baseUrl=https://gigantics.empresa.com
• --port - Anular el puerto del servidor
  • Ejemplo: ./gig start --port=8080

Anulaciones de Configuración de Base de Datos

• --db-host - Anular el host de la base de datos
  • Ejemplo: ./gig start --db-host=mongodb.empresa.com
• --db-port - Anular el puerto de la base de datos
  • Ejemplo: ./gig start --db-port=27018
• --db - Anular el nombre de la base de datos
  • Ejemplo: ./gig start --db=gigantics_prod

Anulación de Registro

• --logLevel - Anular el nivel de registro
  • Opciones: error, warn, info, http, verbose, debug, silly
  • Ejemplo: ./gig start --logLevel=debug

Configuración de Worker

• --web o -w - Iniciar web workers (procesos worker de Node.js)
  • Valores:
    • -1 - Ejecutar todo en el proceso principal (sin bifurcado)
    • 0 - Bifurcar a todas las CPUs disponibles
    • N - Bifurcar exactamente a N procesos worker
  • Ejemplo: ./gig start -w=4
• --job o -j - Iniciar job workers
  • Ejemplo: ./gig start -j=3

Los parámetros -w y -j controlan si Gigantics usa procesos worker de Node.js para mejor utilización de CPU, no agrupamiento de bases de datos.

Ejemplos

Inicio de Producción con Modo Daemon

./gig start -c config/production.yaml -d

Inicio de Desarrollo con Registro de Depuración

./gig start -c config/development.yaml --logLevel=debug

Puerto y Host Personalizados

./gig start --hostname=0.0.0.0 --port=8080

Modo Cluster

./gig start -w=0  # Usar todas las CPUs disponibles
./gig start -w=4  # Usar 4 workers

Anulación de Base de Datos

./gig start --db-host=mongodb-prod.empresa.com --db=gigantics_production

Argumentos Combinados

./gig start -c config/production.yaml -d -w=0 --hostname=0.0.0.0 --port=80

Prioridad de Argumentos

Los argumentos de línea de comandos anulan la configuración del archivo de configuración en este orden:

1. Valores predeterminados en el código
2. Configuración del archivo de configuración
3. Variables de entorno (cuando aplican)
4. Argumentos de línea de comandos

Uso en Windows

En Windows, usa la extensión .exe:

gig.exe start [opciones]

Mejores Prácticas

1. Archivos de Configuración: Usa archivos de configuración para ajustes persistentes y argumentos de línea de comandos para anulaciones temporales
2. Producción: Siempre especifica un archivo de configuración en entornos de producción
3. Seguridad: Ten cuidado con los niveles de registro en producción ya que el registro detallado puede exponer información sensible
4. Documentación: Documenta todos los argumentos de línea de comandos usados en tus procedimientos de despliegue
5. Pruebas: Prueba los argumentos de línea de comandos en desarrollo antes de usarlos en producción

Patrones Comunes de Despliegue

Desarrollo

./gig start -c config/development.yaml --logLevel=silly

Staging

./gig start -c config/staging.yaml -d --logLevel=info

Producción

./gig start -c config/production.yaml -d -w=0 --logLevel=http

Estos argumentos de línea de comandos proporcionan flexibilidad en cómo despliegas y ejecutas Gigantics, permitiéndote anular configuraciones específicas sin modificar los archivos de configuración.

Documentación de Comandos Individuales

Para obtener información detallada sobre cada comando disponible en Gigantics, consulta la documentación de comandos individuales:

• Comando Start - Iniciar el servidor Gigantics
• Comando Stop - Detener servicios Gigantics
• Gestión de Usuarios - Gestionar cuentas de usuario
• Estado de Procesos - Listar servicios en ejecución
• Debaser - Motor CLI Debaser
• Migración - Comando de migración de base de datos
• Restart - Reiniciar servidor Gigantics
• Version - Imprimir versión de Gigantics